Nutze die Compliance API, wenn du für Sicherheits-, Rechts- oder Governance-Prozesse oder für Untersuchungen überprüfbare Aufzeichnungen brauchst. Um die Verbreitung der Nutzung zu messen und Trends zu erkennen, verwende Analysedaten statt Compliance-Datensätzen.
Die Referenz zur Admin API ist maßgeblich für die aktuellen Zugriffsvoraussetzungen, die erfassten Ereignisse, Routen, Schemas und Filter sowie für die Datenaufbewahrung und die Verarbeitung von Anfragen.
Einen Überblick über die verfügbaren Compliance-Schnittstellen und gängige Integrationsmuster findest du im Leitfaden zur Compliance-Plattform.
Wann du die Compliance API einsetzen solltest
Die Compliance API eignet sich für folgende Aufgaben:
- Unterstützte Datensätze in ein System für Audits oder Untersuchungen exportieren.
- Die Verfahren deiner Organisation zur Datenaufbewahrung und zur Beweissicherung per Legal Hold anwenden.
- Codex-Aktivitäten mit anderen Sicherheits- oder Identitätsdaten abgleichen.
- Genehmigte Untersuchungen in den Bereichen Sicherheit, Recht oder Governance unterstützen.
Die Compliance API ist kein Produktivitätsdashboard. Ziehe aus ihren Daten keine Rückschlüsse auf die Codequalität oder die Leistung einzelner Personen. Für Berichte zur Verbreitung der Nutzung verwende die Workspace-Analysen oder die Analytics API.
Erste Schritte
- Öffne die Referenz zur Admin API und vergewissere dich, dass deine Admin-Rolle dir Zugriff auf die benötigten Compliance-Ressourcen gewährt.
- Nutze für die laufende Erfassung den Compliance-Protokollstream, in dem neue Einträge ausschließlich angehängt werden. Welche Ressourcen und Abrufverfahren derzeit unterstützt werden, erfährst du in der API-Referenz.
- Lade die Protokolldateien herunter und teste den Import außerhalb des Produktivbetriebs in einem System für Security Information and Event Management (SIEM) oder in einem Data Lake.
- Richte eine kontinuierliche Erfassung ein. Wende auf exportierte Datensätze die Vorgaben deiner Organisation für Zugriff, Aufbewahrung und Legal Holds an. Gehe nicht davon aus, dass die Aufbewahrungsfrist im Quellsystem die Aufbewahrungsrichtlinie deiner Organisation ersetzt.
Ein Sicherheitsteam kann beispielsweise unveränderliche Compliance-Ereignisse für Untersuchungen fortlaufend an sein SIEM übertragen oder sie an einen genehmigten E-Discovery-Prozess weiterleiten. Entnimm die aktuellen Routen und Schemas der API-Referenz, statt die Spezifikation eines Endpunkts aus diesem Leitfaden zu kopieren.
Protokolle herunterladen
Lade das Bash-Skript oder das PowerShell-Skript herunter. Beide Skripte rufen alle Ergebnisseiten ab, listen sämtliche verfügbaren Protokolldateien nach dem angegebenen Zeitstempel auf und laden sie herunter. Sie schreiben JSONL in die Standardausgabe und Fehlermeldungen in die Standardfehlerausgabe.
Setze COMPLIANCE_API_KEY auf deinen Schlüssel für die Enterprise Compliance API. Ersetze <workspace_or_org_id> durch die ID deines ChatGPT-Workspaces oder deine Organisations-ID auf der API-Plattform. Ersetze <after> durch einen ISO-8601-Zeitstempel mit Zeitzone. Das Beispiel ruft jeweils 100 Dateien vom Typ AUTH_LOG ab.
Installiere unter macOS oder Linux Bash, curl und jq. Führe dann diesen Befehl aus:
bash ./download_compliance_files.sh "<workspace_or_org_id>" AUTH_LOG 100 "<after>" > output.jsonl
Das Windows-Skript unterstützt PowerShell ab Version 5.1. Prüfe die heruntergeladene Datei. Wenn Windows sie blockiert und die Ausführungsrichtlinie deiner Organisation die Freigabe erlaubt, führe Unblock-File -Path .\download_compliance_files.ps1 aus. Dieses Beispiel verwendet PowerShell 7, um die Ausgabe in UTF-8 ohne Byte Order Mark zu speichern:
.\download_compliance_files.ps1 "<workspace_or_org_id>" AUTH_LOG 100 "<after>" |
Set-Content -Encoding utf8NoBOM output.jsonl
Audit-Datensätze für den Zugriff auf den lokalen Computer mit Work Cloud
Die Compliance API unterstützt den Zugriff auf den lokalen Computer mit Work Cloud im selben Umfang wie Work Cloud selbst. Die Datensätze erscheinen unter den Ereignistypen conversation_message und codex_log. Bei der lokalen Ausführung entstehen zusätzlich OpenTelemetry-Ereignisse (OTel). Um sie zu erfassen, konfiguriere einen Endpunkt für den OTel-Collector. Erfasse diese lokalen Ereignisse getrennt von den Datensätzen der Compliance API. Auch zusammen liefern diese Quellen keine lückenlose Aufzeichnung aller lokalen Befehle, Dateioperationen, Screenshots, Genehmigungen und externen Aktionen.
So richtest du die Erfassung ein:
-
Verwende
conversation_messageundcodex_logfür die unterstützten Work-Datensätze. Angaben zu Schemas, Aktionskennungen und Zeitstempeln findest du in der API-Referenz. -
Prüfe, wie der jeweilige Workflow Daten aufbewahrt und löscht.
-
Führe eine repräsentative Aufgabe aus und vergleiche die exportierten Datensätze mit den tatsächlich ausgeführten Aktionen.
Richtlinien automatisieren. Verwalte globale Einstellungen über die Richtlinien-API. Die Einstellungen für Lokal und Codex Cloud verwaltest du in der Oberfläche für Agentensicherheit. Bestehende API-Workflows für globale Einstellungen stehen auch nach der Migration zur Verfügung. Teste Skripte und Terraform-Integrationen und vergewissere dich, dass die Zuweisungen und die Reihenfolge der Richtlinien unverändert sind. Prüfe die Richtlinienautomatisierung getrennt vom Abruf der Audit-Datensätze. Die Unterstützung durch die Richtlinien-API hat keinen Einfluss darauf, welche Ereignisse die Compliance API erfasst.
Audits mit Hooks. Wenn MCP-Hooks für deinen Workspace aktiviert sind, verwende die von der Administration definierten Hooks. Sie laufen auf dem Cloud-Koordinator (Orchestrator) und reagieren auf unterstützte Lebenszyklus- und Tool-Ereignisse. Bevor du einen bestehenden Audit-Workflow ersetzt, teste die Callback-Verbindung, die erfassten Ereignisse und das Verhalten bei Fehlern. Prüfe die Aufzeichnungen der Hooks getrennt von den Ereignissen, die die Compliance API abdeckt.
Verwaltungszuständigkeiten prüfen
Welche Daten die Compliance API abdeckt, richtet sich nach dem ChatGPT-Workspace und den Produkten, die in der aktuellen API-Referenz aufgeführt sind. Für Organisationsdaten der API-Plattform gelten eigene Vorgaben für API-Daten und deren Verwaltung.
Maßgeblich ist die API-Referenz. Sie legt fest, welche Routen, Ereignisse, Schemas und Filter die API unterstützt, wie sie Daten aufbewahrt, welche Berechtigungen erforderlich sind und wie Anfragen funktionieren. Diese Seite gibt die Spezifikation nicht erneut wieder.