Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Zugriff auf API-Organisationen beschränken

Lege fest, auf welche API-Organisationen Personen aus deinem Netzwerk zugreifen können.

Du kannst den Zugriff aus deinem Netzwerk auf bestimmte API-Organisationen beschränken. Lege dazu über deinen Proxy oder deinen SASE-Dienst (Secure Access Service Edge) eine Liste zulässiger Organisations-IDs fest.

Funktionsweise

  • Eigener Header für zulässige Organisationen: Füge deiner Netzwerkkonfiguration den HTTP-Header OpenAI-Allowed-Organization-Ids hinzu. Darin gibst du eine oder mehrere Organisations-IDs an (zum Beispiel org-…). Trenne mehrere IDs durch Kommas ohne Leerzeichen.
  • So setzt die API-Plattform die Zugriffsbeschränkung durch:
    • Wenn sich jemand aus deinem Netzwerk bei der API-Plattform anmeldet, liest OpenAI den Header aus. OpenAI prüft, ob die ID der API-Organisation, auf die die Person zugreifen möchte, im Header OpenAI-Allowed-Organization-Ids steht.
    • Fehlt die ID der angeforderten Organisation im Header, lehnt OpenAI die Anfrage automatisch mit dem Statuscode 403 ab und sperrt damit den Zugriff auf diese Organisation. Nur die im Header aufgeführten Organisationen sind erreichbar.

Setup

Schritt 1: Organisations-IDs ermitteln

Kopiere die Organisations-ID jeder Organisation, für die du den Zugriff erlauben möchtest. Du findest die ID in den Organisationseinstellungen der API-Plattform:

  • Melde dich mit deinem Konto bei der API-Plattform an und wechsle zur gewünschten Organisation.
  • Öffne die Organisationseinstellungen und notiere dir die Organisations-ID (Beispiel: org-Tkxfm8owx4zIPaJGNDVrPs6m).

Schritt 2: Header konfigurieren

Konfiguriere den Proxy oder SASE-Dienst deines Netzwerks so, dass er den Header mitsendet.

  • Um mehrere Organisationen zuzulassen, gib die Organisations-IDs durch Kommas getrennt und ohne Leerzeichen ein.
  • Ziel-URL festlegen:
    • Konfiguriere deinen Proxy oder SASE-Dienst so, dass er den Header nur bei Anfragen an https://api.openai.com/* mitsendet.

Schritt 3: Konfiguration überprüfen

Teste nach der Konfiguration des Headers den Zugriff von einem Gerät aus, das mit dem Netzwerk verbunden ist, für das die Regel gilt.

  1. Melde dich bei der API-Plattform mit einem Konto an, das Zugriff auf die beiden folgenden Organisationen hat:
    • eine Organisation, die auf der Liste der zulässigen Organisationen steht,
    • eine Organisation, die nicht auf der Liste steht.
  2. Öffne die Organisation, die auf der Liste steht. Prüfe, ob du auf sie zugreifen kannst.
  3. Versuche, die Organisation zu öffnen, die nicht auf der Liste steht. Prüfe, ob der Zugriff gesperrt ist und die Fehlerantwort den Statuscode 403 hat.
  4. Wenn du mehrere Organisationen zulässt, prüfe, ob du auf jede davon zugreifen kannst.

Wenn die Ergebnisse von deinen Erwartungen abweichen, prüfe, ob die Regel deines Proxys oder SASE-Dienstes für das Testgerät gilt und ob der Header die richtigen Organisations-IDs enthält.

Zugriffsfehler beheben

  • Statuscode 403: Wer versucht, auf eine nicht zugelassene API-Organisation zuzugreifen, erhält eine Fehlerantwort mit dem Statuscode 403. Die Meldung weist darauf hin, dass die Berechtigung für den Zugriff auf diese Organisation fehlt.
  • Statuscode 400: Ist der Wert des Headers fehlerhaft, etwa weil die Organisations-ID ungültig ist, schlagen alle Anfragen mit diesem Header mit dem Statuscode 400 fehl.