Utilisez l’API de conformité pour les workflows de sécurité, de suivi juridique, de gouvernance et d’enquête qui nécessitent des enregistrements vérifiables lors d’un audit. Pour mesurer l’adoption et suivre les tendances, utilisez les données d’analyse plutôt que les enregistrements de conformité.
La documentation de référence de l’API d’administration fait foi pour les conditions d’accès, les événements couverts, les routes, les schémas, les filtres, les règles de conservation et le traitement des requêtes actuellement en vigueur.
Pour connaître les interfaces de conformité disponibles et les modes d’intégration courants, consultez le guide de la plateforme de conformité.
Quand utiliser l’API de conformité
Utilisez l’API de conformité pour les besoins suivants :
- Exporter les enregistrements pris en charge vers un système d’audit ou d’enquête.
- Appliquer les procédures de votre organisation en matière de conservation des données et de préservation en cas de litige.
- Mettre en relation l’activité de Codex avec d’autres données de sécurité ou d’identité.
- Appuyer les enquêtes autorisées en matière de sécurité, de droit ou de gouvernance.
L’API de conformité n’est pas un tableau de bord de productivité. Ne l’utilisez pas pour tirer des conclusions sur la qualité du code ou les performances individuelles. Pour établir des rapports sur l’adoption, utilisez les statistiques de l’espace de travail ou l’API d’analyse.
Premiers pas
- Ouvrez la documentation de référence de l’API d’administration et vérifiez que votre rôle d’administrateur vous donne accès aux ressources de conformité dont vous avez besoin.
- Pour la collecte en continu, utilisez le flux de journaux de conformité qui autorise uniquement l’ajout d’entrées. Consultez la documentation de référence de l’API pour connaître les ressources disponibles et les modes de récupération actuellement pris en charge.
- Téléchargez les fichiers journaux et testez leur ingestion dans un système de gestion des informations et des événements de sécurité (SIEM) ou un lac de données, dans un environnement hors production.
- Planifiez la collecte en continu et appliquez aux enregistrements exportés les règles de votre organisation en matière d’accès, de conservation et de préservation en cas de litige. Ne partez pas du principe que la durée de conservation à la source remplace la politique de conservation de votre organisation.
Une équipe de sécurité peut, par exemple, transmettre en continu des événements de conformité immuables à son SIEM pour ses enquêtes, ou les acheminer vers un workflow approuvé de recherche de preuves électroniques. Pour connaître les routes et les schémas en vigueur, consultez la documentation de référence de l’API plutôt que de copier le contrat d’un point de terminaison depuis ce guide.
Téléchargement des journaux
Téléchargez le script Bash ou le script PowerShell. Les deux scripts parcourent toutes les pages de résultats pour lister et télécharger chaque fichier journal disponible dont l’horodatage est postérieur à celui que vous indiquez. Ils écrivent les données au format JSONL sur la sortie standard et les erreurs sur la sortie d’erreur standard.
Définissez COMPLIANCE_API_KEY sur la valeur de votre clé d’API de conformité Enterprise. Remplacez <workspace_or_org_id> par l’identifiant de votre espace de travail ChatGPT ou votre identifiant d’organisation sur la Plateforme API, et <after> par un horodatage au format ISO 8601 qui précise le fuseau horaire. Cet exemple récupère les fichiers AUTH_LOG par lots de 100.
Sur macOS ou Linux, installez Bash, curl et jq, puis exécutez la commande suivante :
bash ./download_compliance_files.sh "<workspace_or_org_id>" AUTH_LOG 100 "<after>" > output.jsonlLe script pour Windows fonctionne avec PowerShell 5.1 ou une version ultérieure. Examinez le fichier téléchargé. Si Windows le bloque et que la stratégie d’exécution de votre organisation autorise son déblocage, exécutez Unblock-File -Path .\download_compliance_files.ps1. Cet exemple utilise PowerShell 7 pour enregistrer le fichier en UTF-8 sans marque d’ordre des octets :
.\download_compliance_files.ps1 "<workspace_or_org_id>" AUTH_LOG 100 "<after>" |
Set-Content -Encoding utf8NoBOM output.jsonlEnregistrements d’audit pour l’accès à l’ordinateur local avec Work Cloud
L’API de conformité couvre l’accès à l’ordinateur local avec Work Cloud de la même manière que Work Cloud. Les enregistrements correspondent aux types d’événements conversation_message et codex_log. L’exécution locale génère également des événements OpenTelemetry (OTel). Pour les collecter, configurez le point de terminaison d’un collecteur OTel. Collectez ces événements locaux séparément des enregistrements de l’API de conformité. Ces sources ne fournissent pas un historique exhaustif des commandes locales, des opérations sur les fichiers, des captures d’écran, des approbations ou des actions externes.
Lors de la mise en place de la collecte :
-
Utilisez
conversation_messageetcodex_logpour les enregistrements du mode Work pris en charge. Consultez la documentation de référence de l’API pour connaître leurs schémas, leurs identifiants d’action et leurs horodatages. -
Vérifiez comment les enregistrements sont conservés et supprimés dans ce workflow.
-
Exécutez une tâche représentative et comparez les enregistrements exportés aux actions effectuées.
Automatisation des politiques. Utilisez l’API de gestion des politiques pour gérer les paramètres globaux. Gérez les paramètres Local et Codex Cloud dans l’interface de sécurité des agents. Après la migration, vous pouvez continuer à utiliser vos workflows API existants pour les paramètres globaux. Testez vos scripts et vos intégrations Terraform, puis vérifiez que les affectations et l’ordre des politiques n’ont pas changé. Examinez séparément l’automatisation des politiques et la récupération des enregistrements d’audit. La prise en charge de l’API de gestion des politiques ne modifie pas la liste des événements couverts par l’API de conformité.
Audit à l’aide de hooks. Si les hooks MCP sont activés pour votre espace de travail, utilisez ceux que les administrateurs ont définis. Ces hooks s’exécutent sur le coordinateur cloud (orchestrateur) pour les événements de cycle de vie et d’utilisation des outils pris en charge. Avant de remplacer un workflow d’audit existant, testez la connexion de rappel, vérifiez quels événements sont couverts et testez le comportement en cas d’échec. Vérifiez ces enregistrements séparément des événements couverts par l’API de conformité.
Vérification du périmètre d’administration
Le périmètre de conformité dépend de l’espace de travail ChatGPT et des produits couverts par la documentation de référence actuelle de l’API. Les données des organisations de la Plateforme API relèvent des règles de gestion des données et des contrôles d’administration propres à cette API.
La documentation de référence de l’API précise les routes, les événements couverts, les schémas, les filtres, les modalités de conservation, les autorisations requises et le fonctionnement des requêtes en vigueur. Cette page ne reprend pas ces spécifications.