BroadRouter
Başlayın

API anahtarlarını IP izin listeleriyle sunucularınıza kilitleyin

Güncellendi

Sunucularınızın çıkış IPv4 veya IPv6 adreslerini ya da CIDR aralıklarını hesap izin listesine ekleyin; en fazla 32 kayıt girilebilir. Oluştururken allowed_ips vermediğiniz sürece yeni anahtarlar bu listeyi devralır. Başka adreslerden gelen istekler 403 alır; izin listesi değişiklikleri ve iptaller beş saniye içinde geçerli olur.

Sızan bir anahtar, API faturasının kontrolden çıkmasının en yaygın yoludur. BroadNet Inference size iki kontrol sunar: IP izin listesi ve hızlı iptal.

İki tür kimlik bilgisi

Kimlik bilgisi Ne için kullanılır Nasıl ele alınmalı
Inference anahtarı /v1/* adresine model istekleri Tek bir uygulama ya da ajana ait bir sır
Portal kimlik bilgisi Hesap otomasyonu: anahtarlar, izin verilen IP’ler, satın almalar Hesap üzerinde tam yetki

İkisi de yalnızca bir kez gösterilir. Portal yalnızca bir SHA-256 özeti saklar, bu yüzden anahtarı yeniden gösteremez. Kullandıkça öde inference anahtarı oluşturulduğu andan itibaren bir yıl geçerlidir ve bir hesapta en fazla on etkin anahtar bulunabilir.

İzin listesi tanımlayın

Hesap sayfasında her satıra bir IPv4 veya IPv6 adresi ya da CIDR aralığı ekleyin; en fazla 32 kayıt girebilirsiniz. Boş liste IP kısıtlaması olmadığı anlamına gelir. Yeni anahtarlar bu hesap listesini devralır. Edge katmanı, her API isteğinde Cloudflare’in bildirdiği istemci IP’sini kontrol eder.

Hesap listesini bir betikle yönetmek için PUT /portal/allowed_ips listeyi tek çağrıda değiştirir (portal kimlik bilgisi gerekir).

Bir anahtarı portal kimlik bilgisiyle oluştururken ona kendi listesini verebilirsiniz:

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"]}'

Anahtara özel allowed_ips, o anahtar için devralınan hesap listesinin yerini alır. Yanıt, ham anahtarı yalnızca bir kez içerir; hemen saklayın.

Sızan anahtarı hızla iptal edin

DELETE /portal/keys/{alias} bir kullandıkça öde anahtarını, DELETE /portal/keys/hourly/{alias} ise saatlik bir anahtarı iptal eder (ilk satın alma ücreti olduğu gibi kalır). Bir iptal ya da izin listesi değişikliğinden sonra yeni istekler beş saniye içinde durur.

curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"

KEY_ALIAS değerini, hesap sayfasında ya da GET /portal/keys çıktısında anahtar için gösterilen takma ada ayarlayın. Takma ad gizli anahtarın kendisi değildir. Bir portal kimlik bilgisi sızarsa onu DELETE /portal/credentials/{id} ile iptal edin: hesabınızın yapabildiği her şeyi yapabilir.

Sorun giderme

  • Listeye eklediğiniz bir sunucudan 403. Edge katmanı sunucunun özel IP’sini değil, herkese açık çıkış adresinizi görür. NAT ağ geçidi, proxy ya da yük dengeleyici arkasındaki sunucular dışarıya o cihazın adresiyle çıkar. IPv6 desteği olan bir sunucu, yalnızca IPv4 adresini listeye eklemiş olsanız bile IPv6 üzerinden çıkabilir. İsteğin gerçekten çıktığı adresi ya da onu kapsayan bir CIDR aralığını ekleyin.
  • Yeni bir anahtar hesap listesini yok sayıyor. Anahtara özel bir allowed_ips dizisi, o anahtar için devralınan hesap listesinin yerini alır. Oluştururken ne gönderdiğinizi kontrol edin.
  • 409 key_limit_reached. Hesapta zaten on etkin anahtar var. Artık kullanmadığınız birini iptal edin.
  • İptalden birkaç saniye sonra istekler hâlâ başarılı oluyor. Önbellek güncellenirken beş saniyeye kadar bu beklenen bir durumdur.

Listede olmayan bir adresten gelen istek 403 alır. BroadNet’in tüm hata kodları ve ne zaman yeniden denenmeli rehberine bakın. Yeni bir anahtarla ilk isteğinizi göndermek için OpenAI Python SDK rehberini izleyin. IP izin listesi sözlük maddesi kavramı genel olarak açıklar.

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

Sık sorulan sorular

Bir LLM API anahtarını sunucumun IP adresiyle nasıl sınırlarım?

Sunucunun herkese açık çıkış adresini ya da bir CIDR aralığını BroadNet hesap sayfasındaki hesap izin listesine ekleyin veya anahtarı POST /portal/keys ile oluştururken allowed_ips verin. Başka herhangi bir adresten gelen istekler 403 ile reddedilir.

Boş bir izin listesi her şeyi engeller mi?

Hayır. Boş liste IP kısıtlaması olmadığı anlamına gelir; anahtar her adresten çalışır. Kısıtlamayı açmak için en az bir kayıt ekleyin.

Bir inference anahtarıyla başka anahtarlar oluşturabilir miyim?

Hayır. Inference anahtarları yalnızca /v1/* model yollarını çağırır. Anahtar oluşturmak ve iptal etmek, izin verilen IP'leri değiştirmek ve saatlik anahtar satın almak için hesap üzerinde tam yetki taşıyan bir portal kimlik bilgisi gerekir.

Sızan bir anahtarı iptal etmek ne kadar hızlı etki eder?

BroadNet'in belgelerine göre yeni istekler, bir iptal ya da izin listesi değişikliğinden sonraki beş saniye içinde durur; çünkü yetkilendirme kararları bu süre boyunca çoğaltılmış bir önbellekte kalabilir.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor