Bir API anahtarı varsayılan olarak her yerden çalışır. İzin listesi onu, kodunuzu gerçekten çalıştırdığınız yerlere bağlar.
Nasıl çalışır
API’nin uç katmanı her isteğin kaynak IP’sini bir listeyle karşılaştırır. Adres listedeyse veya listelenen bir aralığın içindeyse istek normal anahtar kontrolüne geçer. Değilse reddedilir.
Aralıklar CIDR gösterimiyle yazılır: bir adres, bir eğik çizgi ve bir önek uzunluğu. RFC 4632, önek uzunluğunun baştaki kaç bitin sabit olduğunu belirttiğini açıklar. IPv4 için:
| Kayıt | Kapsadığı |
|---|---|
203.0.113.7 |
tek adres |
198.51.100.0/24 |
256 adres, 198.51.100.0 ile 198.51.100.255 arası |
10.0.0.0/16 |
65.536 adres |
IPv6 aynı fikri 128 bitlik adreslerle kullanır, örneğin 2001:db8::/48.
Önemli olan adres, çıkış (egress) IP’nizdir: sunucunuzun trafiğinin dışarı çıktığı genel adres. NAT, yük dengeleyici veya kurumsal proxy arkasında bu, makinenin kendisi için gösterdiği adres çoğu zaman değildir.
Neden önemli
API anahtarları taşıyıcı (bearer) token’lardır: elinde tutan herkes kullanabilir. Anahtarlar commit’ler, loglar, ekran görüntüleri ve dizüstü bilgisayarlar yoluyla sızar. İzin listesiyle çalınmış bir anahtar saldırganın ağından çalışmaz; bu da bir sızıntıyı harcama olayından önemsiz bir olaya çevirir. Örneğin GitHub izin listesini web oturum açmalarının yanı sıra API çağrılarına ve kişisel erişim token’larına da uygular.
Bedeli biraz operasyon işidir. Her yeni sunucu, bölge veya CI runner’ın çıkış IP’si eklenmelidir; dinamik IP’ler için de sabit bir çıkış yolu gerekir.
BroadNet Inference’ta
Hesap sayfasında her satıra bir IPv4 veya IPv6 adresi ya da CIDR aralığı ekleyin; en fazla 32 kayıt. Boş liste kısıtlama yok demektir. Yeni anahtarlar hesap listesini devralır. Anahtar başına bir allowed_ips, o anahtar için hesap listesinin yerini alır:
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"]}'
Diğer adreslerden gelen istekler 403 alır. Bir değişiklik veya anahtar iptalinden sonra yeni istekler beş saniye içinde durur. Tüm adımlar API anahtarları ve IP izin listeleri rehberinde, hata tablosu hatalar ve yeniden denemeler rehberinde. Veri korumanın genel resmi için ZDR kontrol listesine bakın.
Sık yapılan hatalar
- Sunucunun genel çıkış IP’si yerine
10.x.x.xgibi özel adresini listeye eklemek. - Hatalardan kurtulmak için çok geniş bir aralık kullanmak. Bir
/8, 16 milyondan fazla adresi kapsar.