> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# AIエージェント認証：ユーザーのAIエージェントによる代理アクセス

> Didit を使うと、ユーザーは自分の AI エージェントにアプリ内での代理操作を承認でき、期限で自動的に終了し、本人またはチームがいつでも取り消せるスコープ付きセッションで実行できます。

Didit Authenticationのエージェントアクセスでは、アプリのユーザーが自分のAIエージェントに、自分の代わりとして行動することを承認できます。
ユーザーはエージェントが要求する内容を確認して承認します。エージェントは権限を限定した独自のセッションを受け取ります。このセッションは自動的に終了し、ユーザーまたはお客様のチームはいつでも取り消せます。
バックエンドは、トークン内の`act`クレームによって、エージェントからのリクエストとユーザー本人からのリクエストを区別できます。

エージェントアクセスはすべてのプランに含まれており、別途の料金はかかりません。

## 仕組み

1. AIエージェントが、お客様のアプリケーション内でユーザーの代わりに操作する許可を求め、必要なスコープを指定します。
2. ユーザーは、お客様のアプリケーションのホスト型承認画面、またはお客様独自の同意画面でサインインし、エージェントの名前、検証済みかどうか、要求しているスコープを確認します。
3. ユーザーは要求を絞り込めます（スコープを減らす、セッションの有効期間を短くする、[組織](https://docs.didit.me/ja/authentication/organizations.md)の一部のみを選ぶなど）。そのうえで承認します。設定で求められている場合は、パスキーによる再認証も行われます。
4. エージェントは単回使用のコードを受け取り、それを自身のトークンと交換します。そのアクセストークンの有効期間は最長5分で、ユーザーの場合と同じです。
5. エージェントがお客様のバックエンドに送信するすべてのリクエストには、`act`クレームを含むトークンが付与されます。そのクレームには、エージェントと、ユーザーが承認したスコープが記載されています。

エージェントのセッションは、有効期間が過ぎたとき、アイドルタイムアウト後、またはユーザーもしくはお客様のチームが取り消したときに終了します。

## 有効化とルールの選択

エージェントアクセスは、新しいアプリケーションでは無効になっています。
**Authentication > Agent access** で有効にしてから、**Edit settings** を選択してください。

| 設定 | 選択肢 | デフォルト |
| - | - | - |
| エージェントに許可する操作 | **Read only** (`read`): 本人のアカウント情報を参照できます。 **Acts for them** (`act`): 本人のアカウント設定と環境設定を変更できます。 | 選択するまでは未設定 |
| どのエージェントがリクエストできるか | 現在は、どのエージェントでもリクエストできます。承認画面には、そのエージェントが検証済みかどうかが表示されます。検証済みエージェントのみに許可する機能は、まだ利用できません。 | 任意のエージェント |
| セッションの有効期間 | 1日、7日、30日。 | 7日 |
| 無操作の場合の終了条件 | 30分、2時間、24時間。 | 2時間 |
| 承認方法 | **A passkey** または **Their usual sign-in**。 | A passkey |
| 本人による承認のみ | エージェントのリクエストごとに、承認する本人自身のパスキーによる新しいアサーションが必要です。 | オフ |

本人は承認画面で、提供されている任意のスコープをオフにできます。オンにすることはできません。
設定の変更は新しい承認に適用されます。有効なエージェントセッションでは、本人が承認した内容が引き続き適用されます。

**Only people approve agent requests** (`agent_humans_only`) は、Didit の組織のオーナーまたは管理者のみが変更できます。変更する前に、そのユーザーが自身のコンソールアカウントにパスキーを登録している必要があります。
この設定は、承認する本人が自身の認証器をユーザー確認付きで使用したことを、5分以内かつそのリクエストに紐づけて証明します。ただし、自動化全般を検出するものではありません。
独自の同意画面を実装する場合の呼び出し方法は、[パスキーによるエージェント承認](https://docs.didit.me/ja/authentication/sign-in-methods.md#パスキーによるエージェントの承認)を参照してください。

## アプリに組み込む

対応しているエージェントは、自動的にユーザーを承認画面へ誘導します。
アプリでは次の2つを行います。

**ユーザーが自分のエージェントを確認・取り消しできるようにします。**
Reactでは、アカウント設定ページに`<ConnectedAgents />`を描画します。これにより、ユーザーが承認したエージェントが一覧表示され、それぞれに**Revoke**ボタンが表示されます。
[React クイックスタート](https://docs.didit.me/ja/authentication/quickstarts/react.md)をご覧ください。

**バックエンドで`act`クレームを確認します。**
エージェントのアクセストークンは、ユーザーのトークンと同じキーで署名され、同じ`typ`、`iss`、`aud`を持ちます。そのため、両者を区別できるのは`act`だけです。

| `act` | 呼び出し元 | 許可する内容 |
| - | - | - |
| `null` | ユーザー本人。 | ユーザー本人が実行できる操作。 |
| `{"sub", "agent", "scopes"}` | ユーザーの代理として動作するAIエージェント。 | エージェントに開放したルートで、`act.scopes`が付与する操作のみ。それ以外のすべてのルートでは拒否してください。 |

エージェントのトークンに含まれる`sid`は、ユーザーが付与したアクセスのIDです。`GET /session/`は、エージェントのトークンを常に拒否します。
コードでの検証方法は、[サーバーでトークンを検証する](https://docs.didit.me/ja/authentication/tokens-and-jwks.md#サーバーでトークンを検証する)をご覧ください。

## コンソールでの監視と取り消し

**Authentication > Agent access** には以下が表示されます:

* **概要:** 有効なエージェントセッション数、過去7日間にユーザーが承認したセッション数、エージェントを利用しているユーザー数、今月の取り消し件数を、ユーザー別およびお客様のチーム別に示します。
* **有効なエージェントセッション:** 各ユーザー、説明と検証済みかどうかを含むエージェント、エージェントができること、最終アクティビティ、セッションの終了時刻を表示します。各行には **Revoke** ボタンがあります。

![Didit Business ConsoleのAgent accessページ。エージェント設定、主要指標、有効なエージェントセッションとRevokeボタンが表示されています](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-agent-access.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=7cc518e37e2ccafa5515eb22e6ef9b8d)

Authentication > Agent access.

取り消すと、エージェントのセッションは直ちに終了します。そのことをユーザーにメールで通知することもできます。

チームは、1人のユーザーのエージェントセッションをすべて終了することもできます。**Users** からユーザーをブロックする、MFAをリセットする、セッションを取り消すと、そのユーザーのエージェントアクセスも取り消されます。

## メールとイベント

チームがコンソールからエージェントのアクセス権を取り消した場合、そのアクセスが終了したことを本人にメールで通知するかどうかを選択できます。
このメールには、すべての[サインインメール](https://docs.didit.me/ja/authentication/branding-and-custom-domain.md#サインインメール)と同様に、お客様のブランドが使用されます。

承認と取り消しは、本人のタイムラインに`security.agent_access_approved`および`security.agent_access_revoked`イベントとして記録されます。
Didit は、エージェントがコードを一度も交換していない場合でも、本人が同意した時点で承認を記録します。
詳細は[エージェント承認の監査](https://docs.didit.me/ja/authentication/events-and-webhooks.md#エージェント承認の監査)をご覧ください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.