Autorisierung: ApiKey, Anmeldedaten oder OAuth 2.0

Die GeoPard-Lösung verwendet AWS Cognito für das Authentifizierungsverfahren.

Wir empfehlen, alle Autorisierungsoptionen zu prüfen. Die Wahl hängt vom jeweiligen Anwendungsfall ab. Weitere Nutzungsdetails sind in den einzelnen Optionen unten beschrieben.

Option 1: Verwendung von Zugangsdaten

Die Autorisierung mit „Benutzername“ und „Passwort“ ist eine der möglichen Vorgehensweisen. In diesem Fall muss eine E-Mail-Registrierung erfolgen (nicht über soziale Netzwerke).

Der Ansatz wird für die Integration auf API-(BackEnd-)Ebene empfohlen und alle Anfragen an die GeoPard-API werden über einen dedizierten speziellen Dienst (Microservice) proxied.

Login-Anfrage

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>"}'

Login-Antwort

Das Token ist ein JWT mit einer Lebensdauer von 30 Minuten. Es ist Best Practice, ein einzelnes Token zu speichern und es für alle Anfragen wiederzuverwenden, dessen Ablaufzeit zu prüfen und ein neues Token abzurufen, wenn es abläuft (oder kurz davor).

{
    "token": "<token_to_use_in_geopard_api>"
}

Option 2: OAuth 2.0

AWS Cognito unterstützt das OAuth-2.0-Protokoll für die Autorisierung. Die allgemeine Übersicht ist im Artikel beschrieben Cognito OAuth2 Handbuch, der Unterartikel Authorization Code Grant ist im GeoPard-Fall am relevantesten.

Der Ansatz wird empfohlen, GeoPard auf der Benutzeroberflächen-(FrontEnd-)Ebene zu integrieren. Die Integration funktioniert in beide Richtungen, um Daten an GeoPard zu senden/von GeoPard zu empfangen.

Kurz gesagt:

1. Ihre Anwendung muss einen Benutzer zur Anmeldung oder Registrierung an GeoPard Cognito weiterleiten.

Beispiel:

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
'

Bitte kontaktieren Sie das GeoPard-Team, um Ihre individuelle Anwendung client_id.

1. Die weitergeleitete URL erhält einen Verifizierungs- Code für den nächsten Schritt.

Die weitergeleitete URL sieht aus wie http://localhost:8080/?code=eb10956a-6d51-49e5-bbfe-9815e3fdc70a&state=54321.

1. Ihre Anwendung muss Code für Token (access_token, refresh_token, id_token).

Beispiel:

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
'

Option 3: API-Schlüssel

Für den schnellen Zugriff auf WMS und WFS ist dies von Zeit zu Zeit erforderlich. Daher ist es möglich, den automatisch für jedes Konto generierten GeoPard-API-Schlüssel zu verwenden.

Der API-Schlüssel ist im API-Schlüssel Attribut der "UserData"-GraphQL-Entität zu finden. Anweisungen zum Abruf API-Schlüssel werden bereitgestellt HIER.

API-Schlüssel muss mit /geo Endpunkten NUR verwendet werden.

Verwendung:

1. Als geopardApiKey Parameter in der GET-Anfrage-URL.

2. Als ein X-API-Key Header in JEDER Anfrage.