Gambaran keseluruhan
Senarai IP dibenarkan ialah ciri keselamatan pilihan yang membolehkan anda mengehadkan alamat IP yang boleh mengakses API OpenAI anda.
Apabila didayakan, hanya permintaan daripada alamat IP atau julat IP yang telah dikonfigurasikan dibenarkan. Permintaan daripada semua IP lain ditolak, walaupun mengandungi kunci API yang sah.
Ciri ini bertujuan membantu mengurangkan risiko penggunaan API tanpa kebenaran dengan mengehadkan akses kepada persekitaran rangkaian yang dipercayai.
Nota: Senarai IP dibenarkan hanya terpakai pada permintaan API. Ciri ini tidak menjejaskan akses ke platform.openai.com atau log masuk pengguna.
Mengapa menggunakan senarai IP dibenarkan
Senarai IP dibenarkan boleh membantu anda:
Mengehadkan akses API kepada infrastruktur yang diketahui (contohnya, pelayan atau persekitaran awan anda)
Mengurangkan pendedahan kepada risiko sekiranya kunci API bocor
Menambah lapisan kawalan terhadap sumber trafik API
Senarai IP dibenarkan paling lazim digunakan dalam persekitaran pengeluaran yang trafik APInya berasal daripada julat rangkaian yang tetap atau ditakrifkan dengan jelas.
Cara ciri ini berfungsi
Anda mengkonfigurasikan senarai alamat IP atau julat CIDR yang dibenarkan.
Permintaan daripada IP yang dibenarkan diterima.
Permintaan daripada IP yang tiada dalam senarai IP dibenarkan ditolak.
Senarai IP dibenarkan boleh digunakan pada:
Peringkat organisasi, atau
Peringkat projek
Ketersediaan
Senarai IP dibenarkan tersedia untuk semua pelanggan API.
Untuk mengkonfigurasikan senarai IP dibenarkan, ikut langkah di bawah.
Konfigurasikan senarai IP dibenarkan
Nota: Anda boleh menambah sehingga 50 alamat IP atau julat CIDR.
Buka Tetapan.
Pilih Keselamatan.
Pilih Senarai IP dibenarkan.
Tambah satu atau lebih alamat IP atau julat CIDR.
(Pilihan) Gunakan alat Semak untuk mengesahkan sama ada sesuatu IP termasuk dalam senarai IP dibenarkan anda.
Dayakan senarai IP dibenarkan untuk:
Projek tertentu, atau
Seluruh organisasi anda.
Uji permintaan daripada persekitaran yang anda jangka akan digunakan.
Kami mengesyorkan agar anda bermula dengan satu projek sebelum mendayakan penguatkuasaan di seluruh organisasi.
Selepas perubahan dibuat, kemas kini mungkin mengambil masa sehingga 15 minit untuk berkuat kuasa.
Nota: Anda mesti mempunyai kebenaran organisasi yang sesuai untuk mengkonfigurasikan tetapan senarai IP dibenarkan.
Penyelesaian masalah
Jika permintaan anda gagal secara tidak dijangka:
Pastikan permintaan berasal daripada alamat IP yang dibenarkan.
Semak sama ada alamat IP infrastruktur anda telah berubah.
Semak ketepatan julat IP yang telah anda konfigurasikan.
Tunggu sehingga 15 minit untuk perubahan konfigurasi disebarkan ke seluruh sistem.
Gunakan alat Semak untuk mengesahkan sama ada sesuatu IP dibenarkan.
Apa yang berlaku apabila permintaan disekat
Jika permintaan berasal daripada alamat IP yang tiada dalam senarai IP dibenarkan, permintaan itu akan gagal dengan:
Status HTTP: 401 Unauthorized
Kod ralat: ip_not_authorized
Contoh respons:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Soalan lazim
Adakah senarai IP dibenarkan akan menghalang semua penggunaan kunci API saya tanpa kebenaran?
Tidak. Senarai IP dibenarkan boleh membantu mengurangkan risiko dengan mengehadkan sumber permintaan API, tetapi tidak menghalang sepenuhnya semua bentuk penyalahgunaan. Ciri ini harus digunakan bersama amalan terbaik keselamatan yang lain seperti penyimpanan kunci yang selamat, penggantian kunci secara berkala dan keselamatan akaun yang kukuh. Untuk keselamatan tambahan, rujuk panduan pusat bantuan kami tentang Amalan terbaik untuk keselamatan kunci API dan Mencegah penggunaan tanpa kebenaran.
Adakah senarai IP dibenarkan menjejaskan kependaman?
Senarai IP dibenarkan mungkin menambah sedikit kependaman dalam sesetengah keadaan, lazimnya pada permintaan awal. Ciri ini tidak dijangka menjejaskan prestasi API secara keseluruhan dengan ketara.
Bagaimanakah saya boleh mengetahui sama ada sesuatu permintaan gagal disebabkan oleh senarai IP dibenarkan?
Permintaan yang gagal disebabkan oleh senarai IP dibenarkan mengembalikan:
Status HTTP: 401 UnauthorizedKod ralat: ip_not_authorized