Überblick

Eine IP-Zulassungsliste ist eine optionale Sicherheitsfunktion, mit der du festlegen kannst, welche IP-Adressen auf deine OpenAI API zugreifen dürfen.

Wenn die Funktion aktiviert ist, werden nur Anfragen von konfigurierten IP-Adressen oder IP-Bereichen zugelassen. Anfragen von allen anderen IP-Adressen werden abgewiesen, auch wenn sie einen gültigen API-Schlüssel enthalten.

Diese Funktion soll dazu beitragen, das Risiko einer unbefugten API-Nutzung zu verringern, indem sie den Zugriff auf vertrauenswürdige Netzwerkumgebungen beschränkt.

Hinweis: IP-Zulassungslisten gelten nur für API-Anfragen. Sie wirken sich weder auf den Zugriff auf platform.openai.com noch auf die Anmeldung aus.

Warum eine IP-Zulassungsliste nutzen?

Eine IP-Zulassungsliste kann dir dabei helfen:

• den API-Zugriff auf bekannte Infrastruktur zu beschränken (zum Beispiel deine Server oder Cloud-Umgebungen)

• das Risiko zu verringern, falls ein API-Schlüssel unbefugt bekannt wird

• zusätzlich zu kontrollieren, woher der API-Datenverkehr stammt

IP-Zulassungslisten werden am häufigsten im Produktivbetrieb eingesetzt, wenn der API-Datenverkehr aus festen oder klar definierten Netzwerkbereichen stammt.

So funktioniert es

Du konfigurierst eine Liste zugelassener IP-Adressen oder CIDR-Bereiche.

• Anfragen von zugelassenen IP-Adressen werden akzeptiert.

• Anfragen von IP-Adressen, die nicht auf der Zulassungsliste stehen, werden abgewiesen.

IP-Zulassungslisten können auf folgenden Ebenen angewendet werden:

• auf Organisationsebene oder

• auf Projektebene

Verfügbarkeit

IP-Zulassungslisten stehen allen zur Verfügung, die die API nutzen.

Befolge die nachstehenden Schritte, um eine IP-Zulassungsliste zu konfigurieren.

IP-Zulassungsliste konfigurieren

Hinweis: Du kannst bis zu 50 IP-Adressen oder CIDR-Bereiche hinzufügen.

1. Öffne die Einstellungen.

2. Wähle Sicherheit aus.

3. Wähle IP-Zulassungsliste aus.

4. Füge eine oder mehrere IP-Adressen oder CIDR-Bereiche hinzu.

5. (Optional) Nutze das Tool Prüfen, um zu prüfen, ob eine IP-Adresse in deiner Zulassungsliste enthalten ist.

6. Aktiviere die Zulassungsliste für:

   • ein bestimmtes Projekt oder

   • deine gesamte Organisation.

7. Teste Anfragen aus den vorgesehenen Umgebungen.

Wir empfehlen, mit einem einzelnen Projekt zu beginnen, bevor du die Zugriffsbeschränkung für die gesamte Organisation aktivierst.

Es kann bis zu 15 Minuten dauern, bis Änderungen wirksam werden.


Hinweis: Du benötigst die entsprechenden Berechtigungen in der Organisation, um die Einstellungen der IP-Zulassungsliste zu konfigurieren.

Fehlerbehebung

Wenn Anfragen unerwartet fehlschlagen:

• Vergewissere dich, dass die Anfrage von einer zugelassenen IP-Adresse stammt.

• Prüfe, ob sich die IP-Adressen deiner Infrastruktur geändert haben.

• Prüfe, ob deine konfigurierten IP-Bereiche korrekt sind.

• Warte bis zu 15 Minuten, bis Konfigurationsänderungen überall wirksam sind.

• Nutze das Tool Prüfen, um zu prüfen, ob eine IP-Adresse zugelassen ist.

Was passiert, wenn eine Anfrage blockiert wird?

Wenn eine Anfrage von einer IP-Adresse stammt, die nicht auf der Zulassungsliste steht, schlägt sie mit folgender Fehlermeldung fehl:

• HTTP-Status: 401 Unauthorized

• Fehlercode: ip_not_authorized

Beispielantwort:

{

 "error": {

   "message": "Your IP is not authorized to access this organization.",

   "type": "ip_not_authorized"

 }

}

Häufig gestellte Fragen

Verhindert eine IP-Zulassungsliste jede unbefugte Nutzung meines API-Schlüssels?

Nein. Eine IP-Zulassungsliste kann das Risiko verringern, indem sie die zulässigen Quellen von API-Anfragen einschränkt. Sie verhindert jedoch nicht jede Form von Missbrauch vollständig. Du solltest sie zusammen mit anderen bewährten Sicherheitsmaßnahmen nutzen, etwa der sicheren Speicherung und regelmäßigen Erneuerung von Schlüsseln sowie einer starken Absicherung deines Kontos. Weitere Sicherheitshinweise findest du in unseren Leitfäden im Hilfecenter zu bewährten Methoden zum Schutz von API-Schlüsseln und zur Vermeidung unbefugter Nutzung.

Wirken sich IP-Zulassungslisten auf die Latenz aus?

IP-Zulassungslisten können in manchen Fällen die Latenz geringfügig erhöhen, üblicherweise bei den ersten Anfragen. Es ist nicht zu erwarten, dass die API-Leistung insgesamt spürbar beeinträchtigt wird.

Woran erkenne ich, ob eine Anfrage aufgrund der IP-Zulassungsliste fehlschlägt?

Anfragen, die aufgrund der IP-Zulassungsliste fehlschlagen, geben Folgendes zurück:

• HTTP status: 401 Unauthorized

• Error code: ip_not_authorized