Yeni: Yapay zekâ güvenlik duvarı tüm platformu izliyor ve her olayı sade bir dille açıklıyor. Nasıl çalıştığını görün

API anahtarı sertleştirme

Her entegrasyona yalnızca ihtiyaç duyduğu izinleri, bir ağı, bir son kullanma tarihini ve bir sahibi olan bir anahtar verin; anahtarları nasıl yenileyeceğinizi, iptal edeceğinizi ve izleyeceğinizi öğrenin.

Bir API anahtarı, bir program için paroladır. Anahtarı olan herkes, anahtarın izin verdiği her işi, anahtarın kabul edildiği her yerden, süresi dolana kadar yapabilir. Bu sayfa, sızan bir anahtarın verebileceği zararı küçük tutmanın yollarını gösterir. Anahtar oluşturma ve API çağırma Kimlik Doğrulama bölümünde açıklanmıştır.

Anahtarlar, menünün Developer bölümündeki API Keys ekranında yönetilir (Admin; yenileme için Owner rolü gerekir).

Bir anahtarın asla yapamayacağı şeyler

Bu sınırlar, hangi seçeneği işaretlediğinizden bağımsız olarak her anahtar için geçerlidir:

  • Bir anahtar, onu oluşturan üyenin şu anda yapabileceklerinin ötesine asla geçemez: “Sahibinin şu anda yapabileceklerinin ötesine asla geçmez.” Üye bir izni kaybederse, anahtar da o izni kaybeder.
  • Bir anahtar asla yalnızca sahibine ait izinlere ve kimlik ile erişim modüllerinin (oturum açma, hesaplar, API anahtarları) izinlerine sahip olmaz. Bu nedenle bir anahtar, anahtar oluşturamaz ya da yenileyemez, üyeleri değiştiremez.
  • Bir anahtarın izni, kuruluşunuz için ilgili modül açık olduğu sürece çalışır.
  • Bir anahtar taşıyan istek yalnızca o anahtar olarak değerlendirilir; aynı istekteki tarayıcı çerezi yok sayılır.

1. Yalnızca gerekli izinleri verin

New API Key ekranında, Module permissions bölümünden modülleri birer birer seçin. Her modül bir Read only hazır ayarı sunar. Tipik entegrasyonlar:

Entegrasyonİzinler
Cihazları ve geçmişi okuyan bir raporlama aracıCihazlarda ve telemetride Read only
Cihazlara limit yazan bir ERPCihazları okuma, öznitelikleri yazma
Alarmları onaylayan bir talep sistemiAlarmları okuma, onaylama

Her şey için tek bir anahtar kullanmaktan kaçının. Entegrasyon başına bir anahtar, bir sızıntının neyi açığa çıkaracağını netleştirir ve diğerlerini durdurmadan tek bir entegrasyonun erişimini iptal etmenizi sağlar.

Entegrasyon kapsamları (Read, Write, Admin, SCIM Read, SCIM Write), SCIM sağlama gibi kendi sözleşmesi olan makine uç noktaları içindir. “Yukarıdaki modül izinleri, çoğu entegrasyonun ihtiyacı olanlardır.”

2. Anahtarı ağlara sabitleyin

IP allowlist (optional): “Her satıra bir alt ağ, ör. 10.0.0.0/8 veya 203.0.113.7/32.” Bunların dışındaki yerlerden gelen çağrılar, bilinmeyen bir anahtarla aynı yanıtla reddedilir; böylece saldırgan hiçbir şey öğrenemez.

Kuruluşunuz, kendi listesi olmayan anahtarlar için varsayılan bir ayar belirleyebilir: API Key Settings > Tenant Subnet Allowlist.

3. Süresinin dolmasına izin verin

Her anahtarın bir son kullanma süresi vardır: varsayılan 90 gün, en fazla 365 gün (“Varsayılan 90 gün, en fazla bir yıl.”). API Key Settings ekranında:

AyarVarsayılanKullanım
Maximum Key Lifetime (days)0 (365 günlük üst sınır)Daha kısa ömür zorunlu kılmak için düşürün. Varsayılanı da düşürür.
Require Expiry on Every KeyKapalıAnahtar oluşturan API çağrıları bir son kullanma tarihi belirtmek zorundadır.
Max Active Keys0 (sınırsız)Aynı anda etkin olabilecek anahtar sayısını sınırlar.
Per-Key Rate Limit (requests/minute)0 (platform varsayılanı: dakikada 1.000)Her anahtarın varsayılan istek sınırı. Ekran 0’ı sınırsız olarak gösterir; platform dakikada 1.000 uygular.

4. Anahtarın sahibini belirleyin

Anahtarı oluşturan üye kuruluştan ayrıldığında, anahtar Service key olarak işaretlenmedikçe (“Evet: oluşturanından sonra da çalışır”) çalışmayı durdurur. Üretim entegrasyonlarının anahtarlarını servis anahtarı olarak işaretleyin ve her birinden kimin sorumlu olduğunu not edin.

5. Düzenli olarak yenileyin

Rotate key, bir halef oluşturur: “Bu anahtarın kapsamlarını ve ortamını devralan bir halef anahtar üretir. Geçiş süresi boyunca her iki anahtar da çalışmaya devam eder; böylece kesinti olmadan geçiş yapabilirsiniz.” Grace window (days) değerini belirleyin; 0 eski anahtarı hemen iptal eder. Rotation history kartı, önceki ve sonraki anahtarları birbirine bağlar.

  1. Anahtarı yenileyin ve yeni gizli anahtarı kopyalayın (“Anahtar yenilendi. Yeni gizli anahtarı şimdi kopyalayın.”).
  2. Yeni anahtarı entegrasyona ekleyin.
  3. Eski anahtarda Last used ve Last used IP alanlarının değişmeyi bıraktığını kontrol edin.
  4. Geçiş süresinin dolmasını bekleyin ya da eski anahtarı iptal edin.

6. Şüphe varsa hemen iptal edin

  • Revoke Key: “Bu anahtarı kullanan tüm entegrasyonlar hemen çalışmayı durdurur. Bu işlem geri alınamaz.”
  • Deactivate, geri istemeyi düşünebileceğiniz bir anahtarı durdurur; Activate ise onu yeniden başlatır.
  • Bir olay anında bir sahip, birkaç ya da tüm anahtarları birlikte iptal edebilir.

7. Anahtarları izleyin

SinyalKonum
Last used, Last used IP, Total verificationsAnahtarın sayfası
Uzun süre kullanılmayan bir anahtarın aniden yeni bir adresten kullanılmasıBir denetim olayı (api_key.anomaly.detected)
Başarısız doğrulamalarDenetim olayları (api_key.verify.failed)
Oluşturma, yenileme, silme, izin değişiklikleriDenetim günlüğü (api_key.created, api_key.rotated, api_key.deleted)
Kötüye kullanımAI firewall, anahtarlarla ilgili olayları kaydeder ve bir anahtarı kısıtlayabilir veya iptal edebilir. Bkz. The AI firewall.

Anahtar listesi, modül bazlı izinlerden önce oluşturulmuş eski anahtarlar için bir uyarı da gösterir: her birini açın ve yalnızca ihtiyaç duyduğu modül izinlerini verin.

Anahtarları saklama

  • Anahtarları entegrasyonunuzun gizli bilgi deposunda tutun; asla kaynak kodda, URL’lerde ya da taleplerde tutmayın.
  • Test sistemleri için test anahtarlarını kullanın; böylece üretim anahtarlarıyla karıştırılmazlar.
  • Bir anahtar sızdıysa, önce onu iptal edin, sonra denetim günlüğünden nerelerden kullanıldığını bulun.