Page 92 - Yazılım Teknolojileri Araştırma Bülteni 2023
P. 92
92 | Kimlik Doğrulama Altyapılarının Kullanımı
Ilk çalıştırıldıktan sonra, varsayılan ayarlar değiştirilmediyse http://localhost:8080 adresinden giriş
ekranına girilir. Ilk kez girişte, keycloak yönetim ekranı için admin kullanıcısı oluşturulmalıdır. Bu, hem
kullanıcı arayüzünden hem de ortam değişkenleri ile (KEYCLOAK_ADMIN=x KEYCLOAK_ADMIN_
PASSWORD=y) yapılabilir. Eğer admin kullanıcısı varsa ve ortam değişkeni de ayarlanmışsa, ayağa
kalkma aşamasında hata log’u gözükür ve environment değerler ihmal edilir. Admin oluşturulduktan
sonra diğer kullanıcılar, kullanıcı arayüzünden ya da keadm.bat dosyasından oluşturulabilir. Admin
kullanıcısı ve normal kullanıcılar oluşturulduktan sonra giriş adresleri farklılık göstermektedir.
Admin kullanıcısı için http://localhost:8080/admin/master/console/ adresinden, Myrealm
realm’inde oluşturulmuş kullanıcılar için http://localhost:8080/realms/myrealm/account/
adresinden erişim sağlanır.
3. Paket Yapısı
• /bin altında bat ve sh uzantılı dosyalar ve uygulamayı ayağa kaldırma, kullanıcı oluşturma gibi
dosyalar bulunur.
• /conf altındaki dosyalar ile, keycloak ayarları yapılır.
• /data altında keycloak tarafından oluşturulmuş bilgiler saklanır.
• /providers altında keycloak’a dışarıdan eklenmek istenen java paketleri yer alır.
• /themes altında kendimize ait temalar geliştiririz.
4. Keycloak Konfigürasyonu
Keycloak konfigürasyonu için 4 yol vardır. Önem sırası üstten aşağıya gider. Yani üstte tanımlanan
alttakileri ezer.
• Komut satırı parametreleri (Command-line parameters), uygulama ayağa kaldırılırken geçilir. Bu
tip parametreler -- =x yapısında yazılır. Örnek kullanımı şu şekildedir.
kc.bat start-dev --db-url-host=mykeycloakdb
• Ortam değişkenleri (Environment variables), KC_=x yapısında yazılır. Örnek kullanımı şu şekildedir.
export KC_DB_URL_HOST=mykeycloakdb
kb.bat start-dev
• Kullanıcı tarafından tanımlanan konfigürasyon dosyaları (User-created .conf file).
Kullanıcının varsayılan conf dosyası hariç oluşturduğu konfigürasyonlar, conf dosyasındaki
yapıyla aynı şekildedir. key-with-dashes=x yapısında yazılır.
db-url-host=mykeycloakdb
Ayrıca conf dosyasının ortam değişkenlerini okuması sağlanabilir.