# Auktorisering: ApiKey, Credentials eller OAuth 2.0

GeoPard-lösningen använder [AWS Cognito](https://docs.aws.amazon.com/en_us/cognito/latest/developerguide/what-is-amazon-cognito.html) för autentiseringsproceduren.

Vi rekommenderar att kontrollera alla auktoriseringsalternativ. Valet beror på det specifika användningsfallet. Mer användningsdetaljer beskrivs i varje alternativ nedan.

## Alternativ 1: Använda referenser

Auktorisering med ”användarnamn” och ”lösenord” är en av de möjliga metoderna. I detta fall måste e-postregistrering göras (inte via sociala nätverk). 

{% hint style="info" %}
Tillvägagångssättet ***rekommenderas för integration på API (BackEnd)-nivå*** och alla förfrågningar till GeoPard API proxas via en dedikerad specialtjänst (mikrotjänst).
{% endhint %}

### Inloggningsförfrågan 

{% code overflow="wrap" lineNumbers="true" %}

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

{% endcode %}

### Inloggningssvar

{% hint style="danger" %}
Token är en JWT med en livslängd på 30 minuter.\
\
Det är bästa praxis att lagra en enda token och återanvända den i alla förfrågningar, kontrollera dess utgångstid och hämta en ny token när den löper ut (eller strax innan).
{% endhint %}

```json
{
    "token": "<token_to_use_in_geopard_api>"
}
```

## Alternativ 2: OAuth 2.0

AWS Cognito stöder OAuth 2.0-protokollet för auktorisering. En allmän översikt beskrivs i artikeln [Cognito OAuth2-handbok](https://aws.amazon.com/ru/blogs/mobile/understanding-amazon-cognito-user-pool-oauth-2-0-grants/), underartikeln Authorization Code Grant är mest intressant i GeoPard-fallet.&#x20;

{% hint style="info" %}
Tillvägagångssättet ***rekommenderas för att integrera GeoPard på användargränssnittet (FrontEnd)-nivå***. Integrationen fungerar i båda riktningarna för att skicka/motta data till/från GeoPard.
{% endhint %}

Kortfattat:

1. Din applikation måste omdirigera en användare till GeoPard Cognito för inloggning eller registrering.&#x20;

Exempel:

{% code overflow="wrap" lineNumbers="true" %}

```bash
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
'
```

{% endcode %}

Vänligen kontakta GeoPard-teamet för att få din applikations individuella `client_id`.

2. Den omdirigerade URL:en kommer att ta emot en verifierings `kod` för nästa steg.

Den omdirigerade URL:en ser ut som [`http://localhost:8080/?code=eb10956a-6d51-49e5-bbfe-9815e3fdc70a&state=54321`](http://localhost:8080/?code=eb10956a-6d51-49e5-bbfe-9815e3fdc70a\&state=54321).

3. Din applikation måste byta ut `kod` för `tokens` (`access_token`, `refresh_token`, `id_token`).

Exempel:

{% code overflow="wrap" lineNumbers="true" %}

```bash
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
'
```

{% endcode %}

## Alternativ 3: API-nyckel

Snabb åtkomst till WMS och WFS är ibland nödvändig. Därför är det möjligt att använda GeoPards API-nyckel som automatiskt genereras för varje konto.

API-nyckeln finns i `apiKey` attributet i GraphQL-entiteten "UserData". Instruktioner om hur man hämtar  `apiKey` ges [HÄR](https://docs.geopard.tech/geopard-tutorials/swe/api-dokument/oversikt-over-forfragningar/38.-fraga-hamta-anvandardata).

{% hint style="danger" %}
`apiKey` måste användas med `/geo` endpoints ENDAST.
{% endhint %}

Användning:

1. Som en `geopardApiKey` parameter i GET-förfrågans URL.
2. Som en `X-API-Key` header i VALFRI förfrågan.<br>