:GenerateToken

次のメソッドがサポートされています: 認証コード、デバイスフロー、リフレッシュトークン、クライアントクレデンシャル、パスワード。

1. 認証コード

シナリオ：これは標準的な OAuth 2.0 認証コードフローであり、フロントエンドでのインタラクションを伴う Web アプリケーションに適しています。呼び出し例：

POST /v2/{instanceId}/{applicationId}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code
&code={authorization_code}
&redirect_uri={redirect_uri}
&client_id={client_id}
&client_secret={client_secret}

パラメーター：

● code: 認証エンドポイントから取得した認証コード。

● redirect_uri: 認証コードを取得するために使用された `redirect_uri` と同じである必要があります。

1.1 パブリッククライアントの認証コード

シナリオ：このシナリオは、シングルページアプリケーション (SPA) やネイティブアプリなど、シークレットを安全に保存できないアプリケーションに適しています。このフローでは `client_secret` は不要ですが、Proof Key for Code Exchange (PKCE) メカニズムを使用する必要があります。呼び出し例：

POST /v2/{instanceId}/{applicationId}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code
&code={authorization_code}
&redirect_uri={redirect_uri}
&client_id={client_id}
&code_verifier={code_verifier}

パラメーター：

● code_verifier: PKCE メカニズムのコードベリファイア。クライアントは認証リクエストを開始する際にこれを生成し、`code_challenge` を導出するために使用します。トークンと交換する際には、この値を送信する必要があります。これは `code_challenge` を生成するために使用された値と同一である必要があります。

Java で `code_verifier` と `code_challenge` を生成する例：

String codeVerifier = Base64.getUrlEncoder().withoutPadding().encodeToString(new SecureRandom().generateSeed(43));
String codeChallenge = Base64.getUrlEncoder().withoutPadding().encodeToString(java.security.MessageDigest.getInstance("SHA-256").digest(codeVerifier.getBytes()));

2. デバイスフロー

シナリオ：このシナリオは、TV や IoT デバイスなど、入力制約のあるデバイスに適しています。呼び出し例：

POST /v2/{instanceId}/{applicationId}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=urn:ietf:params:oauth:grant-type:device_code
&device_code={device_code}
&client_id={client_id}
&client_secret={client_secret}

デバイスコードを取得するには、まず /oauth2/device/code を呼び出して `device_code` と `user_code` を取得します。

2.1 パブリッククライアントのデバイスフロー

シナリオ：このシナリオは、対話型ログインが不便な場合や、クライアントがパブリッククライアントである場合に使用されます。呼び出し例：

POST /v2/{instanceId}/{applicationId}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=urn:ietf:params:oauth:grant-type:device_code
&device_code={device_code}
&client_id={client_id}

3. リフレッシュトークン

シナリオ：このシナリオでは、`refresh_token` を使用して新しいアクセストークンを取得します。呼び出し例：

POST /v2/{instanceId}/{applicationId}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token
&refresh_token={refresh_token}
&client_id={client_id}
&client_secret={client_secret}

4. クライアントクレデンシャル

シナリオ：このシナリオは、ユーザーの関与なしにサーバー間認証を行うためのものです。呼び出し例：

POST /v2/{instanceId}/{applicationId}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id={client_id}
&client_secret={client_secret}
&scope={scope}

5. パスワード

シナリオ：このシナリオでは、従来のユーザー名とパスワードによる認証を使用します。このメソッドは注意して使用してください。呼び出し例：

POST /v2/{instanceId}/{applicationId}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=password
&username={username}
&password={password}
&client_id={client_id}
&scope={scope}