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-Idshinzu. Darin gibst du eine oder mehrere Organisations-IDs an (zum Beispielorg-…). 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-Idssteht. - Fehlt die ID der angeforderten Organisation im Header, lehnt OpenAI die Anfrage automatisch mit dem Statuscode
403ab und sperrt damit den Zugriff auf diese Organisation. Nur die im Header aufgeführten Organisationen sind erreichbar.
- 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
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.
- Konfiguriere deinen Proxy oder SASE-Dienst so, dass er den Header nur bei Anfragen an
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.
- 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.
- Öffne die Organisation, die auf der Liste steht. Prüfe, ob du auf sie zugreifen kannst.
- Versuche, die Organisation zu öffnen, die nicht auf der Liste steht. Prüfe, ob der Zugriff gesperrt ist und die Fehlerantwort den Statuscode
403hat. - 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
400fehl.