Temel · 9 dk okuma

IP Whitelist Nedir? API ve Sunucu Erişiminde IP İzni

21 Ekim 2026

IP Whitelist Nedir? API ve Sunucu Erişiminde IP İzni

IP whitelist, bir sisteme yalnız önceden bildirilmiş IP adreslerinden gelen bağlantılara izin veren erişim listesidir; listede olmayan her adres daha ilk pakette reddedilir. Bankaların ödeme API’leri, sunucu yönetim panelleri, veritabanı güvenlik duvarları ve proxy sağlayıcılarının kimlik doğrulama ekranları bu yöntemi kullanır. Yöntemin tek şartı, bağlanan tarafın adresinin sabit olmasıdır. Ev ve ofis bağlantılarının adresi değiştiği için whitelist işi çoğu zaman sabit bir IPv4 proxy adresiyle çözülür: ekip proxy üzerinden çıkar, listeye yalnız o adres yazılır.

Whitelist ile blacklist arasındaki fark

İki liste de IP adresine bakarak karar verir, ama varsayılanları terstir. Blacklist (kara liste) herkese açıktır ve yalnız listedeki adresleri engeller; bir adres daha önce sorun çıkarmadıysa geçer. Whitelist (beyaz liste, izin listesi) herkese kapalıdır ve yalnız listedeki adresleri geçirir; tanımadığı adresi, o adres hiç sorun çıkarmamış olsa bile reddeder. Bu yüzden whitelist, kimlerin bağlanacağını önceden bildiğiniz sistemlerde kullanılır: ekibin kullandığı API anahtarı, şirketin yönetim paneli, yalnız uygulama sunucusunun ulaşması gereken veritabanı.

Kara liste tarafı ayrı bir konudur ve herkese açık DNS listeleriyle sorgulanır; bu sitedeki kara liste kontrolü rehberi o tarafı anlatıyor. Whitelist’te ise herkese açık bir liste yoktur; listeyi sistemi işleten taraf tutar ve siz adresinizi ona bildirirsiniz. Sorun çıkaran adresi listeden çıkarmak da aynı tarafın elindedir.

Pratikte iki liste birlikte çalışır. Bir sunucu önce whitelist’e bakar, adres listedeyse bağlantıyı kabul eder, sonra uygulama katmanında şifre ya da anahtar ister. Whitelist kapıdaki ilk kontroldür; kapıdan geçenin kim olduğunu ayrıca doğrulamak gerekir.

IP whitelist nerede kullanılır: dört yaygın yer

Birincisi API erişimidir. Ödeme, kargo, SMS ve pazar yeri API’lerinin çoğu, anahtarın hangi adreslerden kullanılabileceğini sorar. Anahtar sızsa bile listede olmayan bir adresten çalışmaz; sağlayıcılar bu nedenle whitelist’i zorunlu tutar. Aynı anahtarı kullanan üç geliştirici üç ayrı ev adresinden bağlanıyorsa üç adres yazılır ve her adres değiştiğinde liste güncellenir.

İkincisi sunucu yönetimidir. SSH portu, RDP, yönetim panelleri ve veritabanı portları internetin tamamına açık kalmamalıdır. Güvenlik duvarı kuralı yalnız ofisin ya da ekibin adresinden gelen bağlantıyı geçirir; kalan her deneme sessizce düşer. Bu kural tek başına, parola deneme saldırılarının büyük kısmını daha bağlantı kurulmadan bitirir.

Üçüncüsü iş ortağı ve müşteri entegrasyonlarıdır. İki şirket arasındaki veri aktarımında her taraf diğerinin çıkış adresini kendi listesine yazar. Taraflardan birinin adresi değiştiğinde aktarım durur ve genellikle günlerce neden anlaşılmaz; adresin sabit olması burada operasyonel bir gerekliliktir.

Dördüncüsü proxy sağlayıcı panelidir. Proxy kullanırken kimliğinizi iki yoldan kanıtlarsınız: her bağlantıda kullanıcı adı ve şifre göndererek ya da kendi çıkış adresinizi panele bildirerek. İkinci yöntem whitelist’in ta kendisidir; proxy, listedeki adresten gelen bağlantıyı şifre sormadan kabul eder. Bu düzen, şifre kabul etmeyen yazılımlarda ve adresi sabit olan sunucularda tercih edilir.

Bir whitelist kuralı nasıl yazılır: tek adres, blok, süre

En basit kural tek bir IPv4 adresidir: 203.0.113.10. Çoğu sistem bunu 203.0.113.10/32 olarak kaydeder; sondaki /32, kuralın yalnız bu adresi kapsadığını söyler. Birden fazla ardışık adresi tek kuralla yazmak için CIDR gösterimi kullanılır: 203.0.113.0/24, 203.0.113.0 ile 203.0.113.255 arasındaki 256 adresi kapsar; /29 sekiz adres, /30 dört adres demektir. Blok ne kadar genişse izin o kadar gevşer; ofisin tek çıkış adresi için /32 yeterlidir, /24 yazmak aynı bloktaki 255 yabancı adrese de kapıyı açar.

Bazı sistemler kurala süre ekler: geçici bir destek erişimi için 24 saatlik kayıt, sonra otomatik silme. Bazıları açıklama alanı ister; bu alanı boş bırakmayın, altı ay sonra listedeki on adresin hangisinin kime ait olduğunu hatırlamak mümkün olmaz. Kuralı yazan kişi, tarih ve amaç tek satırda yeter.

Adres biçimini girmeden önce proxy formatları rehberindeki gösterimleri hatırlamak işe yarar: whitelist’e yalnız adres yazılır, port ya da kullanıcı adı yazılmaz. 203.0.113.10:8080 biçiminde bir giriş çoğu panelde hata verir ya da sessizce yok sayılır.

  • Tek adres: 203.0.113.10 ya da 203.0.113.10/32 (aynı anlam)
  • Sekiz adreslik blok: 203.0.113.8/29 → 203.0.113.8 ile .15 arası
  • Tam C sınıfı blok: 203.0.113.0/24 → 256 adres; yalnız gerçekten o bloğun tamamı sizinse yazın
  • Port, kullanıcı adı ve şifre whitelist kuralına girmez
  • Her kurala açıklama ve tarih ekleyin; süresi dolan kuralı silin

Whitelist için neden sabit IPv4 proxy gerekir?

Ev ve küçük ofis bağlantılarının adresi sabit değildir. Modem yeniden başladığında, sağlayıcı bakım yaptığında ya da belirli aralıklarla adres yenilenir. Bazı sağlayıcılar CGNAT kullanır: binlerce abone tek bir genel adresin arkasından çıkar ve o adres de zamanla değişir. Whitelist’e bugünkü ev adresinizi yazarsanız yarın API anahtarınız çalışmaz ve ilk şüphe anahtara, kodunuza ya da karşı tarafa gider; gerçek neden adres değişikliğidir.

Sabit IPv4 proxy bu sorunu kesin biçimde çözer. Size ayrılmış sabit bir adres alırsınız, bağlantıları o proxy üzerinden kurarsınız ve whitelist’e yalnız proxy’nin adresi yazılır. Evden, ofisten ya da kafeden bağlanmanız fark etmez; karşı taraf her zaman aynı adresi görür. Beş kişilik bir ekip aynı proxy’den çıkıyorsa listede beş adres yerine bir adres durur ve kimse işe girip çıktıkça listeyi güncellemek gerekmez.

Rotating proxy bu iş için uygun değildir. Rotating pakette her istek ya da her oturum havuzdan farklı bir adresle çıkar; whitelist’e yazılacak sabit bir adres yoktur ve havuzun tamamını yazmak hem mümkün değildir hem de izin kapsamını anlamsız genişletir. Whitelist işi her zaman static paketlerle yapılır. Static paketlerin datacenter ve residential türleri bu site üzerinden karşılaştırılabilir; API ve sunucu erişimi için datacenter adresi yeterli ve ekonomiktir, karşı taraf ev bağlantısı adresi bekliyorsa residential seçilir.

Adım adım: sabit proxy adresini whitelist’e eklemek

Sıra API, sunucu güvenlik duvarı ve iş ortağı entegrasyonlarında aynıdır; her adımın sonunda tek bir kontrol vardır ve kontrol geçmeden sonraki adıma geçilmez.

  • 1. Çıkış adresini doğrulayın: Proxy açıkken bir IP gösterme servisine bağlanın ve dönen adresin proxy panelinde yazan adresle aynı olduğunu görün. Farklıysa trafik proxy’den çıkmıyordur.
  • 2. Adresi karşı tarafa bildirin: API panelinde ilgili anahtarın IP kısıtlama alanına, sunucuda güvenlik duvarı kuralına ya da iş ortağına e-postayla. Yalnız adres, /32 ile; port yok.
  • 3. Kuralın etkinleşmesini bekleyin: Bazı sağlayıcılar değişikliği birkaç dakika içinde uygular, bazıları önbellek yüzünden daha uzun sürer. Hemen test edip hata görmek kuralın yanlış olduğu anlamına gelmez.
  • 4. Proxy üzerinden test edin: Aynı isteği önce proxy ile, sonra proxy’siz gönderin. Proxy ile başarılı, proxy’siz reddedilmiş olmalı. İkisi de başarılıysa whitelist etkin değildir; ikisi de reddediliyorsa adres yanlış girilmiştir.
  • 5. Kaydedin: Hangi adres, hangi sistem, hangi tarih, kim ekledi. Adres ya da ekip değiştiğinde bu satır, nereleri güncelleyeceğinizi söyler.

Proxy panelinde IP izni: şifre yerine kendi adresinizi bildirmek

Whitelist’in ters yönü de vardır: bu kez listeyi tutan taraf proxy sağlayıcısıdır ve listeye yazılan adres sizin kendi çıkış adresinizdir. Panelde adresinizi kaydettiğinizde proxy, o adresten gelen bağlantıları kullanıcı adı ve şifre istemeden kabul eder. Şifre alanı olmayan eski yazılımlar, tarayıcı eklentisi kullanamayan sistemler ve her bağlantıda kimlik bilgisi göndermek istemeyen sunucu uygulamaları için tek yol budur.

Bu düzenin şartı, bir önceki bölümle aynıdır: kendi adresiniz sabit olmalıdır. Proxy’ye bir sunucudan bağlanıyorsanız sunucunun adresi zaten sabittir ve IP izni doğal seçimdir. Ev bağlantısından bağlanıyorsanız adresiniz değiştiğinde proxy sizi tanımaz ve bağlantı kimlik doğrulama hatasıyla reddedilir. Bu durumda ya her değişiklikte paneli güncellersiniz ya da kullanıcı adı ve şifre yöntemine dönersiniz; ikisi aynı anda açık olabiliyorsa şifre yedek olarak kalır.

IP izniyle çalışan bir proxy’de bağlantı birden kesildiyse ilk bakılacak yer ev adresinizdir: bir IP gösterme servisine proxy’siz bağlanın, panelde kayıtlı adresle karşılaştırın. Farklıysa neden bulunmuştur. Bu ve benzeri durumların tam listesi bağlantı hataları rehberinde kod kod ayrılmış durumda.

Sık hatalar: whitelist var ama bağlantı reddediliyor

Whitelist sorunlarının neredeyse tamamı aynı soruya çıkar: karşı taraf gerçekten hangi adresi görüyor? En sık görülen altı durum bu soruya altı farklı cevap verir.

  • IPv6 öncelikli çıkış → Bilgisayarınız IPv6 destekliyorsa bazı hedeflere IPv6 ile bağlanır ve whitelist’teki IPv4 adresi hiç görülmez; isteği açıkça IPv4 üzerinden gönderin ya da hedefin IPv4 adresini kullanın.
  • Proxy’siz giden istek → Uygulama proxy ayarını okumuyor ve kendi adresinizden çıkıyor; IP gösterme servisiyle çıkış adresini doğrulayın.
  • CGNAT arkasındaki ev adresi → Whitelist’e yazdığınız adres bir saat sonra başkasına geçmiş olabilir; sabit proxy adresi kullanın.
  • Yanlış CIDR → /24 yerine /32 yazılmalıyken tersi ya da blok başlangıcı yanlış hesaplanmış; kuralı tek adres olarak yeniden girin.
  • Kural sırası → Güvenlik duvarında genel bir engelleme kuralı whitelist kuralının üstünde duruyor; izin kuralını öne alın.
  • Önbellek ve yayılma süresi → Kural kaydedildi ama karşı taraf henüz uygulamadı; birkaç dakika bekleyip tekrar deneyin, hemen kuralı değiştirmeyin.

Güvenlik sınırı: whitelist tek başına yeterli mi?

TCP bağlantısında kaynak adresi taklit etmek pratikte mümkün değildir; üç yönlü el sıkışma gerçek adrese dönen paketle tamamlanır. Bu yüzden whitelist güçlü bir ilk katmandır. Sınırı başka yerdedir: adres paylaşımlıysa, aynı adresin arkasındaki herkes listeden geçer. Ofis adresi whitelist’teyse ofisteki her cihaz, paylaşımlı bir proxy adresi whitelist’teyse o proxy’yi kullanan herkes kapıdan girer.

Whitelist’e yazılan adres bu nedenle size ayrılmış olmalıdır ve kapıdan sonra ikinci bir doğrulama durmalıdır: API anahtarı, SSH anahtarı ya da panel şifresi. Whitelist kimin bağlanabileceğini, ikinci katman bağlananın kim olduğunu söyler. İkisi birlikte, sızan bir anahtarı listede olmayan adreslerden kullanılamaz, listedeki adresi de anahtarsız işe yaramaz hale getirir.

Listeyi küçük tutmak da bu katmanın parçasıdır. Ayrılan çalışanın ev adresi, biten projenin sunucusu ve denenip vazgeçilen proxy listede kaldıkça güvenlik azalır. Üç ayda bir listeyi baştan okuyup açıklaması olmayan ya da amacı bitmiş her kuralı silmek, whitelist’in asıl işini yapmasını sağlar.

Sonuç

IP whitelist, yalnız bildirilmiş adreslerden bağlantı kabul eden bir erişim listesidir ve işe yaraması için bağlanan adresin sabit olması gerekir. Ev ve ofis adresleri değiştiğinden, API ve sunucu erişiminde size ayrılmış sabit bir IPv4 proxy adresi kullanılır; ekip o adresten çıkar, liste tek satır kalır. Kuralı /32 ile tek adres olarak yazın, proxy’li ve proxy’siz testle doğrulayın, her kaydı tarihleyin ve kapıdan sonra ikinci bir doğrulama katmanı bırakın. Static IPv4 paketleri ürün sayfalarında adres türüyle birlikte listelenir.

İlgili içerikler

İlgili IPv4 ürünler

Başlayın

İhtiyacınıza uygun proxy paketini seçin

Proxy ürünlerini ve paket özelliklerini karşılaştırın. Hangi ürünün uygun olduğundan emin değilseniz ekibimizle iletişime geçin.