AI Ağ Geçidi Sanal Anahtarı (Virtual Key)
Sanal anahtar (Virtual Key), AI Ağ Geçidi'nin ağ geçidi proxy uç noktalarına erişim için verdiği bir kimlik bilgisidir. Uygulamalara ve AI araçlarına sanal anahtarları dağıtırsınız; gerçek sağlayıcı API anahtarları yalnızca ağ geçidi tarafında saklanır. Böylece gerçek anahtarların ortalıkta dolaşması önlenir, her sanal anahtar için ayrı ayrı yetki, hız sınırı, döndürme ve iptal uygulanabilir. Bu makale sanal anahtarların tüm yaşam döngüsü yönetimini anlatır.
Neden sanal anahtar kullanmalısınız?
- Gerçek anahtarları korur — Uygulamalar ve araçlar yalnızca sanal anahtarla muhatap olur; sağlayıcının gerçek anahtarı dışarı sızmaz.
- Kullanıma göre yetki ayrımı — Farklı projeler/araçlar için farklı sanal anahtarlar oluşturup her birinin kullanabileceği modelleri, kanalları ve hızı ayrı ayrı sınırlayabilirsiniz.
- Dilediğiniz an geri alınabilir — Bir anahtar sızarsa veya artık kullanılmayacaksa doğrudan iptal edin ya da döndürün; diğer anahtarlar etkilenmez.
Ön koşullar
- ServBay hesabına giriş yapmış olmalısınız.
- Kanallar sayfasında en az bir kullanılabilir kanal eklemiş olmalısınız.
Sanal anahtar oluşturma
AI Ağ Geçidi → Anahtarlar (Keys) sayfasına gidin ve Oluştur (Create) düğmesine tıklayın:
- Ad — Anahtarın kullanım amacını tanımlamak için (ör.
claude-code,my-app-dev). - Açıklama (isteğe bağlı) — Ek açıklama.
- Son kullanma tarihi — Hiç bitmeyecek şekilde veya belirli bir tarih olarak ayarlanabilir.
- İzin verilen kanallar (isteğe bağlı) — Etiketlerle çoklu seçim yaparak bu anahtarın yalnızca belirtilen kanallara yönlendirilmesini sınırlar; boş bırakılırsa sınırlama olmaz.
- İzin verilen modeller (isteğe bağlı) — Bu anahtarın yalnızca belirtilen modelleri çağırmasını sınırlar; boş bırakılırsa sınırlama olmaz.
- Hız sınırları (isteğe bağlı):
- RPM / TPM — Dakika başına istek / Token üst sınırı.
- RPD / TPD — Gün başına istek / Token üst sınırı.
Düz metin her zaman geri alınabilir
Anahtar başarıyla oluşturulduktan sonra ağ geçidi düz metin anahtarı gösterir (servbay-sk-xxxxxxxx... biçiminde). Ağ geçidi düz metni yerel olarak saklar; daha sonra anahtar ayrıntılarından yeniden alabilirsiniz; yalnızca erken dönemde hash ile oluşturulmuş eski anahtarların kurtarılabilir düz metni yoktur (geri alma isteği 409 döndürür). Anahtarın sızdığından şüpheleniyorsanız doğrudan "Döndür" işlemini kullanın.
Anahtar listesi
Anahtar listesi her sanal anahtar için şunları gösterir:
- Ön ek — Örn.
servbay-sk-abcd..., tanımlama için. - Durum — aktif (active), iptal edildi (revoked), süresi doldu (expired).
- Oluşturulma zamanı / Son kullanım zamanı.
- Yetki etiketleri — izin verilen modeller / kanallar, hız sınırları.
Anahtarları yönetme
Anahtar listesinde her anahtar için aşağıdaki işlemleri yapabilirsiniz:
| İşlem | Açıklama | Etki |
|---|---|---|
| Düzenle (Edit) | Ad, açıklama, izin verilen modeller / kanallar, hız sınırlarını değiştirir | Anında etkili olur; anahtarın kendisi değişmez |
| Döndür (Renew) | Düz metni yeniden oluşturur, eski düz metin anında geçersiz olur, yeni düz metin her zaman alınabilir | Bu anahtarı kullanan tüm uygulama ve araçların güncellenmesi gerekir |
| İptal et (Revoke) | Anahtarı anında devre dışı bırakır ancak denetim kaydını korur | Geri alınamaz; bu anahtarla yapılan istekler reddedilir |
| Sil (Delete) | Anahtarı tamamen siler | Geri alınamaz |
Döndürme vs iptal etme
- Döndürme (Renew): Anahtarın kendisi kalır, yalnızca yeni bir düz metin alır — anahtarın sızdığından şüphelendiğiniz ancak aynı anahtar yapılandırmasını kullanmaya devam etmek istediğiniz durumlar için uygundur; kullanan tarafı da güncellemeyi unutmayın.
- İptal etme (Revoke): Anahtarı kalıcı olarak geçersiz kılar ancak kaydı saklar, denetim için kolaylık sağlar — bir anahtarın artık gerekmediğinden emin olduğunuz durumlar için uygundur. Döndürme ve iptal etme işlemlerinin ikisi de ikinci bir onay gerektirir.
Tek Tıkla Devralma ile ilişkisi
Tek Tıkla Devralma kullanarak bir AI aracını ağ geçidine yönlendirdiğinizde, ağ geçidi otomatik olarak o araca özel bir sanal anahtar oluşturur ve araç yapılandırmasına yazar. Bu otomatik oluşturulan anahtarları anahtarlar sayfasından manuel olarak da yönetebilirsiniz.
Sık Sorulan Sorular (FAQ)
- S: Düz metin anahtarı kopyalamayı unuttum, ne yapmalıyım?
- C: Anahtar ayrıntılarında düz metni geri alabilirsiniz; yalnızca erken dönemde hash ile oluşturulmuş eski anahtarlar geri alınamaz; bu durumda "Döndür" işlemini yapın.
- S: İptal etme ile silme arasındaki fark nedir?
- C: İptal etme anahtar kaydını korur (denetim için), silme ise tamamen kaldırır. İkisi de anahtarı anında geçersiz kılar.
- S: "İzin verilen modeller" sınırlandıktan sonra uygulama başka modeller isteyince ne olur?
- C: Ağ geçidi, bu anahtarın yetkisi dışındaki model isteklerini reddeder. Uygulamanın kullandığı modellerin izin listesinde olduğundan emin olun veya sınırlamayı kaldırın.
- S: Hız sınırı tetiklenirse ne olur?
- C: RPM/TPM/RPD/TPD sınırlarını aşan istekler ağ geçidi tarafından kısıtlanır. Gerçek kullanımı İstatistikler sayfasında izleyip üst sınırları buna göre ayarlayabilirsiniz.
Özet
Sanal anahtarlar, AI yeteneklerini uygulamalara ve araçlara en az yetkiyle ve geri alınabilir biçimde dağıtmanızı sağlar. İzin verilen model / kanal sınırlamaları ve hız sınırlarıyla her kullanım senaryosu için özel kimlik bilgileri oluşturabilir; gerektiğinde gerçek sağlayıcı API anahtarına dokunmadan bunları döndürebilir veya iptal edebilirsiniz.
