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

IP-Freigabeliste

Beschränke den Zugriff auf die OpenAI API auf Anfragen von vertrauenswürdigen IP-Adressen.

Mit einer IP-Freigabeliste kannst du Anfragen an die OpenAI API auf IP-Adressen oder CIDR-Bereiche beschränken, denen du vertraust. Sobald du die Freigabeliste aktivierst, lehnt OpenAI Anfragen von anderen IP-Adressen ab, selbst wenn sie einen gültigen API-Schlüssel enthalten.

Eine IP-Freigabeliste bietet zusätzlichen Schutz für Workloads im Produktivbetrieb, deren ausgehender Netzwerkverkehr über feste oder klar definierte Netzwerkpfade läuft. Sie gilt nur für API-Anfragen. Der Zugriff auf platform.openai.com und die Anmeldung bei einem Konto bleiben möglich.

Mit der IP-Freigabeliste legst du fest, von welchen IP-Adressen deine Anwendungen Anfragen an OpenAI senden dürfen. Wenn du Anfragen von OpenAI-Produkten an deine eigenen Dienste zulassen möchtest, verwende dafür die veröffentlichten IP-Bereiche für ausgehenden Datenverkehr.

Bevor du eine Freigabeliste aktivierst

Ermittle für jeden Workload, der die API aufruft, die öffentliche IP-Adresse oder den Adressbereich für ausgehende Verbindungen. Prüfe, welche Quell-IP-Adresse nach einer etwaigen Netzwerkadressübersetzung (NAT) oder nach dem Durchlaufen eines VPNs, einer Firewall oder eines Proxys bei OpenAI ankommt. Diese Adresse wertet die API aus.

Eine Freigabeliste kann bis zu 50 Einträge enthalten. Jeder Eintrag ist eine einzelne IP-Adresse oder ein CIDR-Bereich. Wer die Eigentümerrolle in der Organisation hat, verfügt über die Berechtigungen Read und Write, die zum Verwalten der Freigabelisteneinstellungen erforderlich sind. Weitere Informationen findest du im Leitfaden Berechtigungen auf der OpenAI-Plattform verwalten.

Teste die Freigabeliste zunächst in einem einzelnen, unkritischen Projekt, bevor du sie für die gesamte Organisation aktivierst. Halte während des Tests einen erprobten Netzwerkpfad bereit, über den du Anfragen von einer zugelassenen IP-Adresse senden kannst.

Freigabelisten auf Projektebene haben Vorrang vor Freigabelisten auf Organisationsebene. Die Einträge beider Listen werden nicht zusammengeführt. Hat ein Projekt eine eigene aktive Freigabeliste, gilt ausschließlich diese Liste. Andernfalls gilt die Freigabeliste der Organisation.

IP-Freigabeliste konfigurieren

  1. Öffne Einstellungen > Sicherheit > IP-Freigabeliste.
  2. Füge die einzelnen IP-Adressen oder CIDR-Bereiche hinzu, die du zulassen möchtest. Verwende zum Beispiel 203.0.113.10 für eine einzelne Adresse oder 203.0.113.0/24 für einen Bereich.
  3. Mit „Prüfen“ kannst du bei Bedarf feststellen, ob die Freigabeliste eine bestimmte IP-Adresse abdeckt.
  4. Aktiviere die Freigabeliste für ein bestimmtes Projekt oder für die gesamte Organisation.
  5. Warte bis zu 15 Minuten, bis die Änderung wirksam wird.
  6. Sende aus jeder Umgebung, die Zugriff haben soll, API-Anfragen, um den Zugriff zu prüfen.

Wenn du eine Freigabeliste auf Organisationsebene aktivierst, wirkt sie sich auf API-Anfragen aller Projekte aus, die keine eigene aktive Freigabeliste haben. Prüfe vor der Aktivierung in jedem betroffenen Geltungsbereich alle ausgehenden Netzwerkpfade für den Produktivbetrieb, für Staging und CI sowie für die Notfallwiederherstellung.

Wirkung der Freigabeliste prüfen

Sende über einen zugelassenen Netzwerkpfad eine typische API-Anfrage. Verwende zum Beispiel folgenden Befehl:

curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

Die Anfrage sollte erfolgreich sein, wenn der API-Schlüssel gültig ist und die erforderlichen Berechtigungen hat. Sendest du die Anfrage von einer IP-Adresse, die die aktive Freigabeliste nicht abdeckt, schlägt sie mit dem HTTP-Statuscode 401 und dem Fehlercode ip_not_authorized fehl.

Fehler bei blockierten Anfragen beheben

Wenn eine erwartete Anfrage mit ip_not_authorized fehlschlägt:

  • Ermittle die öffentliche IP-Adresse des Workloads für ausgehende Verbindungen über denselben Netzwerkpfad, den die API-Anfrage nutzt. Ein lokaler Entwicklungsrechner kann eine andere öffentliche IP-Adresse haben als ein bereitgestellter Dienst.
  • Prüfe, ob sich die IP-Adresse für ausgehende Verbindungen durch ein NAT-Gateway, ein VPN, eine Firewall, einen Proxy oder deinen Cloud-Anbieter geändert hat.
  • Mit „Prüfen“ in den Einstellungen für die IP-Freigabeliste kannst du die Adresse mit den konfigurierten Einträgen abgleichen.
  • Vergewissere dich, dass die aktive Freigabeliste für die Organisation oder das Projekt gilt, der bzw. dem der API-Schlüssel zugeordnet ist.
  • Warte nach einer Konfigurationsänderung bis zu 15 Minuten und teste die Anfrage dann erneut.

Auch mit einer IP-Freigabeliste musst du API-Schlüssel sicher speichern, regelmäßig austauschen und dein Konto schützen. Wenn eine Anfrage aus einem privaten Azure-Netzwerk statt von einer öffentlichen IP-Adresse kommen muss, ziehe Private Link in Betracht. Private Link ist mit IP-Freigabelisten nicht kompatibel.