Access Token の発行 API

IdP は LINE WORKS が IdP のアクセストークンを発行するための API を作成します。ユーザーは API Request URL を LINE WORKS に登録します。

参考

• OAuth 2.0 による SSO 7～8
• OAuth 2.0 による API 認証 5～6

Developer Console > SSO > WORKS as SP の Access Token Return API に登録します。

図13 OAuth 2.0 による Access Token Return API の登録

注意

• Access Token の発行時、セッション満了時間は expires_in の値により設定されます。
• expires_in を設定していない場合、既定のログイン保持期間として、ウェブ ブラウザでは 24 時間、モバイルアプリおよび PC アプリでは 30 日に設定されます。

IdP は LINE WORKS からの API Request を受け取ったのち、認証システムで Authorization Code を検証してアクセストークンを発行し、Authorization Code を無効化します。その後、発行したアクセストークンを含め API Response を送信します。

API Request {#access-token-request}

LINE WORKS から Access Token Return API に送信されるリクエストは以下の通りです。

HTTP Request {#access-token-request-url}

POST {Access Token Return API Request URL}

注意

• Access Token Return API の Request URL には SSL (https) を使用してください。
• LINE WORKS のセキュリティポリシーにより、port 443 を使用する必要があります。

Header Parameters {#access-token-request-parameter}

Request Body {#access-token-request-body}

参考

• API 利用時、connection timeout は 1 秒、read timeout は 3 秒です。

Response {#access-token-response}

IdP は LINE WORKS からの API リクエストに対する応答を返します。

Header Parameters {#access-token-response-header}

Response Body {#access-token-response-body}

Error Response Body {#access-token-response-error-body}

Error Code {#access-token-response-error-code}