> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI Platform

> Administrative, Konfigurations- und Authentifizierungsaktivitäten in Ihrer OpenAI-API-Platform-Organisation überwachen

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.

> [!NOTE]
>
> 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](https://platform.openai.com/) an
2. Öffnen Sie **Settings** → **Data controls** → **Data retention**
3. Klicken Sie unter **Audit logging** auf **Enable**
4. Speichern Sie Ihre Änderungen

> [!WARNING]
>
> 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](https://platform.openai.com/settings/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

> [!WARNING]
>
> 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.

> [!NOTE]
>
> 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**](https://app.wirespeed.co/settings/integrations?tab=browse)
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.

> [!NOTE]
>
> 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:

| Detektion | Bedingung |
| - | - |
| IP-Allowlist geändert | Eine Allowlist wird erstellt, aktualisiert, gelöscht, aktiviert oder deaktiviert |
| Owner- oder Admin-Rolle zugewiesen | Ein Benutzer oder Dienstkonto erhält erweiterten Zugriff |
| SCIM-Konfiguration geändert | SCIM-Provisioning wird aktiviert oder deaktiviert |
| API-Schlüssel mit erweiterten Rechten | Ein API-Schlüssel wird mit Dashboard-Berechtigung **All** (leere `scopes`) erstellt oder mit einem `.write`- / `:write`- / `admin`-Scope erstellt/aktualisiert |

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:

```bash theme={null}
curl -sS "https://api.openai.com/v1/organization/audit_logs?limit=5" \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY"
```

`"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

* [OpenAI Admin and Audit Logs API](https://help.openai.com/en/articles/9687866-admin-and-audit-logs-api-for-the-api-platform)
* [OpenAI Admin APIs guide](https://developers.openai.com/api/docs/guides/admin-apis)
* [OpenAI Audit Logs API reference](https://developers.openai.com/api/reference/resources/organization/subresources/audit_logs/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.