BroadRouter
Başlayın

IP izin listesi (IP allow list)

Güncellendi

IP izin listesi, yalnızca listelenen IP adreslerinden veya CIDR aralıklarından gelen istekleri kabul edip diğer tümünü reddeden bir güvenlik denetimidir. Bir API'de sızdırılmış bir anahtarın vereceği zararı sınırlar, çünkü anahtar listede olmayan ağlardan çalışmaz.

Diğer adları: IP izin listesi, IP beyaz listesi, izin verilen IP'ler, IP kısıtlaması, IP whitelist, IP allow list, IP allowlist, allowed IPs, IP restriction, allowed_ips

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.x gibi özel adresini listeye eklemek.
  • Hatalardan kurtulmak için çok geniş bir aralık kullanmak. Bir /8, 16 milyondan fazla adresi kapsar.

Sık sorulan sorular

Bir API anahtarını korumak için IP izin listesi yeterli mi?

Hayır. Yalnızca bir katmandır. Anahtarları yine sunucularda, kodun ve logların dışında tutun, her uygulamaya ayrı anahtar verin ve sızdıklarında hemen iptal edin.

Sunucularım serverless veya otomatik ölçeklenen bir altyapıda çalışıyor. İzin listesi kullanabilir miyim?

Yalnızca giden trafik bilinen adreslerden çıkıyorsa. Trafiği sabit IP'li bir NAT ağ geçidi veya çıkış proxy'si üzerinden yönlendirin, sonra bu adresleri listeye ekleyin.

Listede olmayan bir IP'den hangi hatayı alırım?

BroadNet Inference'ta 403. Diğer API'ler de genellikle 403 döndürür.

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