Apžvalga

Leidžiamų IP adresų sąrašas – tai pasirenkama saugos funkcija, leidžianti apriboti, iš kurių IP adresų galima pasiekti jūsų „OpenAI“ API.

Įjungus šią funkciją, leidžiamos tik užklausos iš nurodytų IP adresų arba IP adresų diapazonų. Užklausos iš visų kitų IP adresų atmetamos, net jei jose pateiktas galiojantis API raktas.

Ši funkcija padeda sumažinti neteisėto API naudojimo riziką, suteikdama prieigą tik iš patikimų tinklo aplinkų.

Pastaba: leidžiamų IP adresų sąrašas taikomas tik API užklausoms. Jis neturi įtakos prieigai prie platform.openai.com ar naudotojų prisijungimui.

Kodėl verta naudoti leidžiamų IP adresų sąrašą

Leidžiamų IP adresų sąrašas gali padėti:

• Suteikti API prieigą tik iš žinomos infrastruktūros (pavyzdžiui, jūsų serverių ar debesijos aplinkų)

• Sumažinti riziką nutekėjus API raktui

• Papildomai kontroliuoti, iš kur siunčiamas API srautas

Leidžiamų IP adresų sąrašas dažniausiai naudojamas gamybinėse aplinkose, kur API srautas siunčiamas iš nekintamų arba aiškiai apibrėžtų tinklo adresų diapazonų.

Kaip tai veikia

Sukonfigūruojate leidžiamų IP adresų arba CIDR diapazonų sąrašą.

• Užklausos iš leidžiamų IP adresų priimamos.

• Užklausos iš IP adresų, kurių nėra leidžiamų adresų sąraše, atmetamos.

Leidžiamų IP adresų sąrašą galima taikyti:

• organizacijos arba

• projekto lygmeniu

Prieinamumas

Leidžiamų IP adresų sąrašo funkcija prieinama visiems API klientams.

Norėdami sukonfigūruoti leidžiamų IP adresų sąrašą, atlikite toliau nurodytus veiksmus.

Leidžiamų IP adresų sąrašo konfigūravimas

Pastaba: galite pridėti iki 50 IP adresų arba CIDR diapazonų.

1. Atidarykite Nustatymus.

2. Pasirinkite Sauga.

3. Pasirinkite Leidžiamų IP adresų sąrašas.

4. Pridėkite vieną ar daugiau IP adresų arba CIDR diapazonų.

5. (Pasirinktinai) Naudodami įrankį Tikrinti patikrinkite, ar IP adresas įtrauktas į leidžiamų adresų sąrašą.

6. Įjunkite prieigos ribojimą pagal šį sąrašą:

   • konkrečiam projektui arba

   • visai organizacijai.

7. Išbandykite užklausas iš aplinkų, kurias planuojate naudoti.

Rekomenduojame pradėti nuo vieno projekto ir tik tada taikyti ribojimą visai organizacijai.

Pakeitimai gali įsigalioti per 15 minučių.


Pastaba: norėdami konfigūruoti leidžiamų IP adresų sąrašo nustatymus, turite turėti atitinkamas teises organizacijoje.

Trikčių šalinimas

Jei užklausos netikėtai nepavyksta:

• Įsitikinkite, kad užklausa siunčiama iš leidžiamo IP adreso.

• Patikrinkite, ar nepasikeitė jūsų infrastruktūros IP adresai.

• Patikrinkite, ar teisingai nurodėte IP adresų diapazonus.

• Palaukite iki 15 minučių, kol konfigūracijos pakeitimai įsigalios visoje sistemoje.

• Naudodami įrankį Tikrinti patikrinkite, ar IP adresas leidžiamas.

Kas nutinka užblokavus užklausą

Jei užklausa siunčiama iš IP adreso, kurio nėra leidžiamų adresų sąraše, ji atmetama ir grąžinama:

• HTTP būsena: 401 Unauthorized

• Klaidos kodas: ip_not_authorized

Atsakymo pavyzdys:

{

 "error": {

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

   "type": "ip_not_authorized"

 }

}

DUK

Ar leidžiamų IP adresų sąrašas visiškai apsaugos nuo neteisėto mano API rakto naudojimo?

Ne. Leidžiamų IP adresų sąrašas gali padėti sumažinti riziką, nes apriboja, iš kur galima siųsti API užklausas, tačiau neapsaugo nuo visų piktnaudžiavimo formų. Jį reikėtų naudoti kartu su kitomis rekomenduojamomis saugos priemonėmis: saugiu raktų saugojimu, reguliariu jų keitimu ir patikima paskyros apsauga. Norėdami sustiprinti saugą, peržiūrėkite mūsų pagalbos centro straipsnius „API raktų saugos rekomendacijos“ ir „Kaip išvengti neteisėto naudojimo“.

Ar leidžiamų IP adresų sąrašas turi įtakos delsai?

Leidžiamų IP adresų sąrašas kai kuriais atvejais gali šiek tiek padidinti delsą, paprastai siunčiant pirmąsias užklausas. Reikšmingo poveikio bendram API našumui nesitikima.

Kaip sužinoti, ar užklausa atmetama dėl leidžiamų IP adresų sąrašo?

Jei užklausa atmetama dėl leidžiamų IP adresų sąrašo, grąžinama:

• HTTP būsena: 401 Unauthorized

• Klaidos kodas: ip_not_authorized