Yetkilendirme: ApiKey, Kimlik Bilgileri veya OAuth 2.0

GeoPard çözümü şu şekilde kullanıyor AWS Cognito yetkilendirme prosedürü için.

Tüm yetkilendirme seçeneklerini kontrol etmenizi öneririz. Seçim belirli kullanım durumuna bağlıdır. Daha fazla kullanım detayı aşağıdaki her bir seçenekte açıklanmıştır.

Seçenek 1: Kimlik Bilgileri Kullanımı

“kullanıcı adı” ve “parola” ile yetkilendirme olası yaklaşımlardan biridir. Bu durumda e-posta ile kayıt yapılmalıdır (sosyal ağlar kullanılmaz).

Bu yaklaşım API (Arka Uç) seviyesinde entegrasyon için önerilir ve GeoPard API'ye yapılan tüm istekler özel bir servis (mikroservis) aracılığıyla proxylenir.

Giriş İsteği

curl --location --request POST 'https://api.geopard.tech/login' \
--header 'Content-Type: application/json' \
--header 'Content-Type: text/plain' \
--data-raw '{"username":"<email_address>","password":"<password>"}'

Giriş Yanıtı

Token, 30 dakikalık ömre sahip bir JWT'dir. En iyi uygulama tek bir token saklayıp tüm isteklerde onu yeniden kullanmak, süresinin dolup dolmadığını kontrol etmek ve süresi dolduğunda (veya kısa bir süre öncesinde) yeni bir token almaktır.

{
    "token": "<token_to_use_in_geopard_api>"
}

Seçenek 2: OAuth 2.0

AWS Cognito yetkilendirme için OAuth 2.0 protokolünü destekler. Genel bakış makalede açıklanmıştır Cognito OAuth2 kılavuzu, GeoPard vakasında en ilginç olanı Authorization Code Grant alt-makalasıdır.

Bu yaklaşım GeoPard'ın Kullanıcı Arayüzü (Ön Uç) seviyesinde entegre edilmesi önerilir. Entegrasyon, GeoPard ile veri gönderme/alma yönlerinde her iki yönde çalışır.

Kısaca özetlemek gerekirse:

1. Uygulamanız kullanıcının giriş veya kayıt işlemi için kullanıcıyı GeoPard Cognito'ya yönlendirmelidir.

Örnek:

curl --location --request GET '
https://auth.geopard.tech/oauth2/authorize?response_type=code&client_id=<connect_geopard_team>&redirect_uri=http://localhost:8080&state=54321
'

Uygulamanız için bireysel almak üzere lütfen GeoPard ekibiyle bağlantı kurun client_id.

1. Yönlendirilen URL bir doğrulama alacaktır kod bir sonraki adım için.

Yönlendirilen URL şu şekilde görünür http://localhost:8080/?code=eb10956a-6d51-49e5-bbfe-9815e3fdc70a&state=54321.

1. Uygulamanız şunu değiş tokuş etmelidir kod için tokenler (access_token, refresh_token, id_token).

Örnek:

curl --location --request POST '
https://auth.geopard.tech/oauth2/token
' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cookie: XSRF-TOKEN=365e14e1-3c66-477e-b0ef-a9e436a834ee; csrf-state=""; csrf-state-legacy=""' \
--data-urlencode 'grant_type=authorization_code' \
--data-urlencode 'code=eb10956a-6d51-49e5-bbfe-9815e3fdc70a' \
--data-urlencode 'client_id=42ajne9u466in6gaf569nth9o9' \
--data-urlencode 'redirect_uri=
http://localhost:8080
'

Seçenek 3: API Anahtarı

WMS ve WFS'ye hızlı erişim zaman zaman gerekli olabilir. Bu nedenle, her hesap için otomatik olarak oluşturulan GeoPard API anahtarını kullanmak mümkündür.

API anahtarı apiAnahtarı "UserData" GraphQL varlığının apiAnahtarı özniteliğinde bulunabilir. Nasıl alınacağına dair talimatlar BURADA.

apiAnahtarı ile kullanılmalıdır /geo uç noktaları SADECE ile.

Kullanım:

1. Bir geopardApiKey GET isteği URL'sindeki parametre olarak.

2. Bir X-API-Key herhangi bir istekte başlık olarak.