Gambaran umum
Daftar izin IP adalah fitur keamanan opsional yang memungkinkan Anda membatasi alamat IP yang dapat mengakses API OpenAI Anda.
Saat fitur ini diaktifkan, hanya permintaan dari alamat IP atau rentang IP yang telah dikonfigurasi yang diizinkan. Permintaan dari semua IP lain ditolak, meskipun menyertakan kunci API yang valid.
Fitur ini dirancang untuk membantu mengurangi risiko penggunaan API tanpa izin dengan membatasi akses hanya dari lingkungan jaringan tepercaya.
Catatan: Daftar izin IP hanya berlaku untuk permintaan API. Fitur ini tidak memengaruhi akses ke platform.openai.com atau proses masuk pengguna.
Mengapa menggunakan daftar izin IP
Daftar izin IP dapat membantu Anda:
Membatasi akses API hanya dari infrastruktur yang dikenal (misalnya, server atau lingkungan cloud Anda)
Mengurangi risiko jika terjadi kebocoran kunci API
Menambahkan lapisan kontrol atas asal lalu lintas API
Daftar izin IP paling sering digunakan di lingkungan produksi yang lalu lintas API-nya berasal dari rentang jaringan tetap atau yang ditentukan dengan jelas.
Cara kerja
Anda mengonfigurasi daftar alamat IP atau rentang CIDR yang diizinkan.
Permintaan dari IP yang diizinkan akan diterima.
Permintaan dari IP yang tidak tercantum dalam daftar izin akan ditolak.
Daftar izin IP dapat diterapkan pada:
Tingkat organisasi, atau
Tingkat proyek
Ketersediaan
Daftar izin IP tersedia bagi semua pelanggan API.
Untuk mengonfigurasi daftar izin IP, ikuti langkah-langkah di bawah ini.
Mengonfigurasi daftar izin IP
Catatan: Anda dapat menambahkan hingga 50 alamat IP atau rentang CIDR.
Buka Pengaturan.
Pilih Keamanan.
Pilih Daftar izin IP.
Tambahkan satu atau beberapa alamat IP atau rentang CIDR.
(Opsional) Gunakan alat Periksa untuk memastikan apakah suatu IP tercantum dalam daftar izin Anda.
Aktifkan daftar izin untuk:
Proyek tertentu, atau
Seluruh organisasi Anda.
Uji permintaan dari lingkungan yang akan Anda gunakan.
Kami menyarankan untuk memulai dengan satu proyek sebelum menerapkannya ke seluruh organisasi.
Setelah perubahan dibuat, pembaruan mungkin memerlukan waktu hingga 15 menit untuk berlaku.
Catatan: Anda harus memiliki izin yang sesuai dalam organisasi untuk mengonfigurasi pengaturan daftar izin IP.
Pemecahan masalah
Jika permintaan Anda gagal secara tidak terduga:
Pastikan permintaan berasal dari alamat IP yang diizinkan.
Periksa apakah alamat IP infrastruktur Anda telah berubah.
Pastikan rentang IP yang Anda konfigurasikan sudah benar.
Tunggu hingga 15 menit agar perubahan konfigurasi diterapkan secara menyeluruh.
Gunakan alat Periksa untuk memastikan apakah suatu IP diizinkan.
Apa yang terjadi saat permintaan diblokir
Jika permintaan berasal dari alamat IP yang tidak tercantum dalam daftar izin, permintaan tersebut akan gagal dengan:
Status HTTP: 401 Unauthorized
Kode error: ip_not_authorized
Contoh respons:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Pertanyaan umum
Apakah daftar izin IP akan mencegah semua penggunaan kunci API saya tanpa izin?
Tidak. Daftar izin IP dapat membantu mengurangi risiko dengan membatasi asal permintaan API, tetapi tidak sepenuhnya mencegah semua bentuk penyalahgunaan. Fitur ini sebaiknya digunakan bersama praktik terbaik keamanan lainnya, seperti penyimpanan kunci yang aman, rotasi kunci, dan keamanan akun yang kuat. Untuk meningkatkan keamanan, baca panduan pusat bantuan kami tentang Praktik terbaik untuk keamanan kunci API dan Mencegah penggunaan tanpa izin.
Apakah daftar izin IP memengaruhi latensi?
Daftar izin IP dapat sedikit menambah latensi dalam beberapa kasus, biasanya pada permintaan awal. Fitur ini diperkirakan tidak akan memengaruhi kinerja API secara keseluruhan secara signifikan.
Bagaimana cara mengetahui apakah permintaan gagal karena daftar izin IP?
Permintaan yang gagal karena daftar izin IP akan mengembalikan:
Status HTTP: 401 UnauthorizedKode error: ip_not_authorized