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 şekilde yapılandırabilirsiniz. Bu eğitim içeriği, MSAL kullanarak kimlik doğrulama işlemlerini adım adım açıklar.

Bu eğitim içeriği aşağıdaki başlıklardan oluşur:

Microsoft Authentication Library kimlik doğrulama sağlayıcısı ile çalışmak.
MSAL Ayarları modülünün anatomisi.
Azure Portal’da uygulama oluşturmak.
Platform eklemek.
Kuika’da Configuration Manager Modülünde MSAL konfigürasyonunu tanımlamak.

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

Kuika platformuna giriş yapın.
Apps ekranından çalışacağınız projeyi seçin.

Sol menüden Configuration Manager modülünü tıklayın.
Konfigürasyona bir isim girin ve CREATE butonuna tıklayın.

App Settings sekmesinde Authentication & Authorization bölümündeki MSAL seçeneklerinden birini seçin veya ADD NEW ile yeni bir konfigürasyon oluşturun.

Workspace’de Global Configuration tarafından eklenen içerikler, yetkisi olmayan kullanıcılar için yalnızca okunabilir veya gizlenmiş olarak gösterilir.

MSAL Ayarları Modülünün Anatomisi

Name: Authentication Provider’ı tanımlayan isimdir.
Client ID: Azure Portal’da oluşturulan uygulamanın benzersiz kimliğidir.
Client Secret: Uygulamanın kimliğini doğrulamak için kullanılan gizli anahtardır.
Authority: Kimlik doğrulama işlemleri için kullanılan URL’dir (Örn. https://login.microsoftonline.com/{tenant} veya https://login.microsoftonline.com/common/).
Scopes: Uygulamanın hangi kaynaklara erişim talep ettiğini belirleyen izinlerdir (Örn. user.read).
Keystore Base64: Android uygulamalar için kullanılan Base64 formatında anahtar deposudur.
Cache Location: Kimlik doğrulama bilgileri ve tokenların saklanacağı konumu belirler.
Keystore Hash: Android uygulamaları için gerekli olan hash bilgisidir.
Bilgileri girdikten sonra CREATE butonuna tıklayın.

Azure Portal’da Uygulama Oluşturmak

portal.azure.com adresine giriş yapın.
Entra ID’yi seçin veya arama alanında arayın.

App registrations seçeneğine tıklayın ve New registration butonuna tıklayın.
Uygulamayı isimlendirin, Supported Account Types altında uygun seçimi yapın ve Register butonuna tıklayın.

Uygulama Bilgilerini Kaydetme

Application Client ID ve Tenant ID’yi kaydedin.

Certificates & secrets bölümünde New client secret butonuna tıklayın.
Description alanını doldurun, son kullanım süresini seçin ve Add butonuna tıklayın.
Oluşan Client Secret değerini kaydedin.

API İzinlerini Yapılandırma

API permissions bölümünü açın.

User.Read varsayılan olarak bulunur.
Add a permission butonuna tıklayarak ihtiyaç duyulan izinleri ekleyin.

Sağda açılan panelden Microsoft Graph’ı seçin ve gerekli izinleri ekleyin.

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

MSAL Platform Ekleme

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

Web Platformu

Web butonuna tıklayın.
Redirect URLs alanında web uygulaması için bir Redirect URL oluşturun (Örn. https://platform.kuika.com/msalredirect).
Front-channel logout URL alanında bir Logout URL oluşturun (Örn. https://platform.kuika.com/logout).
Configure butonuna tıklayın.

iOS Platformu

iOS butonuna tıklayın, Bundle ID’yi girin ve Configure butonuna tıklayın.

Android Platformu

Android butonuna tıklayın, gerekli bilgileri girin ve Configure butonuna tıklayın.

Configuration Manager Modülünde MSAL Konfigürasyon Tanımlamak

Configuration Manager modülünü açın.
Yeni 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.
CREATE butonuna tıklayarak işlemi tamamlayın.

Bu adımları tamamladıktan sonra uygulamanızda MSAL kullanarak kimlik doğrulama işlemlerini gerçekleştirebilir ve yetkilendirilmiş kaynaklara erişebilirsiniz.