Skip to main content
Production ortamında IP whitelist kullanmanızı şiddetle öneririz. Whitelist, anahtarınız sızsa bile sınırlanmış IP’ler dışından kullanılmasını engeller.

​
Nasıl çalışır?

API anahtarı oluştururken veya düzenlerken bir IP listesi tanımlarsınız. Whitelist boş bırakılırsa tüm IP’lerden erişim açıktır. Whitelist dışı bir IP’den istek gelirse 403 Forbidden ve ip_not_allowed koduyla reddedilir (RFC 9457 problem+json).

​
Desteklenen formatlar

​
Yapılandırma

1

Konsola gidin

Konsol → Ayarlar → API Anahtarları sayfasını açın.
2

Anahtarı düzenleyin

Sınırlamak istediğiniz anahtarın yanındaki Düzenle butonuna tıklayın.
3

IP'leri ekleyin

Sunucu IP’lerinizi tek tek veya CIDR formatında ekleyin. Aynı satırda virgülle ayırabilirsiniz.
4

Kaydedin

Değişiklik anında etkilidir.

​
Sunucunuzun IP’sini öğrenmek

NAT/Load Balancer arkasındaysanız, çıkış IP’leriniz bunlardır — uygulama sunucularınız değil. Cloud sağlayıcı NAT Gateway veya statik IP kullanın.

​
Webhook tarafı

Payven’in size gönderdiği webhook istekleri sabit IP havuzlarından çıkar. Güncel havuz listesini almak için destek ekibimize ulaşın — değişikliklerde önceden e-posta ile bildirilir.
Önerilen yaklaşım: Webhook tarafında birincil güvenlik mekanizması imza doğrulamadır, IP filtresi değildir. HMAC-SHA256 imza doğrulama kurun; IP filtresi yalnızca isteğe bağlı ek katman olarak değerlendirin.

​
Sık karşılaşılan sorunlar

Cloud ortamlarda çıkış IP’si dinamik olabilir (örn. AWS NAT Gateway elastic IP’siz). Statik bir IP atayıp tekrar deneyin.
Evet — geliştirme aşamasında sandbox anahtarınız için listeyi boş bırakabilirsiniz. Production’da ise mutlaka tanımlayın.
Evet. CIDR notasyonu da geçerlidir.