Przegląd

Lista dozwolonych adresów IP to opcjonalna funkcja bezpieczeństwa, która pozwala ograniczyć dostęp do API OpenAI do wybranych adresów IP.

Po jej włączeniu akceptowane są tylko żądania pochodzące ze skonfigurowanych adresów IP lub zakresów adresów IP. Żądania ze wszystkich pozostałych adresów IP są odrzucane, nawet jeśli zawierają prawidłowy klucz API.

Ta funkcja ma pomóc zmniejszyć ryzyko nieuprawnionego korzystania z API przez ograniczenie dostępu do zaufanych środowisk sieciowych.

Uwaga: lista dozwolonych adresów IP dotyczy tylko żądań API. Nie wpływa na dostęp do platform.openai.com ani na logowanie użytkowników.

Dlaczego warto korzystać z listy dozwolonych adresów IP

Lista dozwolonych adresów IP może pomóc Ci:

• Ograniczyć dostęp do API do znanej infrastruktury (na przykład Twoich serwerów lub środowisk chmurowych)

• Zmniejszyć zagrożenie w przypadku wycieku klucza API

• Zyskać dodatkową kontrolę nad tym, skąd pochodzi ruch API

Lista dozwolonych adresów IP jest najczęściej używana w środowiskach produkcyjnych, w których ruch API pochodzi ze stałych lub ściśle określonych zakresów adresów sieciowych.

Jak to działa

Konfigurujesz listę dozwolonych adresów IP lub zakresów CIDR.

• Żądania z dozwolonych adresów IP są akceptowane.

• Żądania z adresów IP spoza listy dozwolonych są odrzucane.

Listę dozwolonych adresów IP można stosować na:

• Poziomie organizacji lub

• Poziomie projektu

Dostępność

Lista dozwolonych adresów IP jest dostępna dla wszystkich klientów korzystających z API.

Aby skonfigurować listę dozwolonych adresów IP, wykonaj poniższe kroki.

Konfiguracja listy dozwolonych adresów IP

Uwaga: możesz dodać maksymalnie 50 adresów IP lub zakresów CIDR.

1. Otwórz Ustawienia.

2. Wybierz Bezpieczeństwo.

3. Wybierz Lista dozwolonych adresów IP.

4. Dodaj co najmniej jeden adres IP lub zakres CIDR.

5. (Opcjonalnie) Użyj narzędzia Sprawdź, aby zweryfikować, czy adres IP znajduje się na liście dozwolonych.

6. Włącz listę dozwolonych adresów IP dla:

   • Wybranego projektu lub

   • Całej organizacji.

7. Przetestuj żądania wysyłane ze środowisk, z których zamierzasz korzystać.

Zalecamy rozpoczęcie od jednego projektu przed włączeniem ograniczeń w całej organizacji.

Wprowadzone zmiany mogą zacząć obowiązywać dopiero po 15 minutach.


Uwaga: aby skonfigurować listę dozwolonych adresów IP, musisz mieć odpowiednie uprawnienia w organizacji.

Rozwiązywanie problemów

Jeśli żądania nieoczekiwanie kończą się błędem:

• Upewnij się, że żądanie pochodzi z dozwolonego adresu IP.

• Sprawdź, czy adresy IP Twojej infrastruktury się nie zmieniły.

• Sprawdź poprawność skonfigurowanych zakresów adresów IP.

• Poczekaj do 15 minut, aż zmiany konfiguracji zaczną obowiązywać.

• Użyj narzędzia Sprawdź, aby zweryfikować, czy dany adres IP jest dozwolony.

Co się dzieje po zablokowaniu żądania

Jeśli żądanie pochodzi z adresu IP spoza listy dozwolonych, zostanie odrzucone i zwróci:

• Status HTTP: 401 Unauthorized

• Kod błędu: ip_not_authorized

Przykładowa odpowiedź:

{

 "error": {

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

   "type": "ip_not_authorized"

 }

}

Najczęściej zadawane pytania

Czy lista dozwolonych adresów IP zapobiegnie każdemu nieuprawnionemu użyciu mojego klucza API?

Nie. Lista dozwolonych adresów IP może pomóc zmniejszyć ryzyko przez ograniczenie źródeł żądań API, ale nie zapobiega w pełni wszystkim formom nadużyć. Należy ją stosować wraz z innymi zalecanymi praktykami bezpieczeństwa, takimi jak bezpieczne przechowywanie kluczy, ich rotacja i solidne zabezpieczenie konta. Aby dodatkowo zwiększyć bezpieczeństwo, zapoznaj się z naszymi poradnikami w Centrum pomocy: Zalecane praktyki dotyczące bezpieczeństwa kluczy API i Zapobieganie nieuprawnionemu użyciu.

Czy lista dozwolonych adresów IP wpływa na opóźnienia?

Lista dozwolonych adresów IP może w niektórych przypadkach powodować minimalne opóźnienia, zwykle przy pierwszych żądaniach. Nie powinna znacząco wpływać na ogólną wydajność API.

Jak sprawdzić, czy żądanie jest odrzucane z powodu listy dozwolonych adresów IP?

Żądania odrzucone z powodu listy dozwolonych adresów IP zwracają:

• HTTP status: 401 Unauthorized

• Error code: ip_not_authorized