Keycloak İstemci İmzalı JWT Kullanımı

Keycloak İstemci İmzalı JWT Kullanımı

Table of Contents

1. Giriş (Introduction)
2. Keycloak Genel Bakışı (Overview of Keycloak)
3. Keycloak'a OpenID Connect İstemcisi Ekleme (Adding an OpenID Connect Client to Keycloak)
4. Hesap Türleri (Account Types)
   • 4.1 Hizmet Hesapları (Service Accounts)
   • 4.2 İstemci Kimlik Doğrulaması (Client Authentication)
5. Erişim Türü ve Yetkiler (Access Type and Permissions)
   • 5.1 Gizli Erişim Türü (Confidential Access Type)
   • 5.2 Genel Erişim Türü (Public Access Type)
   • 5.3 Kapsamlar ve Roller (Scopes and Roles)
6. Kimlik Doğrulama ve Jot İmzalama (Authentication and Jot Signing)
   • 6.1 Kimlik Doğrulama Türleri (Types of Authentication)
   • 6.2 Kimlik Doğrulama Ayarları (Authentication Settings)
   • 6.3 Jot İmzalama (Jot Signing)
7. Anahtar Yönetimi (Key Management)
   • 7.1 Public Key Yükleme (Importing a Public Key)
   • 7.2 Yeni Anahtar Oluşturma (Generating a New Key)
   • 7.3 Özel Anahtarı Çıkarma (Extracting the Private Key)
8. Açıklama 2 (Heading 8)
9. Açıklama 3 (Heading 9)
10. Açıklama 4 (Heading 10)

Giriş (Introduction)

Bu makalede, Keycloak'a OpenID Connect istemcisi nasıl eklenir ve istemcinin hizmet hesaplarını kullanarak imzalı JOT yetkilendirme nasıl yapılır, adım adım açıklanmaktadır. OpenID Connect, Kimlik Dağıtımının oturum açma hizmeti olarak kullanılan bir protokoldür. Keycloak, kullanıcı kimlik doğrulama ve yetkilendirme işlemlerini yönetmek için kullanılan bir açık kaynaklı yazılımdır.

Keycloak Genel Bakışı (Overview of Keycloak)

Keycloak, uygulamalarınızı güvenli bir şekilde kullanıcı kimlik doğrulama ve yetkilendirme işlemlerini yönetmenize olanak tanır. Ayrıca, OAuth 2.0 ve OpenID Connect gibi modern kimlik doğrulama ve yetkilendirme protokollerini destekler. Keycloak'un yönetim konsolu üzerinden yapılandırılabilme özelliği, platformu kullanıcı dostu ve esnek hale getirir.

Keycloak'a OpenID Connect İstemcisi Ekleme (Adding an OpenID Connect Client to Keycloak)

Keycloak'un yönetim konsoluna erişerek, mevcut realm üzerinde bir istemci oluşturulabilir. İstemci oluşturulurken istemci kimliği ve protokolün OpenID Connect olarak ayarlanması gerekmektedir. Ayrıca, erişim türü (access type) gizli (confidential) olarak belirlenmeli ve hizmet hesapları (service accounts) etkinleştirilmelidir. Bunun yanı sıra, OAuth akışları düzenlenmeli ve istemci için kullanılacak kapsamlar (scopes) ve roller (roles) belirlenmelidir.

Hesap Türleri (Account Types)

Keycloak'ta iki tür hesap bulunmaktadır: kullanıcı hesapları ve hizmet hesapları. Kullanıcı hesapları, gerçek kullanıcılar tarafından kullanılırken, hizmet hesapları otomatik olarak oluşturulan ve API çağrıları sırasında kullanılan hesaplardır.

4.1 Hizmet Hesapları (Service Accounts)

Hizmet hesapları, kullanıcı adı ve parola yerine, istemciden alınan istemci kimliği ve istemci sırrı (client secret) ile otomatik olarak kimlik doğrulama yapar. Bu sayede kullanıcı adı ve parola gibi hassas bilgilerin paylaşılması önlenmiş olur.

4.2 İstemci Kimlik Doğrulaması (Client Authentication)

İstemci kimlik doğrulaması, istemciye özgü yöntemlerle yapılan kimlik doğrulama sürecidir. Keycloak, istemci kimlik doğrulamasını sağlamak için OAuth 2.0 spesifikasyonunda belirtilen yöntemleri destekler. İstemci kimlik doğrulama yöntemleri, güvenlik gereksinimlerine göre yapılandırılabilir.

Erişim Türü ve Yetkiler (Access Type and Permissions)

İstemci erişim türü, istemciye tanınan yetkileri ve erişim yeteneklerini belirler. Keycloak'un iki farklı erişim türü vardır: gizli (confidential) ve genel (public). Gizli erişim türü, daha fazla yetkilendirme ve OAuth akışlarına olanak tanırken, genel erişim türü sadece kimlik doğrulama yapmaya olanak sağlar.

5.1 Gizli Erişim Türü (Confidential Access Type)

Gizli erişim türü, istemcinin güvenli bir kimlik doğrulama süreci sağlamasını ve kullanıcı adı/parola gibi hassas bilgilerin paylaşılmamasını gerektirir. Bu tür erişim türü, güçlü yetkilendirme ve yetkilendirme akışları kullanılarak gelişmiş güvenlik sağlar.

5.2 Genel Erişim Türü (Public Access Type)

Genel erişim türü, istemcinin sadece açık kimlik doğrulama yapmasını sağlar. Bu tür erişim türü, kullanıcının istemciye erişim izni vermesini sağlar, ancak istemcinin tam yetkilendirme kontrolüne sahip olmamasını gerektirir.

5.3 Kapsamlar ve Roller (Scopes and Roles)

Kapsamlar (scopes) ve roller (roles), istemcinin erişim haklarını belirlemek için kullanılır. Kapsamlar, istemcinin belirli kaynaklara erişim izni almasını sağlarken, roller, kullanıcının sahip olduğu yetkileri belirler. Keycloak'ta kapsamlar ve roller, istemciler için ayrı ayrı yapılandırılabilir.

Kimlik Doğrulama ve Jot İmzalama (Authentication and Jot Signing)

Kimlik doğrulama, kullanıcının kimlik bilgilerinin doğrulanması sürecidir. Jot (JSON Web Tokens) imzalama, Jot'ları kullanarak güvenli bir şekilde kimlik doğrulamasını sağlar. Keycloak, istemcilerle yapılan kimlik doğrulama işlemlerinde Jot imzalama yöntemini destekler.

6.1 Kimlik Doğrulama Türleri (Types of Authentication)

Keycloak, çeşitli kimlik doğrulama yöntemlerini destekler. Kullanıcı adı/parola kimlik doğrulaması, sosyal medya hesaplarıyla kimlik doğrulama, çok faktörlü kimlik doğrulama gibi farklı yöntemler kullanılabilir. Bu yöntemler, istemcinin ihtiyaçlarına göre yapılandırılabilir.

6.2 Kimlik Doğrulama Ayarları (Authentication Settings)

Kimlik doğrulama ayarları, istemcinin kimlik doğrulama sürecinin nasıl gerçekleşeceğini belirler. Keycloak'un yönetim konsolu üzerinden yapılandırılabilen bu ayarlar, güvenli bir kimlik doğrulama işlemi sağlamak için kullanılabilir.

6.3 Jot İmzalama (Jot Signing)

Jot imzalama, Jot'ların güvenli bir şekilde imzalanması ve doğrulanması sürecidir. İstemci, Jot'ları kullanarak kimlik doğrulama işlemini gerçekleştirirken, Keycloak da bu Jot'ların geçerli ve güvenli olduğunu doğrular.

Anahtar Yönetimi (Key Management)

Anahtar yönetimi, Jot imzalama için kullanılan anahtarların yönetimini sağlar. Keycloak, kullanıcı tarafından oluşturulan bir anahtar çiftini alır ve bu anahtarı Jot imzalamada kullanır. Anahtar yönetimi süreci, güvenliğin sağlanması ve anahtarların gerekli şekilde kullanılabilmesi için önemlidir.

7.1 Public Key Yükleme (Importing a Public Key)

Keycloak, kullanıcının veya istemcinin sağladığı bir genel anahtarın yüklenmesine izin verir. Bu genel anahtar, Jot imzalama için kullanılır. Keycloak, belirli bir formatta (örneğin x509 sertifikası) sağlanan genel anahtarı kabul eder ve güvenli kimlik doğrulama işlemleri için kullanır.

7.2 Yeni Anahtar Oluşturma (Generating a New Key)

Keycloak, kullanıcının veya istemcinin talebi üzerine yeni bir anahtar çifti oluşturabilir. Bu yeni anahtar çifti, Jot imzalamada kullanılan özel ve genel anahtarları içerir. Yeni bir anahtar çifti oluşturulduğunda, kullanıcı tarafından belirlenen şifreleme parametrelerine göre anahtarlar oluşturulur.

7.3 Özel Anahtarı Çıkarma (Extracting the Private Key)

Keycloak, oluşturulan anahtar çiftinden sadece genel anahtarı saklar. Özel anahtar, genellikle güvenlik nedenleriyle kullanıcıya verilmez. Bununla birlikte, bazı durumlarda özel anahtarın kullanılması gerekebilir. Bu durumda, özel anahtar openssl gibi bir araç kullanılarak çıkarılabilir ve uygun formatta kaydedilebilir.

Açıklama 2 (Heading 8)

Açıklama 2 içeriği buraya yazılır.

Açıklama 3 (Heading 9)

Açıklama 3 içeriği buraya yazılır.

Açıklama 4 (Heading 10)

Açıklama 4 içeriği buraya yazılır.

Highlights

• Keycloak, kullanıcı kimlik doğrulama ve yetkilendirme işlemlerini yönetmek için kullanılan bir açık kaynaklı yazılımdır.
• Keycloak, OAuth 2.0 ve OpenID Connect gibi modern kimlik doğrulama ve yetkilendirme protokollerini destekler.
• Keycloak'un yönetim konsolu üzerinden istemciler oluşturulabilir ve yapılandırılabilir.
• İstemci erişim türü, istemciye tanınan yetkileri ve erişim yeteneklerini belirler.
• Kimlik doğrulama yöntemleri, kullanıcının kimlik bilgilerinin doğrulanmasını sağlar.
• Jot imzalama, Jot'ları kullanarak güvenli bir şekilde kimlik doğrulamasını sağlar.
• Anahtar yönetimi, Jot imzalama için kullanılan anahtarların yönetimini sağlar.
• Keycloak, genel anahtarların yüklenmesine ve yeni anahtar çiftlerinin oluşturulmasına izin verir.
• Özel anahtar, güvenlik nedenleriyle genellikle kullanıcıya verilmez.

Sıkça Sorulan Sorular (FAQs)

S: Keycloak nedir? Keycloak, kullanıcı kimlik doğrulama ve yetkilendirme işlemlerini yönetmek için kullanılan bir açık kaynaklı yazılımdır.

S: Keycloak'un desteklediği kimlik doğrulama yöntemleri nelerdir? Keycloak, kullanıcı adı/parola kimlik doğrulaması, sosyal medya hesaplarıyla kimlik doğrulama, çok faktörlü kimlik doğrulama gibi farklı yöntemleri destekler.

S: Keycloak nasıl yapılandırılır? Keycloak, yönetim konsolu aracılığıyla kullanıcı dostu bir şekilde yapılandırılabilir. İstemci oluşturma, erişim türlerinin belirlenmesi ve kimlik doğrulama ayarlarının yapılandırılması gibi işlemler buradan gerçekleştirilebilir.

Kaynaklar

1. Keycloak Resmi Websitesi
2. Keycloak GitHub Deposu