Authentication Providers

Kuika ile geliştirdiğiniz mobil ve web uygulamalarında, kullanıcı kimlik doğrulama işlemlerini gerçekleştirmek için LDAP (Lightweight Directory Access Protocol) seçeneğini kullanabilirsiniz. LDAP, Active Directory Windows Server'ınızda tanımlı kullanıcıları kontrol ederek uygulamanıza güvenli giriş imkanı sağlar.

Kimlik Doğrulama Sağlayıcısı Olarak LDAP Ekleme

1. App Settings Ekranına Gidin
   • Configuration Manager modülünde App Settings yapılandırma ekranını açın.
   • Authentication & Authorization sekmesine geçin.
2. Yeni Authentication Provider Ekleyin
   • Authentication Provider karşısında yer alan açılır menüye tıklayın.
   • Açılır menüde yer alan ADD NEW seçeneğini seçin.
3. LDAP Sağlayıcısını Ayarlayın

• Açılan Authentication Provider Setting başlıklı modal ekranında, kimlik doğrulama sağlayıcısı türü olarak LDAP seçeneğini belirleyin.

4. LDAP Bilgilerini Girin
   • Name: Yapılandırmaya bir ad verin.
   • IP Address: Active Directory Server’ın IP adresini girin.
   • Username ve Password: Active Directory’de admin rolüne sahip bir kullanıcı adı ve şifresini girin.
5. Kaydetme
   • Tüm bilgileri doldurduktan sonra CREATE butonuna tıklayın.

• LDAP entegrasyonu sayesinde uygulamanıza giriş yapmak isteyen kullanıcıların kimlik bilgileri, Active Directory Server üzerinden doğrulanır.
• Active Directory kullanıcı yönetimini merkezileştirerek güvenli bir kimlik doğrulama mekanizması oluşturabilirsiniz.
• Girdiğiniz Username ve Password, LDAP sunucusuna bağlanmak ve kullanıcı doğrulama işlemini yürütmek için kullanılacaktır.

Bu adımları tamamladıktan sonra, uygulamanız LDAP kimlik doğrulama sistemine başarıyla entegre olacaktır.

OAuth 2.0 (Open Authorization 2.0), kullanıcıların kimlik bilgilerini paylaşmadan bir uygulamaya veya hizmete güvenli bir şekilde erişim izni vermesini sağlayan bir yetkilendirme protokolüdür. Web tabanlı ve mobil uygulamalar için yaygın bir kimlik doğrulama yöntemi olan OAuth 2.0, uygulamanızın kullanıcıların belirli kaynaklara erişimini yönetmesine olanak tanır.

OAuth 2.0 Bileşenleri

1. Resource Owner (Kaynak Sahibi):
   Erişim izni veren kullanıcıdır. Örneğin, bir kullanıcının Facebook hesabını bir uygulamaya bağlama izni vermesi.
2. Client (İstemci):
   Kaynak sahibinin erişim izni almak istediği uygulamadır.
3. Authorization Server (Yetkilendirme Sunucusu):
   Kaynak sahibinin kimliğini doğrulayan ve erişim izni veren sunucudur. Ayrıca Access Token oluşturur.
4. Resource Server (Kaynak Sunucusu):
   Erişim izni verilen kaynakları barındıran sunucudur.

OAuth 2.0 Kullanımı

Kuika ile geliştirdiğiniz uygulamalarda OAuth 2.0 kimlik doğrulama sağlayıcısını aşağıdaki adımları izleyerek ekleyebilirsiniz.

OAuth 2.0 Kimlik Doğrulama Sağlayıcısını Eklemek

1. Configuration Manager Modülünü Açın:
   • Header alanında yer alan Configuration Manager modülüne tıklayın.
   • Yeni bir yapılandırma oluşturmak için Configuration Manager’i isimlendirin.
2. App Settings Alanına Geçin:
   • App Settings ekranında Authentication & Authorization sekmesine gidin.
   • Authentication Provider karşısındaki açılır menüden ADD NEW seçeneğini seçin.
3. OAuth 2.0’ı Seçin:

• Açılan modal ekranda Type karşısındaki açılır menüden OAuth 2.0 seçeneğini seçin.

OAuth 2.0 Ayarlarının Yapılması

1. Genel Bilgileri Girin:
   • Name: Sağlayıcının adını belirleyin.
   • Access Token URL: Access Token almak için kullanılacak URL’yi girin.
   • Expiration in Minutes: Access Token’in geçerlilik süresini dakika cinsinden girin. (Girilmeyen durumlarda Kuika varsayılan olarak 30 dakika tanımlar.)
2. Client Bilgilerini Girin:
   • Client ID ve Client Secret: OAuth 2.0 sağlayıcınız tarafından verilen bu bilgileri girin.
   • Client Authentication: Bu bilgilerin Header veya Body üzerinden gönderileceğini seçin. Sağlayıcı gereksinimlerine uygun seçimi yapın.
3. Scope ve Response Bilgilerini Tanımlayın:

• Scope: Gerekiyorsa, uygulamanızın erişim izinlerini temsil eden Scope bilgisini ekleyin.
• Response Mapping: OAuth 2.0’dan dönen JSON yanıtını Kuika’da eşleştirmek için şu alanları belirleyin:
  • Access Token
  • User Name
  • First Name
  • Last Name
  • Refresh Token

OAuth 2.0’ın Refresh Token özelliği sayesinde, Kuika otomatik olarak Access Token’i yeniler. Bu işlem için ek bir Refresh Token URL’si girmenize gerek yoktur.

4. Kimlik Doğrulama Sağlayıcısını Oluşturun:
   • Gerekli bilgileri tamamladıktan sonra CREATE butonuna tıklayın.

Generic Auth (REST), REST API tabanlı bir kimlik doğrulama sistemi olup, uygulamalarda kullanıcıların kimlik doğrulama işlemlerini yönetmek için kullanılır. Bu yapı, bir uygulamanın belirli bir REST API üzerinden Access Token almasını ve kimlik doğrulama işlemini gerçekleştirmesini sağlar.

Kuika ile geliştirdiğiniz uygulamalarda Generic Auth (REST) kimlik doğrulama sağlayıcısını aşağıdaki adımlarla kolayca ekleyebilirsiniz.

1. Generic Auth (REST) Sağlayıcısını Eklemek

1. Configuration Manager’i Açın:
   • Üst menüde yer alan Configuration Manager görünüm moduna tıklayın.
   • Yeni bir yapılandırma oluşturmak için Configuration Manager’i isimlendirin.
2. Authentication & Authorization Alanına Geçin:
   • App Settings ekranında, Authentication & Authorization sekmesine gidin.
   • Authentication Provider başlığı altındaki açılır menüden ADD NEW seçeneğini seçin.
3. Generic Auth (REST) Seçeneğini Belirleyin:

• Açılan modal ekranda Type alanından Generic Auth (REST) seçeneğini seçin.
• Sağlayıcıya bir isim vermek için Name alanını doldurun.

2. Token Ayarlarının Yapılması

1. REST API URL'si Ekleyin:
   • REST API URL: Token alımı için kullanılacak URL’yi belirtin. Daha fazla öğrenmek için Swagger veya Rest API dökümantasyonundan erişebilirsiniz.
2. Content Type Seçimi:
   • Content Type: Token dönen API’nin veri formatını seçin. (Örneğin: application/json veya application/x-www-form-urlencoded)
3. Expiration Süresi Belirleyin:
   • Expiration in Minutes: Token’in geçerlilik süresini dakika olarak girin (örn. 30 dakika). Kuika, belirtilmeyen durumlarda varsayılan olarak 30 dakika belirler.
4. Parametre Ekleme:
   • Ekstra Parametreler:
     • Header: Örneğin, Authorization başlığı kullanarak kimlik doğrulama bilgileri gönderilebilir.
     • Query: URL üzerinde kimlik doğrulama bilgilerini taşıyabilirsiniz.
     • Body: Veri iletimi POST veya PUT istekleriyle yapılabilir. Örneğin, application/json formatında veri gönderebilirsiniz.
5. Kullanıcı Parametreleri:
   • Username ve Password:
     • Kuika, otomatik olarak kullanıcı adı ve şifre parametrelerini ekleyebilir.
     • Parametre türünü (Header, Query, Body) ve key bilgilerini belirtin.

3. Refresh Token Ayarlarının Yapılması

1. Refresh Token URL’si Girin:
   • Token URL: Refresh Token işlemi için kullanılacak URL’yi belirtin.
2. Content Type Seçimi:
   • Content Type: URL içerik türünü seçin (örn. application/json).
3. Parametre Ekleme:
   • Ekstra Parametreler:
     • Refresh Token URL üzerinde Header, Query veya Body parametreleri ekleyebilirsiniz.
   • Kuika, Token ve Refresh Token parametrelerini otomatik olarak ekler. ADD PARAMETERS seçeneği ile uygun parametreleri belirtin.

4. Response Ayarlarının Yapılması

1. Access Token ve Diğer Bilgiler:
   • Response Mapping: Gelen yanıtı eşleştirmek için şu alanları tanımlayın:
     • Access Token
     • User Name
     • First Name
     • Last Name
     • Refresh Token
2. Refresh Token:
   • Refresh Token bilgilerini Response altında belirtilen alana ekleyin.

5. Sağlayıcıyı Oluşturma

Gerekli bilgileri doldurduktan sonra CREATE butonuna tıklayarak Generic Auth (REST) kimlik doğrulama sağlayıcınızı oluşturabilirsiniz.

MSAL, Microsoft kimlik doğrulama işlemlerini yapılandırmak ve uygulamalarınıza güvenli erişim sağlamak için kullanılan güçlü bir araçtır.

Authentication Provider Nasıl Eklenir?

1. Kuika platformuna giriş yaptıktan sonra “Apps” ekranından çalışacağınız projeyi açın. 
2. Ardından “Configuration Manager” modülüne tıklayın.
3. Yeni bir yapılandırma oluşturun veya mevcut bir yapılandırmayı seçin.
4. Authentication & Authorization bölümünde, MSAL sağlayıcı seçeneklerinden birini seçin.some text
   • Alternatif olarak, ADD NEW seçeneğini tıklayarak yeni bir konfigürasyon oluşturun.

Workspace’de Global Config tarafından eklenen içerikler, yetkisi olmayan kullanıcılar için yalnızca okunabilir veya gizlenmiş (***) şekilde görüntülenir.

5. MSAL Setting Modalını Doldurun:
   • Name: Authentication Provider’a anlamlı bir isim verin.
   • Client ID: Azure Portal’dan aldığınız uygulamanın benzersiz kimliğini girin.
   • Client Secret: Uygulamanın kimliğini doğrulamak için kullanılan gizli anahtarı girin.
   • Authority: Kullanıcı kimlik doğrulama URL'sini belirtin (örn. https://login.microsoftonline.com/{tenant} veya https://login.microsoftonline.com/common).
   • Scopes: Uygulamanın erişim talep ettiği izinleri girin (örn. user.read).
   • Keystore Base64: (Android için) APK dosyasından alınan Base64 kodlanmış anahtar deposu.
   • Cache Location: Token ve kimlik doğrulama bilgilerini saklamak için bir konum seçin (örneğin, localStorage veya sessionStorage).
   • Keystore Hash (Android Only): (Sadece Android) APK dosyasından alınan SHA-1 veya SHA-256 hash değeri.
6. Kaydetme:
   • Girdiğiniz bilgilerin doğruluğunu kontrol edin.
   • Kaydet butonuna tıklayarak MSAL Authentication Provider’ı ekleyin.

Artık uygulamanızda MSAL kullanarak güvenli kimlik doğrulama işlemleri gerçekleştirilebilir ve yetkilendirilmiş kaynaklara erişim sağlanabilir.

Alanların Tanımları

• Name: Authentication Provider’ı tanımlamak için anlamlı bir isim. Kullanıcıların ekledikleri provider’ları kolayca tanımasını sağlar.
• Client ID: Azure Portal’da oluşturulan uygulamanın benzersiz kimliği. Uygulamanın Azure Active Directory tarafından tanınmasını sağlar.
• Client Secret: Uygulamanın yetkilendirilmiş bir uygulama olduğunu doğrulamak için kullanılan gizli anahtar. Güvenlik amacıyla gizli tutulmalıdır.
• Authority: Kimlik doğrulama işlemleri için kullanılan URL (örn. https://login.microsoftonline.com/{tenant}).
• Scopes: Uygulamanın hangi kaynaklara erişim talep ettiğini belirten izinler (örn. user.read).
• Keystore Base64: (Android) APK dosyasından alınan anahtar deposunun Base64 formatındaki kodlanmış hali.
• Cache Location: Kimlik doğrulama bilgilerini ve token’ları saklayacak yer (örn. tarayıcıda localStorage).
• Keystore Hash (Android Only): (Sadece Android) APK dosyasından alınan hash bilgisi (SHA-1 veya SHA-256).