BroadRouter
Mulakan

Kunci API kepada pelayan anda dengan senarai IP dibenarkan

Dikemas kini

Tambah alamat IPv4 atau IPv6 keluar (egress) atau julat CIDR pelayan anda ke senarai dibenarkan akaun, sehingga 32 entri. Kunci baharu mewarisi senarai itu melainkan anda menghantar allowed_ips semasa menciptanya. Permintaan dari alamat lain menerima 403, dan perubahan senarai atau pembatalan kunci berkuat kuasa dalam lima saat.

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_ips per 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.

A metal key whose bow is shaped like curly braces { }, with the text "One API key. More possibilities."

Soalan lazim

Bagaimanakah saya mengehadkan kunci API LLM kepada alamat IP pelayan saya?

Tambah alamat keluar awam pelayan, atau julat CIDR, ke senarai dibenarkan akaun di halaman akaun BroadNet, atau hantar allowed_ips semasa mencipta kunci melalui POST /portal/keys. Permintaan dari alamat lain ditolak dengan 403.

Adakah senarai dibenarkan yang kosong menyekat semua?

Tidak. Senarai kosong bermakna tiada sekatan IP, jadi kunci berfungsi dari mana-mana alamat. Tambah sekurang-kurangnya satu entri untuk menghidupkan sekatan.

Bolehkah saya menggunakan kunci inferens untuk mencipta kunci lain?

Tidak. Kunci inferens hanya memanggil laluan model /v1/*. Mencipta dan membatalkan kunci, menukar IP dibenarkan dan membeli kunci sejam memerlukan kelayakan portal, yang membawa kuasa penuh ke atas akaun.

Berapa cepatkah pembatalan kunci yang bocor berkuat kuasa?

Dokumentasi BroadNet menyatakan permintaan baharu berhenti dalam lima saat selepas pembatalan atau perubahan senarai dibenarkan, kerana keputusan kebenaran boleh kekal dalam cache yang direplikasi selama itu.

Baca sebagai MarkdownTanya ChatGPTTanya ClaudeTanya Perplexity