Genel bakış
IP izin listesi, OpenAI API'nize erişebilecek IP adreslerini kısıtlamanızı sağlayan, isteğe bağlı bir güvenlik özelliğidir.
Etkinleştirildiğinde yalnızca yapılandırılan IP adreslerinden veya IP aralıklarından gelen isteklere izin verilir. Diğer tüm IP adreslerinden gelen istekler, geçerli bir API anahtarı içerseler bile reddedilir.
Bu özellik, erişimi güvenilir ağ ortamlarıyla sınırlayarak yetkisiz API kullanımı riskini azaltmaya yardımcı olmayı amaçlar.
Not: IP izin listesi yalnızca API istekleri için geçerlidir. platform.openai.com adresine erişimi veya kullanıcıların oturum açmasını etkilemez.
Neden IP izin listesi kullanılmalı?
IP izin listesi şunları yapmanıza yardımcı olabilir:
API erişimini bilinen altyapıyla (örneğin sunucularınız veya bulut ortamlarınız) sınırlamak
API anahtarı sızıntısı durumunda riski azaltmak
API trafiğinin geldiği kaynaklar üzerinde ek bir kontrol katmanı oluşturmak
IP izin listesi en yaygın olarak, API trafiğinin sabit veya açıkça tanımlanmış ağ aralıklarından geldiği üretim ortamlarında kullanılır.
Nasıl çalışır?
İzin verilen IP adreslerinden veya CIDR aralıklarından oluşan bir liste yapılandırırsınız.
İzin verilen IP adreslerinden gelen istekler kabul edilir.
İzin listesinde bulunmayan IP adreslerinden gelen istekler reddedilir.
IP izin listesi şu düzeylerde uygulanabilir:
Kuruluş düzeyi veya
Proje düzeyi
Kullanılabilirlik
IP izin listesi tüm API müşterileri tarafından kullanılabilir.
IP izin listesini yapılandırmak için aşağıdaki adımları izleyin.
IP izin listesini yapılandırma
Not: En fazla 50 IP adresi veya CIDR aralığı ekleyebilirsiniz.
Ayarlar bölümünü açın.
Güvenlik seçeneğini seçin.
IP izin listesi seçeneğini seçin.
Bir veya daha fazla IP adresi ya da CIDR aralığı ekleyin.
(İsteğe bağlı) Bir IP adresinin izin listenizde bulunup bulunmadığını doğrulamak için Kontrol et aracını kullanın.
İzin listesini şu kapsamda etkinleştirin:
Belirli bir proje veya
Kuruluşunuzun tamamı.
Kullanmayı planladığınız ortamlardan istek göndererek test edin.
İzin listesini kuruluş genelinde zorunlu kılmadan önce tek bir projeyle başlamanızı öneririz.
Yapılan değişikliklerin geçerli olması 15 dakikayı bulabilir.
Not: IP izin listesi ayarlarını yapılandırmak için kuruluşta gerekli izinlere sahip olmalısınız.
Sorun giderme
İstekleriniz beklenmedik şekilde başarısız olursa:
İsteğin izin verilen bir IP adresinden geldiğini doğrulayın.
Altyapınızın IP adreslerinin değişip değişmediğini kontrol edin.
Yapılandırdığınız IP aralıklarının doğruluğunu kontrol edin.
Yapılandırma değişikliklerinin tüm sistemde geçerli olması için 15 dakikaya kadar bekleyin.
Bir IP adresine izin verilip verilmediğini doğrulamak için Kontrol et aracını kullanın.
Bir istek engellendiğinde ne olur?
İzin listesinde bulunmayan bir IP adresinden gelen istekler şu hatayla başarısız olur:
HTTP durumu: 401 Unauthorized
Hata kodu: ip_not_authorized
Örnek yanıt:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Sık sorulan sorular
IP izin listesi, API anahtarımın tüm yetkisiz kullanımlarını engeller mi?
Hayır. IP izin listesi, API isteklerinin geldiği kaynakları kısıtlayarak riski azaltmaya yardımcı olabilir ancak her türlü kötüye kullanımı tamamen engellemez. Anahtarları güvenli bir şekilde saklama, düzenli olarak yenileme ve güçlü hesap güvenliği sağlama gibi diğer güvenlik uygulamalarıyla birlikte kullanılmalıdır. Ek güvenlik önlemleri için yardım merkezimizdeki API anahtarı güvenliği için en iyi uygulamalar ve Yetkisiz kullanımı önleme kılavuzlarını inceleyin.
IP izin listesi gecikme süresini etkiler mi?
IP izin listesi, bazı durumlarda, genellikle ilk isteklerde çok düşük bir ek gecikmeye neden olabilir. Genel API performansını önemli ölçüde etkilemesi beklenmez.
Bir isteğin IP izin listesi nedeniyle başarısız olduğunu nasıl anlarım?
IP izin listesi nedeniyle başarısız olan istekler şu yanıtı döndürür:
HTTP status: 401 UnauthorizedError code: ip_not_authorized