エージェントをクライアントに関連付ける

1つ以上のクライアントをエージェントに関連付けると、それらのクライアントに発行されるトークンにエージェントのアイデンティティが含まれるため、帰属の確認と追跡が可能になります。

Auth0 のファーストクラスアイデンティティとして登録すると、任意の OAuth クライアントにエージェントを関連付けることができます。1 つのエージェントを複数のクライアントに関連付けることも可能です。環境やリージョンごとにクライアントを分ける場合など、複数のクライアントにわたるトークンとログで単一の agent_id を持つ、論理的に同一のエージェントアイデンティティを使用したい場合に便利です。

agent_id はクライアントオブジェクトに保存され、関連付けは動的に管理されます。

エージェントをクライアントに関連付けると、クライアントクレデンシャルグラントでは、そのクライアントに発行されるトークンにエージェントのアイデンティティがサブジェクト (sub) として含まれます。トークン交換および標準のログインフローでは、アクター (act) として含まれます。詳細については、トークン内のエージェントアイデンティティを参照してください。

external_agent_id を設定しているかどうかにかかわらず、内部 agent_id は Management API を通じてエージェントを管理するための識別子として使用されます。

​

クライアント作成時に関連付ける

POST /api/v2/clients でクライアントを作成する際に、agent_id を設定します。

curl --request POST \
  --url 'https://YOUR_AUTH0_DOMAIN/api/v2/clients' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN' \
  --data '{
    "name": "My AI Client",
    "agent_id": "YOUR_AGENT_ID"
  }'

成功すると、Auth0 は設定した agent_id を含むクライアントオブジェクトを返します。

​

エージェントに関連付けられたクライアントを取得する

agent_id をクライアントに関連付けた後、/api/v2/clients/{id} に GET リクエストを送信してクライアントオブジェクトを取得します。

curl --request GET \
  --url 'https://YOUR_AUTH0_DOMAIN/api/v2/clients/YOUR_CLIENT_ID' \
  --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN'

成功すると、Auth0 は設定した agent_id を含むクライアントオブジェクトを返します。

​

既存のクライアントを関連付ける

既存のクライアントは、Auth0 Dashboard または Management API を使用して関連付けることができます。

Auth0 Dashboard

1. Dashboard > Agents に移動し、エージェントを選択して、エージェントの Applications タブを選択します。
2. Add Application を選択し、モーダルでエージェントに関連付けるアプリケーションを選択します。複数のアプリケーションを選択できます。
3. Add Applications を選択します。

追加に成功すると、アプリケーションがエージェントの Applications タブに表示されます。

Management API

PATCH /api/v2/clients/{id} を使用して、既存のクライアントをエージェントに関連付けます。

curl --request PATCH \
  --url 'https://YOUR_AUTH0_DOMAIN/api/v2/clients/YOUR_CLIENT_ID' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN' \
  --data '{
    "agent_id": "YOUR_AGENT_ID"
  }'

成功すると、Auth0 は設定した agent_id を含む更新後のクライアントオブジェクトを返します。

​

エージェントとの関連付けを解除する

クライアントとエージェントの関連付けを解除するには、PATCH /api/v2/clients/{id} を使用して agent_id を null に設定します。

curl --request PATCH \
  --url 'https://YOUR_AUTH0_DOMAIN/api/v2/clients/YOUR_CLIENT_ID' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN' \
  --data '{
    "agent_id": null
  }'

関連付けを解除すると、以降クライアントに発行されるトークンにはagentのアイデンティティが含まれなくなります。既存のトークンは、有効期限が切れるまで有効です。

​

次のステップ

• Auth0 がトークンにエージェントのアイデンティティを埋め込む方法について学ぶ