Actions のエージェントコンテキスト

event.agent オブジェクトを使用して、Auth0 Actions でエージェントのアイデンティティとメタデータにアクセスします。

リクエストにエージェントにリンクされたクライアントが含まれる場合、Actions ランタイムは event.agent オブジェクトを公開します。エージェントが関与していない場合、このオブジェクトは存在しないため、既存の Actions コードには影響しません。

​

トリガー

event.agent は、次のトリガーで使用できます。

トリガー	event.agent が使用できる場合
credentials-exchange	クライアントに agent_id が設定されているクライアントクレデンシャルグラント。
post-login	クライアントに agent_id が設定されている認可コード、トークン交換、またはデバイスフロー。

​

event.agent オブジェクト

event.agent オブジェクトのスキーマは次のとおりです。

{
  "agent_id": "agt_72jbvv7LfRKYp59gtRLtkn",
  "agent_metadata": {
    "env": "prod"
  }
}

event.client は変更されず、リクエストを認証したリンク済みの OAuth クライアントを引き続き示します。

​

例: エージェントトークンのカスタムクレーム

credentials-exchange Action で event.agent を使用して、アクセストークンにエージェントのコンテキストを追加します。

exports.onExecuteCredentialsExchange = async (event, api) => {
  if (event.agent) {
    api.accessToken.setCustomClaim('agent_env', event.agent.agent_metadata?.env);
    api.accessToken.setCustomClaim('agent_id', event.agent.agent_id);
  }
};

Actions の作成について詳しくは、Write Your First Actionをご覧ください。