Kullanıcı Kılavuzu

Microsoft Authentication Library (MSAL)

7/10/26
Microsoft Authentication Library (MSAL)

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.

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

1. Konfigürasyonu Açın veya Oluşturun

  • Kuika platformuna giriş yapın.
  • Apps ekranından çalışacağınız projeyi açın.
  • Üst menüden Config Manager modülüne tıklayın.
  • Yeni bir konfigürasyon oluşturmak için Create a blank configuration kartına tıklayın, konfigürasyona bir isim verin ve oluşturma işlemini tamamlayın. Mevcut bir konfigürasyonu kullanmak isterseniz listeden adına tıklayın.

2. Authentication & Authorization Ayarına Gidin

  • Konfigürasyon ekranının üst kısmında App Settings sekmesinin seçili olduğundan emin olun.
  • Sol menüde Identity & Access başlığı altındaki Authentication & Authorization seçeneğine tıklayın. Menünün üstündeki Search settings alanına "authentication" yazarak da bu ayara hızlıca ulaşabilirsiniz.
  • MSAL açılır menüsünün altındaki ADD NEW bağlantısına tıklayın. Daha önce oluşturduğunuz bir yapılandırmayı kullanmak isterseniz açılır menüden seçebilirsiniz.

3. MSAL Setting Penceresini Doldurun

Açılan MSAL Setting penceresinde aşağıdaki alanları doldurun:

  • Name (zorunlu): Yapılandırma için tanımlayıcı isim.
  • Client ID (zorunlu): Azure Portal'da kayıtlı uygulamanızın istemci kimliği.
  • Client Secret (zorunlu): Uygulamanın kimliğini doğrulamak için kullanılan gizli anahtar.
  • Authority: Kimlik doğrulama adresi (ör. https://login.microsoftonline.com/{tenant} veya https://login.microsoftonline.com/common/).
  • Scopes: Uygulamanın talep edeceği erişim izinleri (ör. user.read).
  • Keystore Base64: Anahtar deposu dosyasının Base64 formatındaki içeriği.
  • Cache Location: Token önbellek konumunu belirleyen anahtar.
  • Keystore Hash (Android only): Yalnızca Android uygulamalar için anahtar deposu hash değeri.

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.

Sözlük

No items found.

Alt Başlıklar