Custom External Token Validator Provider

Custom External Token Validator Provider, harici kimlik sağlayıcılar (SSO, external auth servisleri, mobil token servisleri vb.) tarafından üretilen token’ların Kuika içinde doğrulanmasını ve yorumlanmasını sağlar. Bu provider sayesinde, Kuika dışından gelen erişim token’ları kontrol edilerek kullanıcı bilgileri güvenli şekilde sisteme aktarılır.

  • Uygulama, harici bir kimlik doğrulama sistemi (SSO, OAuth tabanlı servisler, özel auth servisleri) kullanıyorsa,
  • Kullanıcılar Kuika’ya username + password yerine external token ile giriş yapıyorsa,
  • Mobil uygulama, gateway veya üçüncü parti sistemlerden gelen token’ların geçerliliği kontrol edilmek isteniyorsa kullanılabilir. 

Oluşturma Adımları

  1. C# veri kaynağını seçin ve bir isim girin.
  2. Custom External Token Validator Provider metodunu seçin.
  3. CREATE butonuna tıklayın.

Custom External Token Validator Sınıfı

Custom External Token Validator sınıfı, IExternalTokenValidator arayüzünü uygular ve Kuika’ya gelen external token doğrulama sürecini yönetir.

public class CustomExternalTokenValidator : IExternalTokenValidator

TokenProviderType Özelliği

public EExternalTokenProviderTypes TokenProviderType =>     EExternalTokenProviderTypes.External1;
  • Kullanılacak external token sağlayıcısını belirtir.
  • External1 – External5 arasında değer alabilir.
  • Varsayılan değer External1’dir.
  • Gerekmedikçe değiştirilmemelidir.

Validate Metodu

public ExternalTokenResult Validate(ExternalTokenRequest request)

Kuika’ya gelen external token’ın geçerliliğini kontrol etmek ve doğrulama sonucu kullanıcı bilgilerini döndürmek için kullanılır.

Görevleri:

  • Gelen TokenString değerinin geçerliliğini doğrulamak
  • Token’a ait kullanıcıyı belirlemek
  • Kuika’nın kullanacağı kimlik bilgilerini döndürmek

Örnek Dönüş:

return new ExternalTokenResult(){    RefreshToken = request.RefreshToken,    Token = request.TokenString,    UserName = request.Username,    Name = null,    Surname = null,    PhoneNumber = null};
return null dönen alanlar Kuika tarafından geçersiz kabul edilir. null olmayan alanlar Kuika’da aktif olarak kullanılır.

RefreshToken Metodu

public ExternalTokenResult RefreshToken(ExternalRefreshTokenRequest request)

Süresi dolmuş veya yenilenmesi gereken token’ların refresh token üzerinden güncellenmesini sağlar.

Görevleri:

  • Refresh token’ın geçerliliğini doğrulamak
  • Yeni veya güncellenmiş token bilgilerini Kuika’ya döndürmek

Örnek Dönüş:

return new ExternalTokenResult(){    RefreshToken = request.RefreshToken,    Token = request.TokenString};