# 認証：ApiKey、Credentials、またはOAuth 2.0

GeoPardソリューションは次を使用しています [AWS Cognito](https://docs.aws.amazon.com/en_us/cognito/latest/developerguide/what-is-amazon-cognito.html) 認証手順のために。

すべての認可オプションを確認することを推奨します。選択は特定のユースケースによります。各オプションの詳細な利用方法は以下に記載されています。

## オプション1: 資格情報の使用

「ユーザー名」と「パスワード」による認証は可能なアプローチの一つです。この場合、（ソーシャルネットワークを使わずに）メールでの登録が必要です。 

{% hint style="info" %}
このアプローチは ***API（バックエンド）レベルでの統合に推奨されます*** および GeoPard API へのすべてのリクエストは専用の特別なサービス（マイクロサービス）を介してプロキシされます。
{% endhint %}

### ログインリクエスト 

{% 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 %}

### ログインレスポンス

{% hint style="danger" %}
トークンは有効期間30分のJWTです。\
\
単一のトークンを保存してすべてのリクエストで再利用し、有効期限を確認して期限切れ（または期限直前）に新しいトークンを取得するのがベストプラクティスです。
{% endhint %}

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

## オプション2: OAuth 2.0

AWS Cognitoは認可のためのOAuth 2.0プロトコルをサポートしています。一般的な概要は記事に説明されています [Cognito OAuth2 マニュアル](https://aws.amazon.com/ru/blogs/mobile/understanding-amazon-cognito-user-pool-oauth-2-0-grants/), サブ記事の Authorization Code Grant が GeoPard の場合で最も興味深い項目です。&#x20;

{% hint style="info" %}
このアプローチは ***GeoPard をユーザーインターフェース（フロントエンド）レベルで統合することが推奨されます***&#x7D71;合は GeoPard への/からのデータ送受信の両方向で機能します。
{% endhint %}

要点を簡潔に：

1. あなたのアプリケーションはユーザーをログインまたは登録のために GeoPard Cognito にリダイレクトする必要があります。&#x20;

例：

{% 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 %}

アプリケーション固有の `client_id`.

2. を受け取るために GeoPard チームに接続してください `リダイレクトされたURLは次の検証用` code

を受け取ります。次のステップのために。 [`リダイレクトされたURLは次のようになります`](http://localhost:8080/?code=eb10956a-6d51-49e5-bbfe-9815e3fdc70a\&state=54321).

3. <http://localhost:8080/?code=eb10956a-6d51-49e5-bbfe-9815e3fdc70a\\&state=54321> `リダイレクトされたURLは次の検証用` のための `あなたのアプリケーションは下記を交換する必要があります` (`tokens`, `access_token`, `refresh_token`).

例：

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

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

{% endcode %}

## <http://localhost:8080>

オプション3: APIキー

WMS と WFS への迅速なアクセスが時折必要です。したがって、各アカウント用に自動生成される GeoPard API キーを使用することが可能です。 `APIキー` API キーは "UserData" GraphQL エンティティの  `APIキー` 属性で見つけることができます。取得方法に関する手順は [ここ](https://docs.geopard.tech/geopard-tutorials/jpn/apidokyumento/geopard-apirikuesuto/38-kueriuserdatawo).

{% hint style="danger" %}
`APIキー` で提供されています `は必ず` /geo
{% endhint %}

エンドポイントのみで使用してください。

1. 使用方法： `geopardApiKey` パラメーターとして GET リクエストの URL に。
2. ヘッダーとして `X-API-Key` 任意のリクエストのヘッダーに。<br>