Prehľad
Zoznam povolených IP adries je voliteľná bezpečnostná funkcia, ktorá umožňuje obmedziť, z ktorých IP adries možno pristupovať k vášmu API OpenAI.
Keď je zapnutá, povoľujú sa iba požiadavky z nastavených IP adries alebo rozsahov IP adries. Požiadavky zo všetkých ostatných IP adries sa odmietnu, aj keď obsahujú platný kľúč API.
Táto funkcia pomáha znižovať riziko neoprávneného používania API tým, že obmedzuje prístup na dôveryhodné sieťové prostredia.
Poznámka: Zoznam povolených IP adries sa vzťahuje iba na požiadavky API. Nemá vplyv na prístup k platform.openai.com ani na prihlasovanie používateľov.
Prečo používať zoznam povolených IP adries
Zoznam povolených IP adries vám môže pomôcť:
Obmedziť prístup k API na známu infraštruktúru (napríklad vaše servery alebo cloudové prostredia)
Znížiť riziko v prípade úniku kľúča API
Získať ďalšiu úroveň kontroly nad tým, odkiaľ prichádza prevádzka API
Zoznam povolených IP adries sa najčastejšie používa v produkčných prostrediach, kde prevádzka API pochádza z pevných alebo presne vymedzených sieťových rozsahov.
Ako to funguje
Nastavíte zoznam povolených IP adries alebo rozsahov CIDR.
Požiadavky z povolených IP adries sa prijmú.
Požiadavky z IP adries, ktoré nie sú v zozname povolených adries, sa odmietnu.
Zoznam povolených IP adries možno uplatniť na:
Úrovni organizácie alebo
Úrovni projektu
Dostupnosť
Zoznam povolených IP adries je dostupný všetkým zákazníkom používajúcim API.
Ak chcete nastaviť zoznam povolených IP adries, postupujte podľa krokov nižšie.
Nastavenie zoznamu povolených IP adries
Poznámka: Môžete pridať až 50 IP adries alebo rozsahov CIDR.
Otvorte Nastavenia.
Vyberte Zabezpečenie.
Vyberte Zoznam povolených IP adries.
Pridajte jednu alebo viac IP adries alebo rozsahov CIDR.
(Voliteľné) Pomocou nástroja Skontrolovať overte, či je IP adresa vo vašom zozname povolených adries.
Zapnite obmedzenie prístupu podľa zoznamu povolených adries pre:
Konkrétny projekt alebo
Celú organizáciu.
Otestujte požiadavky z prostredí, ktoré plánujete používať.
Odporúčame začať s jedným projektom a až potom zapnúť obmedzenie prístupu pre celú organizáciu.
Po vykonaní zmien môže trvať až 15 minút, kým sa prejavia.
Poznámka: Na nastavenie zoznamu povolených IP adries musíte mať príslušné oprávnenia v organizácii.
Riešenie problémov
Ak požiadavky neočakávane zlyhávajú:
Overte, či požiadavka pochádza z povolenej IP adresy.
Skontrolujte, či sa nezmenili IP adresy vašej infraštruktúry.
Skontrolujte správnosť nastavených rozsahov IP adries.
Počkajte až 15 minút, kým sa zmeny nastavení prejavia.
Pomocou nástroja Skontrolovať overte, či je IP adresa povolená.
Čo sa stane pri zablokovaní požiadavky
Ak požiadavka pochádza z IP adresy, ktorá nie je v zozname povolených adries, zlyhá s nasledujúcou chybou:
Stav HTTP: 401 Unauthorized
Kód chyby: ip_not_authorized
Príklad odpovede:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Často kladené otázky
Zabráni zoznam povolených IP adries akémukoľvek neoprávnenému použitiu môjho kľúča API?
Nie. Zoznam povolených IP adries môže pomôcť znížiť riziko tým, že obmedzuje, odkiaľ môžu prichádzať požiadavky API, no nezabráni úplne všetkým formám zneužitia. Mal by sa používať spolu s ďalšími odporúčanými bezpečnostnými postupmi, ako sú bezpečné ukladanie kľúčov, ich pravidelná obmena a dôkladné zabezpečenie účtu. Ďalšie informácie o zabezpečení nájdete v článkoch nášho centra pomoci Odporúčané postupy na ochranu kľúčov API a Predchádzanie neoprávnenému používaniu.
Má zoznam povolených IP adries vplyv na latenciu?
Používanie zoznamu povolených IP adries môže v niektorých prípadoch mierne zvýšiť latenciu, zvyčajne pri prvých požiadavkách. Neočakáva sa, že by výrazne ovplyvnilo celkový výkon API.
Ako zistím, či požiadavka zlyháva pre obmedzenie podľa zoznamu povolených IP adries?
Požiadavky, ktoré zlyhajú pre obmedzenie podľa zoznamu povolených IP adries, vrátia:
HTTP status: 401 UnauthorizedError code: ip_not_authorized