Generic Auth (Rest)

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.