Documentation ChatGPT
Français
Contact goolvyouyou@gmail.com

Compliance API et événements d’audit

Découvrez le rôle et le périmètre d’administration de la Compliance API

Utilisez la Compliance API pour les processus de sécurité, juridiques, de gouvernance et d’investigation qui nécessitent des enregistrements auditables. Pour mesurer l’adoption et les tendances, utilisez les analyses, et non les enregistrements de conformité.

La référence d’Admin API fait autorité concernant les exigences d’accès, les événements couverts, les routes, les schémas, les filtres, la conservation et le traitement des requêtes actuellement en vigueur.

Pour une présentation des interfaces de conformité disponibles et des modèles d’intégration courants, consultez le guide de la Compliance Platform.

Quand utiliser la Compliance API

La Compliance API convient lorsque vous devez :

  • Exporter les enregistrements pris en charge vers un système d’audit ou d’investigation.
  • Appliquer les processus de conservation et de mise en suspens juridique de l’organisation.
  • Corréler l’activité Codex avec d’autres données de sécurité ou d’identité.
  • Prendre en charge des investigations approuvées en matière de sécurité, de droit ou de gouvernance.

Il ne s’agit pas d’un tableau de bord de productivité. Ne l’utilisez pas pour déduire la qualité du code ou les performances individuelles. Utilisez les Analyses de l’espace de travail ou l’Analytics API pour les rapports d’adoption.

Bien démarrer

  1. Ouvrez la référence d’Admin API et vérifiez que votre rôle d’administrateur vous permet d’accéder aux ressources de conformité dont vous avez besoin.
  2. Utilisez le flux de journaux de conformité en ajout uniquement pour la collecte continue. Consultez la référence d’API pour connaître les ressources et les modes de récupération actuellement pris en charge.
  3. Téléchargez les fichiers journaux et testez leur ingestion dans un système hors production de gestion des informations et des événements de sécurité (SIEM) ou dans un lac de données.
  4. Planifiez une collecte continue et appliquez aux journaux exportés les contrôles d’accès, de conservation et de gel juridique de votre organisation. Ne supposez pas que la période de conservation à la source remplace la politique de conservation de votre organisation.

Par exemple, une équipe de sécurité peut diffuser des événements de conformité immuables vers son SIEM à des fins d’enquête, ou les acheminer vers une procédure approuvée de découverte électronique. Consultez la référence d’API pour connaître les routes et les schémas actuels au lieu de copier un contrat de point de terminaison depuis ce guide.

Télécharger les journaux

Téléchargez le script Bash ou le script PowerShell. Tous deux répertorient et téléchargent chaque fichier journal disponible après un horodatage donné, suivent la pagination et écrivent le JSONL dans la sortie standard. Les erreurs sont envoyées vers la sortie d’erreur standard.

Définissez COMPLIANCE_API_KEY sur votre API key de l’Enterprise Compliance API. Remplacez <workspace_or_org_id> par l’ID de votre espace de travail ChatGPT ou l’ID de votre organisation sur l’API Platform, et <after> par un horodatage ISO 8601 comprenant un fuseau horaire. Cet exemple récupère les fichiers AUTH_LOG, par lots de 100.

Sous macOS ou Linux, installez Bash, curl et jq, puis exécutez :

bash ./download_compliance_files.sh "<workspace_or_org_id>" AUTH_LOG 100 "<after>" > output.jsonl

Le script Windows prend en charge PowerShell 5.1 ou version ultérieure. Examinez le fichier téléchargé. Si Windows le bloque et que la politique d’exécution de votre organisation l’autorise, exécutez Unblock-File -Path .\download_compliance_files.ps1. Cet exemple utilise PowerShell 7 pour enregistrer du texte 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.jsonl

Enregistrements d’audit pour l’accès à l’ordinateur local avec Work Cloud

L’accès à l’ordinateur local avec Work Cloud bénéficie de la même prise en charge par la Compliance API que Work Cloud. Les enregistrements apparaissent sous les types d’événements conversation_message et codex_log. L’exécution locale génère également des événements OpenTelemetry (OTel), que vous pouvez collecter en configurant un point de terminaison de collecteur OTel. Collectez ces événements locaux séparément des enregistrements de la Compliance API. Ces sources ne constituent pas un historique exhaustif de toutes les commandes locales, opérations sur les fichiers, captures d’écran, approbations ou actions externes.

Lors de la configuration de la collecte :

  1. Utilisez conversation_message et codex_log pour les enregistrements Work pris en charge. Consultez la référence de l’API pour connaître leurs schémas, identifiants d’action et horodatages.

  2. Vérifiez le comportement de conservation et de suppression pour le flux de travail.

  3. 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 Global. Gérez les paramètres Local et Codex Cloud dans l’interface Agent Security. Les flux de travail existants utilisant l’API Global restent disponibles après la migration. Testez les scripts et les intégrations Terraform, et vérifiez que les affectations et l’ordre des politiques restent inchangés. Examinez l’automatisation des politiques séparément de la récupération des enregistrements d’audit. La prise en charge de l’API de gestion des politiques ne modifie pas la couverture des événements de la Compliance API.

Audit par hooks. Lorsque cette fonctionnalité est activée pour votre espace de travail, utilisez les hooks MCP définis par l’administrateur qui s’exécutent sur le coordinateur cloud (orchestrateur) pour les événements de cycle de vie et d’outils pris en charge. Avant de remplacer un flux de travail d’audit existant, testez la connexion de rappel, la couverture des événements et le comportement en cas d’échec. Vérifiez ces enregistrements séparément de la couverture de la Compliance API.

Vérifier les périmètres d’administration

La couverture de conformité suit l’espace de travail ChatGPT et les produits représentés dans la référence d’API actuelle. Les données d’organisation de Platform API relèvent de leurs propres contrôles d’administration et de gestion des données d’API.

La référence d’API fait autorité concernant les routes actuelles, les événements couverts, les schémas, les filtres, le fonctionnement de la conservation, les exigences d’autorisation et les mécanismes de requête. Cette page ne reproduit pas ce contrat.

Documentation connexe