Sağlayıcı kimlik bilgilerini yönetin

Kimlik bilgisi, yukarı akıştaki bir LLM sağlayıcısının API anahtarıdır — CID222'nin OpenAI, Anthropic, Google, Azure OpenAI ya da yerel bir model sunucusunu çağırırken sunduğu anahtar. Çalışan bir kimlik bilgisi olmadan sohbet, AI filtre oluşturucu ve sohbet biçimindeki yardım asistanı çalışmaz.

Neye ihtiyacım var?

Lisans

Any

Rol

admin_user

Ön koşullar

• Sağlayıcıdan alınmış ve kotası olan bir API anahtarınız olmalıdır.
• Cihaz sağlayıcıya erişebilmelidir — ya da ağdan yalıtılmış bir makinede OpenAI uyumlu yerel bir uç nokta çalışıyor olmalıdır.
• Kimlik bilgisinin sahibi olacak hesap ya da kiracı grubu zaten bulunmalıdır.

Screenshot pendingAd, sağlayıcı, maskelenmiş anahtar, sahip, hız sınırı, durum ve sağlık sütunlarını listeleyen Kimlik Bilgileri Yönetimi sayfası/assets/screenshots/credentials@0.4.png

Kimlik bilgisi ekleyin

Bir kimlik bilgisini test edin

CID222 hiçbir zaman kendi zamanlamasıyla bir sağlayıcıyı çağırmaz. Sağlık her zaman ya çalıştırdığınız bir testin ya da gerçek bir isteğin sonucudur.

Bir anahtarı değiştirin

Bir kimlik bilgisini devreden çıkarın

Kaydı yerinde tutarken ağ geçidinin onu seçmesini durdurmak için düzenleme penceresinde Durum alanını Pasif yapın; kaydı tamamen kaldırmak için Menüyü aç → Sil öğesini seçin. Silme, This will permanently delete the credential ve This action cannot be undone. iletileriyle onaylanır.

Ağ geçidi kimlik bilgisini nasıl seçer

Belirli bir hesaptan belirli bir sağlayıcıya giden bir istek için ağ geçidi şu sırayla çözümleme yapar ve ilk eşleşmede durur:

1. O sağlayıcı için, o hesaba ait aktif bir kimlik bilgisi.
2. O sağlayıcı için, hesabın üyesi olduğu herhangi bir kiracı grubuna ait aktif bir kimlik bilgisi.

İkisi de yoksa istek No active credential found for tenant {id} and provider {code} iletisiyle başarısız olur. Pasif bir kimlik bilgisi hiçbir adımda seçilmez ve grup kimlik bilgisine yalnızca üyelik üzerinden erişilir — dolayısıyla birini gruptan çıkarmak, o sağlayıcıya erişimini de kaldırır.

Anahtarlar nasıl saklanır

Sağlayıcı anahtarı, JWT_SECRET değerinden türetilen bir anahtarla AES-256-GCM kullanılarak diskte şifrelenir ve v1: önekli şifreli metin olarak yazılır. API bunu hiçbir zaman döndürmez: liste ve ayrıntı yanıtları yalnızca ilk karakterleri ve son dördü gösteren maskelenmiş bir biçim taşır.

Şifreleme var olmadan önce yazılan kayıtlar olduğu gibi geçer; bu nedenle erken bir sürümden yükseltilmiş bir cihaz hâlâ düz metin bir anahtar tutuyor olabilir. Böyle bir kayıtta anahtarı yeniden kaydetmek onu şifreler.

Alan başvurusu

Liste sütunları

Doğrulama

1. Bağlantıyı test et işleminden sonra Sağlık sütunu Doğrulandı ✓ gösterir.
2. Modeller sayfasını açın. Sağlayıcının modelleri listelenir ve Rota yok uyarısı taşımaz.
3. Kimlik bilgisinin sahibi olan bir hesapla — doğrudan ya da grubu üzerinden — oturum açıp sohbet başlatın. Sağlayıcının modelleri sunulur ve bir mesaj tamamlanır.
4. Kimlik bilgisi değişiklikleri 0.4 sürümünde denetim izine yazılmaz: RESOURCE_CREATED, RESOURCE_UPDATED ya da RESOURCE_DELETED satırı üretilmez. Kayıt olarak listeyi ve sağlık sütununu kullanın.

Başarısız olursa

• Credential must be assigned to either a tenant or a tenant group, but not both — istek iki sahibi birden ya da hiçbirini belirtti. Panoda bu olamaz; betikle yapılan bir çağrıda olabilir.
• Provider with ID {n} not found — sağlayıcı kimliği bu cihazda yok.
• Tenant with ID {id} not found / Tenant group with ID {id} not found — sahip yok ya da kendi kapsamınızın dışında işlem yapan bir admin_user'sınız. Kapsam dışı sahipler, var olmayanlarla birebir aynı biçimde reddedilir; böylece yanıt hangisi olduğunu ele vermez.
• Credential with ID {n} not found — kimlik bilgisi yok ya da sahibi olmadığınız bir birime ait.
• Credential saved but unreachable: {error} / Unreachable: {error} — anahtar saklandı ama sağlayıcı yanıt vermedi. Önce anahtarın kendisini, sonra cihazdan sağlayıcıya dışarı çıkışı, Azure ya da yerel bir model söz konusuysa son olarak uç nokta URL'sini denetleyin.
• Test failed to run — testin kendisi çalıştırılamadı. Sayfayı yeniden yükleyip tekrar deneyin.
• Failed to create credential / Failed to update credential / Failed to delete credential — ağ geçidi yazmayı reddetti; yukarıdaki ilgili ileti buna eşlik eder.
• Only administrators can manage provider credentials. — rolünüz bu sayfayı kullanamaz.
• Modeller sayfasındaki No AI provider is configured yet şeridi — henüz hiç kimlik bilgisi yoktur. Buradan bir tane ekleyin.

Sonraki adımlar

• Modeller — her sağlayıcının artık hangi modelleri sunduğunu ve hangilerinin rotasız olduğunu denetleyin.
• Kiracı grupları — tek bir kimlik bilgisini bir birim genelinde paylaşın.
• Erişim anahtarları — makine istemcilerinin CID222'ye erişmek için kullandığı ağ geçidi anahtarlarını üretin.