Zum Hauptinhalt springen
Die OpenAI-Platform-Integration erfasst die Audit-Protokolle der Organisation für die Sicherheitsüberwachung und Detektion. Sie umfasst administrative Änderungen, API-Schlüssel-Aktivitäten, Identitätskonfiguration und Anmeldeversuche, ohne dass Software auf den Geräten der Mitarbeitenden installiert werden muss.
Diese Integration verbindet sich mit der OpenAI API Platform unter platform.openai.com. Sie verwendet keine Zugangsdaten der ChatGPT Enterprise Admin Console und erfasst keine Prompt- oder Antwortinhalte.

​
Voraussetzungen

Stellen Sie vor der Einrichtung dieser Integration sicher, dass:
  1. Sie Organization Owner in der OpenAI API Platform sind
  2. Sie die Datenkontrollen der Organisation ändern können
  3. Sie einen Admin-API-Schlüssel für die API Platform erstellen können

​
Schritt 1: Audit-Protokollierung aktivieren

  1. Melden Sie sich bei der OpenAI Platform an
  2. Öffnen Sie Settings → Data controls → Data retention
  3. Klicken Sie unter Audit logging auf Enable
  4. Speichern Sie Ihre Änderungen
Die Aktivierung der Audit-Protokollierung lässt sich praktisch nicht rückgängig machen. Sie kann in den Organisationseinstellungen nicht deaktiviert werden; ein Organization Owner muss sich an den OpenAI-Support wenden, um eine Änderung zu beantragen.
Die Audit-Protokollierung muss aktiviert sein, bevor OpenAI Audit-Einträge über die API bereitstellt. OpenAI ergänzt keine Aktivitäten rückwirkend aus der Zeit vor der Aktivierung dieser Einstellung. Eine neu aktivierte Organisation kann ein leeres Audit-Protokoll zurückgeben, bis nach der Aktivierung jemand eine administrative Aktion durchführt.

​
Schritt 2: Eingeschränkten Admin-API-Schlüssel erstellen

  1. Öffnen Sie Organization Admin keys
  2. Klicken Sie auf Create new admin key
  3. Geben Sie einen aussagekräftigen Namen ein, zum Beispiel Wirespeed Audit Logs
  4. Wählen Sie unter Permissions die Option Restricted
  5. Setzen Sie Audit Logs Scope auf Read
  6. Lassen Sie nicht benötigte Verwaltungsberechtigungen deaktiviert
  7. Erstellen Sie den Schlüssel und kopieren Sie ihn sofort
OpenAI zeigt den Schlüssel nur einmal an. Wenn er verloren geht, löschen Sie ihn und erstellen Sie einen neuen Schlüssel. Bewahren Sie ihn sicher auf.
Verwenden Sie einen Admin-Schlüssel der API Platform, dessen maskierte Form mit sk-admin... beginnt. Standardmäßige Modell-/Projektschlüssel und Admin-Schlüssel von ChatGPT-Workspaces haben keinen Zugriff auf diesen Endpunkt. Wirespeed benötigt kein Organization Administration Write.

​
Schritt 3: OpenAI Platform mit Wirespeed verbinden

  1. Öffnen Sie in Wirespeed Integrationen → Integration hinzufügen
  2. Suchen Sie nach OpenAI Platform und wählen Sie es aus
  3. Fügen Sie den Admin-API-Schlüssel ein
  4. Klicken Sie auf Integrieren
Wirespeed validiert den Schlüssel am Audit-Logs-Endpunkt der Organisation, bevor die Integration aktiviert wird. Eine erfolgreiche Verbindung belegt nur, dass der Schlüssel diesen Endpunkt aufrufen kann. Sie bedeutet nicht, dass bereits Ereignisse vorhanden sind.

​
Welche Ereignisse werden erfasst?

Wirespeed importiert alle Ereignistypen, die die OpenAI Organization Audit Logs API zurückgibt, darunter:
  • Erfolgreiche und fehlgeschlagene An- und Abmeldungen
  • Änderungen an Benutzern, Einladungen, Gruppen und Dienstkonten
  • Rollen- und Berechtigungszuweisungen
  • Erstellen, Aktualisieren und Löschen von API-Schlüsseln
  • Änderungen an IP-Allowlist und SCIM-Konfiguration
  • Änderungen an Projekten, Organisation und Ratenlimits
  • Änderungen an Workload-Identitäten, Tunneln, Zertifikaten und externen Schlüsseln
Die erste Synchronisierung fordert bis zu sieben Tage verfügbaren Verlauf an. Ereignisse aus der Zeit vor der Aktivierung der Audit-Protokollierung sind nicht verfügbar. OpenAI bewahrt Audit-Protokolle nach dem Best-Effort-Prinzip auf und garantiert keinen festen Aufbewahrungszeitraum.
OpenAI-Audit-Protokolle enthalten administrative Metadaten, keine Inhalte von Modellanfragen oder -antworten. Die Zero-Data-Retention-Einstellungen von OpenAI ändern nichts an der Verfügbarkeit der Audit-Protokolle.

​
Verwaltete Detektionen

Wirespeed wertet die erfassten Ereignisse auf Folgendes aus: Erfolgreiche und fehlgeschlagene Anmeldungen werden zudem als Authentifizierungsereignisse für SIEM-Suchen und plattformübergreifende Anmeldedetektionen normalisiert. Wirespeed erstellt nicht für jede einzelne Anmeldung eine Detektion.

​
Fehlerbehebung

​
Ungültiger API-Schlüssel

Bei 401-Fehlern:
  1. Prüfen Sie, ob der gesamte Schlüssel ohne Leerzeichen eingefügt wurde
  2. Prüfen Sie, ob es sich um einen Admin-Schlüssel der API Platform handelt und nicht um einen standardmäßigen OpenAI-API-Schlüssel
  3. Wenn der Schlüssel gelöscht wurde oder verloren gegangen ist, erstellen Sie einen neuen und aktualisieren Sie Wirespeed

​
Fehlende Berechtigung für Audit-Protokolle

Bei 403- oder Missing-Scope-Fehlern:
  1. Erstellen Sie den Schlüssel als Organization Owner der OpenAI API Platform
  2. Wählen Sie die Berechtigung Restricted
  3. Setzen Sie Audit Logs Scope auf Read
  4. Ersetzen Sie den Schlüssel in Wirespeed

​
Integration verbunden, aber keine Ereignisse sichtbar

Eine fehlerfreie Integration mit nur einem Protokolleintrag „Integration added“ bedeutet in der Regel, dass OpenAI eine leere Liste zurückgegeben hat. Prüfen Sie, ob beim Anbieter Ereignisse vorhanden sind, bevor Sie sie in Wirespeed erwarten:
"data": [] mit "has_more": false bedeutet, dass es für Wirespeed nichts zu erfassen gibt. Anschließend:
  1. Prüfen Sie, ob die Audit-Protokollierung unter Data controls → Data retention den Status Active hat
  2. Erstellen und löschen Sie einen Projekt-API-Schlüssel oder melden Sie sich ab und wieder an
  3. Warten Sie einige Minuten und wiederholen Sie die Anfrage, bis data Ereignisse enthält
  4. Warten Sie eine weitere Minute, bis Wirespeed die Daten abruft
Verwenden Sie den in Wirespeed eingefügten Admin-Schlüssel nicht als Modellschlüssel. Projekt-API-Schlüssel und Aktivitäten in Dashboard-Sitzungen erzeugen die Audit-Einträge.

​
Ratenbegrenzung

OpenAI kann bei hohem Erfassungsvolumen 429-Antworten zurückgeben. Wirespeed wiederholt die Erfassung bei einer späteren Synchronisierung, ohne über das unvollständige Zeitfenster hinauszugehen.

​
Weitere Ressourcen