エンドポイント
POST /oauth/token
トークンベースの認証では、oauth/token エンドポイントを使用して、アプリケーションが保護された API に対して認証済みの呼び出しを行うためのアクセストークンを取得します。必要に応じて、ID トークンやリフレッシュトークンを取得することもできます。ID トークンには、アプリケーションが抽出してよりよいユーザー体験の提供に役立てられる、スコープの形のユーザー情報が含まれています。リフレッシュトークンを使用すると、現在のトークンの有効期限が切れたあとでも、ユーザー体験を損なうことなく、アプリケーションで新しいアクセストークンをリクエストできます。詳しくは、ID Tokens と Refresh Tokens を参照してください。
リフレッシュトークンを取得できる OAuth 2.0 フローは、次のものに限られます。
- Authorization Code Flow (Authorization Code)
- Authorization Code Flow with PKCE (Authorization Code with PKCE)
- Resource Owner Password
- Device Authorization Flow
- Token Exchange*
ヘッダー
リクエストボディのパラメータ
リクエストボディは
application/x-www-form-urlencoded 形式です。GET /authorize エンドポイントで設定している場合にのみ必要です。
/authorize で指定した値は、/oauth/token で設定する値と一致している必要があります。レスポンススキーマ
エージェントアクセストークン
認可コードを交換するアプリケーションがエージェントにリンクされ、対象 API でエージェントの subject クレームが有効になっている場合、発行されるアクセストークンには、ユーザーに代わって動作する actor としてエージェントが記録されます。subクレームは引き続きユーザー識別子です。エージェントのアイデンティティはsubではなくactクレームに示されます。actクレームはエージェントを識別します:{ "sub": "agt_72jbvv7LfRKYp59gtRLtkn", "sub_profile": "ai_agent", "client_id": "YOUR_CLIENT_ID", "iss": "https://YOUR_DOMAIN/" }。- トークンには
sub_profile: "user"と、たとえばweb_app ai_agentのようにai_agent接尾辞が付いたclient_profileが含まれます。