Microsoft Authentication Library (MSAL), Microsoft'un kimlik doğrulama ve yetkilendirme işlemleri için geliştirdiği bir kütüphanedir. Kuika'da MSAL kullanarak kimlik doğrulama işlemlerini hızlı ve kolay bir şekilde yapılandırabilirsiniz. Bu sayede uygulamalarınıza kimlik doğrulama özelliği ekleyebilir, kullanıcıların güvenli bir şekilde giriş yapmasını ve yetkilendirilmiş kaynaklara erişim sağlamasını mümkün kılabilirsiniz. Bu kılavuz, MSAL kullanarak kimlik doğrulama işlemlerini nasıl yapılandırabileceğinizi adım adım anlatmaktadır.

Aşağıdaki başlıklar altında bu süreci detaylı olarak öğrenebilirsiniz:

A. Microsoft Authentication Library kimlik doğrulama sağlayıcısı ile çalışmak.

B. MSAL Ayarları modülünün anatomisi.

C. Azure Portal’da uygulama oluşturmak.

D. Platform eklemek.

E. Kuika’da Configuration Manager Modülünde MSAL konfigürasyonunu tanımlamak.

A. Microsoft Authentication Library Kimlik Doğrulama Sağlayıcısı ile Çalışma

Kuika platformuna giriş yaptıktan sonra “Apps” ekranından çalışacağınız projeyi açın.

Ardından “Configuration Manager ” (1) modülünü açın.
“Configuration Manager” modülünü açın.
Oluşturmak istediğiniz yapılandırmaya isim verin ve “CREATE” butonuna tıklayın.

App Settings (1) sekmesinden “Authentication & Authorization” bölümündeki MSAL (2) seçeneklerinden birini seçin veya “ADD NEW” (3) ile yeni bir konfigürasyon oluşturun.

Workspace’de Global Config tarafından eklenen içerikler yetkisi olmayan kullanıcılar tarafından sadece okunabilir veya gizlenmiş olarak gösterilir.

B. MSAL Ayarları Modülünün Anatomisi

Ön tanımlı bir konfigürasyon seçtikten veya yeni bir yapılandırma oluşturduktan sonra “MSAL Setting” modalı açılır. Bu modal üzerinden aşağıdaki ayarları yapabilirsiniz:

Name (1) :Authentication Provider’ın tanımlanması için kullanılır.
Client ID (2) : Azure Portal üzerinden oluşturulan uygulamanın benzersiz kimliğidir.
Client Secret (3) : Uygulamanın kimliğini doğrulamak için kullanılan gizli bir anahtardır.
Authority (4) : Kimlik doğrulama işlemleri için kullanılan URL uzantısını girin.(Örneğin; “https://login.microsoftonline.com/{tenant} veya https://login.microsoftonline.com/common/.”)
Scopes (5) : Uygulamanın hangi kaynaklara erişim talep ettiğini belirten izinlerdir. (Örneğin; user.read gibi bir kapsam, profil bilgilerini okumanıza izni verir.)
Keystore Base64 (6) : Genellikle Android uygulamalar için kullanılır ve Base64 formatında kodlanmış anahtar deposudur.
Cache Location (7) : Kimlik doğrulama bilgileri ve tokenların saklanacağı konumu belirler.
Keystore Hash (Android only)(8) : Android uygulamaları için gerekli olan hash bilgisidir.

Değişiklikleri tamamladıktan sonra “CREATE” (9) butonuna tıklayın.

C. Azure Portal’da Uygulama Oluşturmak

Kuika'da kimlik doğrulama sağlayıcısı olarak MSAL kullanmak için Azure Portal'da aşağıdaki adımları gerçekleştirmeniz gerekmektedir:

portal.azure.com adresine giriş yapın.
Entra ID’ye tıklayın veya arama alanında Entra ID’yi arayın.

“App registrations” seçeneğine tıklayın ve “New registration” butonuna tıklayın.
“Register in this Directory” seçimini yapın.
Uygulamanızı isimlendirin ve “Supported Account Types” başlığı altından uygun seçimi yapın.
“Register” butonuna tıklayın.

Uygulama Bilgilerini Kaydetmek

Uygulama kaydı oluşturduktan sonra açılan ekranda bulunan bilgileri (Application Client ID ve Business hesaplar için Tenant ID) Kuika’da MSAL bilgilerini tanımlarken kullanın.

“Certificates & secrets” bölümünden “New client secret” butonuna tıklayın.

Description alanını doldurun ve son kullanım süresini seçin, ardından “Add” butonuna tıklayın.
Gelen ekranda Client Secret altında yer alan değeri yedekleyin.

Bu değer, platformda Client Secret için kullanılacaktır ve güvenlik için ilerleyen zamanlarda erişim sağlanamayacaktır.

API İzinlerini Yapılandırmak

API permissions bölümünü açın.Bu ekranda mevcut izinler listelenmekte, yeni bir izin oluşturulabilmektedir. Varsayılan olarak “User.Read” isimli giriş yapma ve kullanıcı profili okuma izni bu ekranda gelmektedir.

“Add a permission” butonuna tıklayarak ihtiyaç duyulan izinleri ekleyin (Örneğin, takvime erişim için).

Sağda açılan drawerdan Microsoft Graph’a tıklayıp ihtiyaç duyulan izinleri seçerek ekleyebilirsiniz.

İzin ekleme işlemi sonrasında bir önceki ekrana dönüş sağlanır.

D. Platform Eklemek

Kimlik doğrulama için platform (Web/iOS ve Android) ekleme işlemleri:

“Overview” bölümünde “Add a Redirect URL” butonuna tıklayın.
“Add a platform” butonuna tıklayın.

Web Platformu Eklemek:

“Web” butonuna tıklayın ve gerekli URL'leri girin.
Açılan ekranda Redirect URLs alanında yayınlayacağınız web uygulamaya yönelik Redirect URL oluşturun. (Örneğin, https://platform.kuika.com/msalredirect)
Daha sonra altta yer alan “Front-channel logout URL” alanında yayınlayacağınız web uygulamaya yönelik Logout URL oluşturun. (Örneğin, https://platform.kuika.com/logout)
“Configure” butonuna tıklayın.

iOS Platformu Eklemek:

“iOS” butonuna tıklayın ve Bundle ID'yi girin.
“Configure” butonuna tıklayın ve işlemi tamamlayın.

Android Platformu Eklemek

“Android” butonuna tıklayın ve gerekli bilgileri girin.
“Configure” butonuna tıklayın ve işlemi tamamlayın.

E. Kuika’da Configuration Manager Modülünde MSAL Konfigürasyon Tanımlamak

“Configuration Manager” modülünü açın ve bir konfigürasyon yapılandırması oluşturun.
App Settings sekmesinde MSAL konfigürasyonunu seçin veya yeni bir ayar oluşturun.
MSAL Setting modalında gerekli bilgileri girin ve “CREATE” butonuna basarak işlemi tamamlayın.

Artık uygulamanız için MSAL kullanarak kimlik doğrulama işlemlerini gerçekleştirebilir ve gerekli kaynaklara erişim sağlayabilirsiniz.