Identity as a Service：GenerateToken - 產生應用認證token

目前支援的方式：授權碼模式、裝置流、重新整理 token、用戶端模式、賬密模式。

1. 授權碼模式（Authorization Code）

適用情境：標準 OAuth 2.0 授權碼流程，適用於有前端互動的 Web 應用程式。 調用樣本：

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

grant_type=authorization_code
&code={授權碼}
&redirect_uri={回調地址}
&client_id={用戶端識別碼}
&client_secret={用戶端密鑰}

參數說明：

● code：通過授權端點擷取的授權碼。

● redirect_uri：必須與擷取 code 時使用的 redirect_uri 一致

1.1 公用用戶端下的授權碼模式

適用情境：適用於無法安全儲存密鑰的應用，如 SPA、原生應用。該流程中，無需使用 client_secret，但必須使用 PKCE 機制。調用樣本：

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

grant_type=authorization_code
&code={授權碼}
&redirect_uri={回調地址}
&client_id={用戶端識別碼}
&code_verifier={code_verifier}

參數說明：

● code_verifier：PKCE 機制中的驗證密鑰，用戶端在發起授權請求時產生，並用於派生 code_challenge。在換取 token 時，必須將此值原樣提交，且必須與產生 code_challenge 時使用的值一致。

code_verifier 和 code_challenge 產生的 Java 樣本：

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. 裝置流（Device Flow）。

適用情境：適用於電視、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={裝置碼}
&client_id={用戶端識別碼}
&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={裝置碼}
&client_id={用戶端識別碼}

3. 重新整理 Token（Refresh Token）。

適用情境：使用 refresh_token 擷取新的 access_token。調用樣本：

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

grant_type=refresh_token
&refresh_token={重新整理權杖}
&client_id={用戶端識別碼}
&client_secret={用戶端密鑰}

4. 用戶端模式（Client Credentials）。

適用情境：服務端間認證，無需使用者參與。調用樣本：

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

grant_type=client_credentials
&client_id={用戶端識別碼}
&client_secret={用戶端密鑰}
&scope={許可權範圍}

5. 賬密模式（Password）。

適用情境：傳統使用者名稱密碼認證（需謹慎使用）。調用樣本：

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

grant_type=password
&username={使用者名稱}
&password={密碼}
&client_id={用戶端識別碼}
&scope={許可權範圍}