Přehled

Seznam povolených IP adres je volitelná bezpečnostní funkce, která umožňuje omezit, ze kterých IP adres lze přistupovat k vašemu API OpenAI.

Když je funkce zapnutá, jsou povoleny pouze požadavky z nastavených IP adres nebo rozsahů. Požadavky ze všech ostatních IP adres jsou odmítnuty, i když obsahují platný klíč API.

Tato funkce pomáhá snížit riziko neoprávněného používání API tím, že omezuje přístup na důvěryhodná síťová prostředí.

Poznámka: Seznam povolených IP adres se vztahuje pouze na požadavky API. Nemá vliv na přístup k platform.openai.com ani na přihlašování uživatelů.

Proč používat seznam povolených IP adres

Seznam povolených IP adres vám může pomoci:

• Omezit přístup k API na známou infrastrukturu (například vaše servery nebo cloudová prostředí)

• Snížit riziko v případě úniku klíče API

• Získat další úroveň kontroly nad tím, odkud přicházejí požadavky API

Seznam povolených IP adres se nejčastěji používá v produkčních prostředích, kde požadavky API pocházejí z pevných nebo jasně vymezených síťových rozsahů.

Jak to funguje

Nastavíte seznam povolených IP adres nebo rozsahů CIDR.

• Požadavky z povolených IP adres jsou přijaty.

• Požadavky z IP adres, které nejsou na seznamu povolených adres, jsou odmítnuty.

Seznam povolených IP adres lze uplatnit na:

• úrovni organizace nebo

• úrovni projektu

Dostupnost

Seznam povolených IP adres je dostupný všem zákazníkům API.

Seznam povolených IP adres nastavíte podle následujících kroků.

Nastavení seznamu povolených IP adres

Poznámka: Můžete přidat až 50 IP adres nebo rozsahů CIDR.

1. Otevřete Nastavení.

2. Vyberte Zabezpečení.

3. Vyberte Seznam povolených IP adres.

4. Přidejte jednu nebo více IP adres či rozsahů CIDR.

5. (Volitelné) Pomocí nástroje Zkontrolovat ověřte, zda je IP adresa zahrnuta v seznamu povolených adres.

6. Zapněte omezení podle seznamu povolených adres pro:

   • konkrétní projekt nebo

   • celou organizaci.

7. Otestujte požadavky z prostředí, která plánujete používat.

Než omezení zapnete pro celou organizaci, doporučujeme začít s jedním projektem.

Může trvat až 15 minut, než se provedené změny projeví.


Poznámka: K nastavení seznamu povolených IP adres potřebujete příslušná oprávnění v organizaci.

Řešení problémů

Pokud požadavky neočekávaně selhávají:

• Ověřte, že požadavek pochází z povolené IP adresy.

• Zkontrolujte, zda se nezměnily IP adresy vaší infrastruktury.

• Zkontrolujte správnost nastavených rozsahů IP adres.

• Počkejte až 15 minut, než se změny nastavení projeví.

• Pomocí nástroje Zkontrolovat ověřte, zda je IP adresa povolená.

Co se stane, když je požadavek zablokován

Pokud požadavek pochází z IP adresy, která není na seznamu povolených adres, selže s následující chybou:

• Stav HTTP: 401 Unauthorized

• Kód chyby: ip_not_authorized

Příklad odpovědi:

{

 "error": {

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

   "type": "ip_not_authorized"

 }

}

Časté dotazy

Zabrání seznam povolených IP adres veškerému neoprávněnému použití mého klíče API?

Ne. Seznam povolených IP adres může pomoci snížit riziko tím, že omezuje, odkud mohou požadavky API přicházet. Nezabrání však všem formám zneužití. Měl by se používat spolu s dalšími osvědčenými bezpečnostními postupy, jako je bezpečné ukládání klíčů, jejich pravidelná obměna a důkladné zabezpečení účtu. Další tipy pro zabezpečení najdete v článcích našeho centra nápovědy Osvědčené postupy pro zabezpečení klíčů API a Jak předcházet neoprávněnému používání.

Má seznam povolených IP adres vliv na latenci?

Používání seznamu povolených IP adres může v některých případech způsobit minimální zpoždění, obvykle u prvních požadavků. Neočekává se, že by výrazně ovlivnilo celkový výkon API.

Jak poznám, že požadavek selhává kvůli seznamu povolených IP adres?

Požadavky, které selžou kvůli seznamu povolených IP adres, vracejí:

• HTTP status: 401 Unauthorized

• Error code: ip_not_authorized