Kunci yang bocor ialah punca paling biasa bil API melambung. BroadNet Inference memberi anda dua kawalan: senarai IP dibenarkan (IP allow-list) dan pembatalan (revoke) yang pantas.
Dua jenis kelayakan
| Kelayakan | Gunakan untuk | Anggap sebagai |
|---|---|---|
| Kunci inferens | Permintaan model ke /v1/* |
Rahsia untuk satu aplikasi atau ejen |
| Kelayakan portal | Automasi akaun: kunci, IP dibenarkan, pembelian | Kuasa penuh ke atas akaun |
Kedua-duanya dipaparkan sekali sahaja. Portal hanya menyimpan cincangan SHA-256, jadi ia tidak boleh memaparkan kunci itu lagi. Kunci inferens bayar ikut guna sah selama setahun dari tarikh dicipta, dan satu akaun boleh memegang sehingga sepuluh kunci aktif.
Tetapkan senarai dibenarkan
Di halaman akaun, tambah satu alamat IPv4 atau IPv6 atau julat CIDR bagi setiap baris, sehingga 32 entri. Senarai kosong bermakna tiada sekatan IP. Kunci baharu mewarisi senarai akaun ini. Edge menyemak IP klien yang dilaporkan oleh Cloudflare pada setiap permintaan API.
Untuk mengurus senarai akaun daripada skrip, PUT /portal/allowed_ips menggantikannya dalam satu panggilan (memerlukan kelayakan portal).
Beri satu kunci senarainya sendiri semasa anda menciptanya dengan kelayakan portal:
curl -X POST https://inference.broadnet.ai/portal/keys \
-H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
-H "Content-Type: application/json" \
-d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
allowed_ips per kunci menggantikan senarai akaun yang diwarisi bagi kunci itu. Respons mengandungi kunci mentah sekali sahaja; simpan dengan segera.
Batalkan kunci yang bocor dengan pantas
DELETE /portal/keys/{alias} membatalkan kunci bayar ikut guna, dan DELETE /portal/keys/hourly/{alias} membatalkan kunci sejam (caj pembelian asal kekal). Selepas pembatalan atau perubahan senarai dibenarkan, permintaan baharu berhenti dalam lima saat.
curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
-H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"
Tetapkan KEY_ALIAS kepada alias yang dipaparkan bagi kunci itu di halaman akaun atau dalam GET /portal/keys. Alias bukan kunci rahsia. Jika kelayakan portal bocor, batalkannya dengan DELETE /portal/credentials/{id}: ia boleh melakukan semua yang boleh dilakukan oleh akaun anda.
Penyelesaian masalah
- 403 dari pelayan yang telah anda senaraikan. Edge melihat alamat keluar awam anda, bukan IP peribadi pelayan. Pelayan di belakang get laluan NAT, proksi atau pengimbang beban keluar melalui alamat peranti itu. Pelayan yang mempunyai IPv6 mungkin keluar melalui IPv6 walaupun anda hanya menyenaraikan alamat IPv4nya. Senaraikan alamat sebenar yang digunakan oleh permintaan untuk keluar, atau julat CIDR yang meliputinya.
- Kunci baharu mengabaikan senarai akaun. Tatasusunan
allowed_ipsper kunci menggantikan senarai akaun yang diwarisi bagi kunci itu. Semak apa yang anda hantar semasa menciptanya. - 409
key_limit_reached. Akaun sudah mempunyai sepuluh kunci aktif. Batalkan satu yang tidak lagi digunakan. - Permintaan masih berjaya beberapa saat selepas pembatalan. Ini dijangka sehingga lima saat sementara cache dikemas kini.
Permintaan dari alamat yang tiada dalam senarai menerima 403. Lihat semua kod ralat BroadNet dan bila perlu cuba semula. Untuk membuat permintaan pertama dengan kunci baharu, ikuti panduan OpenAI Python SDK. Entri glosari senarai IP dibenarkan menerangkan konsep ini secara umum.

