Pangkalahatang-ideya
Ang IP allowlisting ay isang opsyonal na feature sa seguridad na nagbibigay-daan sa iyong limitahan kung aling mga IP address ang maaaring mag-access sa iyong OpenAI API.
Kapag naka-enable ito, mga request lang na nagmumula sa mga naka-configure na IP address o IP range ang pinapayagan. Tinatanggihan ang mga request mula sa lahat ng iba pang IP, kahit may kasama ang mga itong valid na API key.
Layunin ng feature na ito na makatulong na mabawasan ang panganib ng hindi awtorisadong paggamit ng API sa pamamagitan ng paglilimita ng access sa mga pinagkakatiwalaang network environment.
Tandaan: Nalalapat lang ang IP allowlisting sa mga API request. Hindi nito naaapektuhan ang access sa platform.openai.com o ang pag-sign in ng user.
Bakit gagamit ng IP allowlisting
Makakatulong sa iyo ang IP allowlisting na:
Limitahan ang access sa API sa kilalang imprastraktura (halimbawa, ang iyong mga server o cloud environment)
Bawasan ang panganib kung sakaling ma-leak ang isang API key
Magdagdag ng isa pang antas ng kontrol sa pinagmumulan ng API traffic
Pinakakaraniwang ginagamit ang IP allowlisting sa mga production environment kung saan nagmumula ang API traffic sa mga nakapirmi o malinaw na tinukoy na network range.
Paano ito gumagana
Magko-configure ka ng listahan ng mga pinapayagang IP address o CIDR range.
Tinatanggap ang mga request mula sa mga pinapayagang IP.
Tinatanggihan ang mga request mula sa mga IP na wala sa allowlist.
Maaaring ilapat ang IP allowlisting sa:
Antas ng organisasyon, o
Antas ng proyekto
Sino ang maaaring gumamit
Maaaring gamitin ng lahat ng customer ng API ang IP allowlisting.
Para i-configure ang IP allowlisting, sundin ang mga hakbang sa ibaba.
I-configure ang IP allowlisting
Tandaan: Maaari kang magdagdag ng hanggang 50 IP address o CIDR range.
Buksan ang Mga Setting.
Piliin ang Seguridad.
Piliin ang IP allowlist.
Magdagdag ng isa o higit pang IP address o CIDR range.
(Opsyonal) Gamitin ang tool na Suriin para tiyaking kasama ang isang IP sa iyong allowlist.
I-enable ang allowlisting para sa:
Isang partikular na proyekto, o
Iyong buong organisasyon.
Subukan ang mga request mula sa mga environment na inaasahan mong gagamitin.
Inirerekomenda naming magsimula sa iisang proyekto bago ito ipatupad sa buong organisasyon.
Pagkatapos gumawa ng mga pagbabago, maaaring abutin ng hanggang 15 minuto bago magkabisa ang mga update.
Tandaan: Dapat ay mayroon kang naaangkop na mga pahintulot sa organisasyon para ma-configure ang mga setting ng IP allowlisting.
Pag-troubleshoot
Kung hindi inaasahang hindi natutuloy ang mga request:
Tiyaking nagmumula ang request sa isang pinapayagang IP address.
Tingnan kung nagbago ang mga IP ng iyong imprastraktura.
Suriin kung tama ang mga IP range na na-configure mo.
Maghintay nang hanggang 15 minuto para mailapat sa buong system ang mga pagbabago sa configuration.
Gamitin ang tool na Suriin para tiyaking pinapayagan ang isang IP.
Ano ang mangyayari kapag na-block ang isang request
Kung nagmumula ang isang request sa IP address na wala sa allowlist, hindi ito matutuloy at ibabalik nito ang:
HTTP status: 401 Unauthorized
Error code: ip_not_authorized
Halimbawang tugon:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Mga madalas itanong
Mapipigilan ba ng IP allowlisting ang lahat ng hindi awtorisadong paggamit ng aking API key?
Hindi. Makakatulong ang IP allowlisting na mabawasan ang panganib sa pamamagitan ng paglilimita kung saan maaaring magmula ang mga API request, pero hindi nito ganap na napipigilan ang lahat ng uri ng maling paggamit. Dapat itong gamitin kasabay ng iba pang pinakamahuhusay na kasanayan sa seguridad gaya ng ligtas na pag-iimbak ng key, regular na pagpapalit ng key, at matibay na seguridad ng account. Para sa dagdag na seguridad, basahin ang aming mga gabay sa help center tungkol sa Pinakamahuhusay na kasanayan para sa kaligtasan ng API key at Pag-iwas sa hindi awtorisadong paggamit.
Nakakaapekto ba ang IP allowlisting sa latency?
Maaaring bahagyang tumaas ang latency dahil sa IP allowlisting sa ilang sitwasyon, karaniwan sa mga unang request. Hindi ito inaasahang magkaroon ng malaking epekto sa pangkalahatang performance ng API.
Paano ko malalaman kung hindi natutuloy ang isang request dahil sa IP allowlisting?
Ibinabalik ng mga request na hindi natutuloy dahil sa IP allowlisting ang:
HTTP status: 401 UnauthorizedError code: ip_not_authorized