Keycloak

Açıklama

Keycloak için Gateclave entegrasyonu. Keycloak Admin REST API üzerinden müşterinin kendi Keycloak sunucusundaki tek bir realm'i yönetir; realm, bağlayıcının kiracı alanıdır. **Neler yapılabilir** - Kullanıcıları listeleme, arama (ad, e-posta, öznitelik, bağlı kimlik sağlayıcı), sayma ve ayrıntı okuma; verilen onaylar, bağlı dış kimlikler, kullanıcı profili yapılandırması - Kullanıcının grupları ile doğrudan ve etkin (gruptan/bileşik rolden gelen dahil) realm ve client rolleri - Kullanıcı, client ve çevrimdışı oturumlar, oturum sayıları ve client bazında istatistik - Grup hiyerarşisi, alt gruplar, üyeler ve grup rolleri - Realm ve client rolleri (client rolleri salt okuma), rolü taşıyan kullanıcı ve gruplar, bileşik rol içeriği - Client'lar, servis hesapları, client scope'lar ve protokol eşleyicileri; kimlik sağlayıcılar ve eşleyicileri; LDAP/AD/Kerberos kullanıcı federasyonu ve diğer realm bileşenleri (gizli alanlar maskeli) - Kullanıcı olayları (giriş, hatalı giriş, çıkış…) ve yönetici denetim kaydı; olay kaydı yapılandırması - Realm ayarları (parola politikası, brute force, oturum/token süreleri), imzalama anahtarlarının meta verisi, kimlik doğrulama akışları, zorunlu eylemler, brute force kilit durumu **Onaylı işlemler:** kullanıcı bilgilerini güncelleme, kullanıcıyı etkinleştirme/devre dışı bırakma (etkinleştirme brute force kilidini de temizler), grup ve alt grup oluşturma/güncelleme, realm rolü oluşturma/güncelleme (yalnız ad, açıklama, öznitelik), realm görünüm ve dil ayarları. **Yıkıcı işlemler:** grup ve realm rolü silme, tek oturumu sonlandırma, kullanıcının ya da realm'in tüm oturumlarını kapatma, bir ya da tüm kullanıcıların brute force kilidini kaldırma, olay kaydı yapılandırmasını değiştirme, realm güvenlik ve oturum ayarlarını güncelleme. Bilerek dışarıda: kullanıcı oluşturma, parola ve kimlik bilgisi uçları, parola sıfırlama ve eylem e-postaları, impersonation, rol atama ve bileşik rol yazma, client rolü yazma (manage-clients gerektirir; o rol client secret'larını açar), gruba üye ekleme, client oluşturma/güncelleme ve client secret okuma/yeniden üretme, client scope/IdP/LDAP yazma, dış kimlik bağlama, olay kayıtlarını silme, ayrıntılı yetki (FGAP) ve organizasyonlar. Kullanıcı, oturum ve olay yanıtları dış içerik olarak işaretlidir. Kimlik: OAuth2 client credentials — müşteri yönetilecek realm'de confidential bir client açar (Client authentication açık, yalnız "Service accounts roles" akışı), servis hesabına realm-management client'ının gereken rollerini verir (okuma: view-users, view-clients, view-realm, view-events, view-identity-providers; yazma: manage-users, manage-realm, manage-events). manage-clients ve realm-admin önerilmez: manage-clients client okuma uçlarında client secret'larını düz metin açar. client_id ve client_secret Vault'a konur; token aynı sunucudaki realm token ucundan alınır. Keycloak 17+ için hedef https://sso.example.com, eski WildFly dağıtımları için .../auth. Ayrıntılı kurulum README'dedir. ## Kaynak - API belgesi: https://www.keycloak.org/docs-api/latest/rest-api/index.html (Keycloak 26.8 Admin REST API; OpenAPI https://www.keycloak.org/docs-api/latest/rest-api/openapi.json; davranışlar keycloak/keycloak 26.8.1 kaynak koduyla kontrol edildi) - Kimlik: oauth2_client_credentials, token_host yok — token <hedef>/realms/{realm}/protocol/openid-connect/token adresinden form ile (grant_type=client_credentials, client_id ve client_secret Vault'taki komşu alanlardan) alınır; realm bağlayıcının kiracı alanıdır ve araç yolları /admin/realms/{realm}/... altındadır; servis hesabı yetkisi realm-management client rolleriyle verilir - Doğrulanmadı: gerçek bir Keycloak'a karşı hiçbir uç çağrılmadı; ters vekil ve KC_HOSTNAME/KC_HOSTNAME_ADMIN ayarlı kurulumlarda token ucunun hedef üzerinden çalışması; eski WildFly dağıtımında /auth önekiyle tüm yollar; manage-clients verilmediğinde client okuma uçlarında secret'ın maskeli döndüğü, IdP clientSecret ve LDAP bindCredential maskelemesi (kaynak kodda StripSecretsUtils); kısmi gövdeyle kullanıcı, realm ve olay yapılandırması güncellemesinde gönderilmeyen alanların korunduğu; group-by-path ucunun çok seviyeli yol kabul etmesi; olay ve admin olayı türü süzgecinin tek değerle çalışması; brute force kilidinin enabled=true güncellemesiyle temizlenmesi - Logo: https://github.com/cncf/artwork/blob/main/projects/keycloak/icon/color/keycloak-icon-color.svg

Bu sürümdeki tool'lar

Kurulumda bunların hangilerini bağlayacağınızı siz seçersiniz — seçmediğiniz tool sisteminize hiç girmez.

Uç ayrıntıları (yol, sorgu, parametreler) katalogda gösterilmez; üreticinin API yüzeyi herkese açık bir liste değildir. Kurduğunuzda kendi panelinizde tamamını görürsünüz.

Sürümler

Nasıl kurulur

Kendi Gateclave panelinizde Marketplace ekranını açın ve bu ürünün manifestini içe aktarın. Kurulum iki adımdır: bağlantı bilgisi (hedef + Vault'tan seçilen kimlik), ardından bağlanacak tool'ların seçimi. Yeni sürüm çıktığında Yükselt ile geçersiniz — bağlayıcılarınız, kimlik referanslarınız ve tool seçiminiz korunur.

Katalogdan tek tıkla kurulum ve otomatik güncelleme bildirimi bir sonraki aşamada devreye girecek.