AI Ağ Geçidi Sanal Anahtarı (Virtual Key)
Sanal Anahtar (Virtual Key), AI ağ geçidinin verdiği ve ağ geçidi uç noktalarına erişmek için kullanılan bir kimlik bilgisidir. Sanal anahtarı uygulama ve AI araçlarının kullanımı için iletebilir, gerçek tedarikçi API anahtarı ise yalnızca ağ geçidi tarafında saklanır. Böylece gerçek anahtarın çeşitli yerlerde depolanması önlenir; ayrıca her sanal anahtar için ayrı ayrı yetki, hız limiti, döndürme ve iptal ayarlanabilir. Bu dokümanda sanal anahtarların tüm yaşam döngüsü yönetimini bulabilirsiniz.
Neden Sanal Anahtar Kullanmalı?
- Gerçek Anahtarı Koruma — Uygulama ve araçlarda yalnızca sanal anahtar kullanılır, gerçek tedarikçi anahtarı hiçbir yere sızmaz.
- Amaç Bazlı Yetkilendirme — Farklı proje/araçlar için farklı sanal anahtarlar oluşturabilir; her biri için kullanılabilecek modeller, kanallar ve hız limiti belirleyebilirsiniz.
- Anında Geri Çekilebilir — Herhangi bir anahtar sızarsa veya kullanılmazsa, anında iptal edebilir ya da döndürebilirsiniz; bu diğer anahtarları etkilemez.
Ön Koşullar
- ServBay hesabınıza giriş yaptınız.
- Kanal Yönetimi sayfasında en az bir kullanılabilir kanal eklediniz.
Sanal Anahtar Oluşturma
AI Ağ Geçidi → Anahtarlar (Keys) sayfasına girin ve Oluştur (Create) butonuna tıklayın:
- Ad — Bu anahtarın kullanım amacını tanımlamak için (ör:
claude-code,my-app-dev). - Açıklama (Opsiyonel) — Ek bilgi ekleyebilirsiniz.
- Sona Erme Tarihi — Süresiz veya belirli bir son kullanım tarihi seçilebilir.
- İzin Verilen Kanallar (Opsiyonel) — Etiket seçimiyle anahtarın yönlendireceği kanalları sınırlayabilirsiniz; boş bırakılırsa sınır yoktur.
- İzin Verilen Modeller (Opsiyonel) — Anahtarın yalnızca belirli modelleri çağırmasına izin verirsiniz; boş bırakılırsa sınır yoktur.
- Hız Limiti (Opsiyonel):
- RPM / TPM — Dakikadaki maksimum istek/token miktarı.
- RPD / TPD — Günlük maksimum istek/token miktarı.
Sadece bir kez açıkça gösterilir
Anahtar başarıyla oluşturulduktan sonra, ağ geçidi yalnızca bir kez tam anahtarı gösterecektir (örneğin servbay-sk-xxxxxxxx...). Hemen kopyalayıp saklayın. Bu pencere kapandıktan sonra, sistem sadece tanımlama için ön ek tutacak ve yineleme olmayacaktır. Kaybolursa, yalnızca "anahtarı döndür" işlemiyle yeni bir anahtar oluşturabilirsiniz.
Anahtar Listesi
Anahtar listesinde her bir sanal anahtarın şu bilgileri yer alır:
- Ön Ek — Örneğin
servbay-sk-abcd..., tanımlama içindir. - Durum — Aktif (active), İptal Edildi (revoked), Süresi Doldu (expired).
- Oluşturma / Son Kullanım Tarihi.
- Yetki Etiketleri — İzin verilen modeller/kanallar, hız limiti.
Anahtar Yönetimi
Anahtar listesinde her anahtar için şu işlemler yapılabilir:
| İşlem | Açıklama | Sonuç |
|---|---|---|
| Düzenle (Edit) | Adı, açıklamayı, izin verilen modeli/kanalı ve hız limitini değiştirin | Anında etkili olur, anahtar değişmez |
| Döndür (Renew) | Yeni anahtar oluşturulur; eski anahtar hemen geçersiz olur, yeni anahtar yalnızca bir kez gösterilir | Anahtarı kullanan tüm uygulama ve araçlarda güncelleme yapılmalı |
| İptal Et (Revoke) | Anahtarı anında devre dışı bırakır, denetim kaydı tutulur | Geri alınamaz; bu anahtarı kullanan istekler reddedilir |
| Sil (Delete) | Anahtarı kalıcı olarak siler | Geri alınamaz |
Döndürme ile İptal Etme arasındaki fark
- Döndür (Renew): Anahtarın kaydı kalır, yalnızca düz metin değiştirilir—şüpheli sızıntı durumlarında, aynı yapılandırma ile devam etmek için uygundur; lütfen tüm kullanan uygulamalarda yeni anahtarı güncelleyin.
- İptal Et (Revoke): Anahtarı kalıcı olarak geçersiz kılar, kayıt denetim için saklanır—bir anahtar artık kullanılmayacaksa idealdir. Her iki işlem için de ikinci bir onay istenir.
Tek Tıkla Yönlendirme ile İlişkisi
Bir AI aracını Tek Tıkla Yönlendirme ile ağ geçidine yönlendirdiğinizde, sistem otomatık olarak o araca özel bir sanal anahtar oluşturur ve araca iletir. Anahtarlar sayfasından bu otomatik oluşturulan anahtarları da manuel olarak yönetebilirsiniz.
Sıkça Sorulan Sorular (SSS)
- S: Anahtarın düz metin halini kopyalamayı unuttum, ne yapmalıyım?
- C: Düz metin yeniden görüntülenemez; ilgili anahtarı "döndür" işlemiyle yeni anahtarı oluşturup, uygulamanızda onu kullanın.
- S: İptal ve silme işlemleri arasında ne fark var?
- C: İptal, kayıtları korur (denetim için), silme ise tamamen kaldırır. Her ikisi de anahtarı anında geçersiz kılar.
- S: "İzin verilen model" ile sınır koyarsam, uygulama başka modele istek atarsa ne olur?
- C: Ağ geçidi, izin dışındaki modellere yapılan istekleri reddeder. Uygulamanın kullandığı modellerin izin listesinde olduğundan emin olun, veya sınırı kaldırın.
- S: Hız limiti aşılırsa ne olur?
- C: RPM/TPM/RPD/TPD sınırını aşan istekler, ağ geçidi tarafından engellenir. İstatistikler sayfasından kullanım bilgilerini takip ederek limitlerinizi güncelleyebilirsiniz.
Sonuç
Sanal anahtarlar sayesinde, gerçek tedarikçi API Key’inize dokunmadan, uygulama ve araçlara en az yetkiyle, geri alınabilir bir şekilde AI erişimi sağlayabilirsiniz. Model/kanal sınırı ve hız limitiyle her kullanım senaryosu için özelleştirilmiş kimlik bilgisi oluşturup, gerektiğinde anında döndürebilir veya iptal edebilirsiniz.
