actクレームによって、エージェントからのリクエストとユーザー本人からのリクエストを区別できます。
エージェントアクセスはすべてのプランに含まれており、別途の料金はかかりません。
仕組み
- AIエージェントが、お客様のアプリケーション内でユーザーの代わりに操作する許可を求め、必要なスコープを指定します。
- ユーザーは、お客様のアプリケーションのホスト型承認画面、またはお客様独自の同意画面でサインインし、エージェントの名前、検証済みかどうか、要求しているスコープを確認します。
- ユーザーは要求を絞り込めます(スコープを減らす、セッションの有効期間を短くする、組織の一部のみを選ぶなど)。そのうえで承認します。設定で求められている場合は、パスキーによる再認証も行われます。
- エージェントは単回使用のコードを受け取り、それを自身のトークンと交換します。そのアクセストークンの有効期間は最長5分で、ユーザーの場合と同じです。
- エージェントがお客様のバックエンドに送信するすべてのリクエストには、
actクレームを含むトークンが付与されます。そのクレームには、エージェントと、ユーザーが承認したスコープが記載されています。
有効化とルールの選択
エージェントアクセスは、新しいアプリケーションでは無効になっています。 Authentication > Agent access で有効にしてから、Edit settings を選択してください。
本人は承認画面で、提供されている任意のスコープをオフにできます。オンにすることはできません。
設定の変更は新しい承認に適用されます。有効なエージェントセッションでは、本人が承認した内容が引き続き適用されます。
Only people approve agent requests (
agent_humans_only) は、Didit の組織のオーナーまたは管理者のみが変更できます。変更する前に、そのユーザーが自身のコンソールアカウントにパスキーを登録している必要があります。
この設定は、承認する本人が自身の認証器をユーザー確認付きで使用したことを、5分以内かつそのリクエストに紐づけて証明します。ただし、自動化全般を検出するものではありません。
独自の同意画面を実装する場合の呼び出し方法は、パスキーによるエージェント承認を参照してください。
アプリに組み込む
対応しているエージェントは、自動的にユーザーを承認画面へ誘導します。 アプリでは次の2つを行います。 ユーザーが自分のエージェントを確認・取り消しできるようにします。 Reactでは、アカウント設定ページに<ConnectedAgents />を描画します。これにより、ユーザーが承認したエージェントが一覧表示され、それぞれにRevokeボタンが表示されます。
React クイックスタートをご覧ください。
バックエンドでactクレームを確認します。
エージェントのアクセストークンは、ユーザーのトークンと同じキーで署名され、同じtyp、iss、audを持ちます。そのため、両者を区別できるのはactだけです。
エージェントのトークンに含まれる
sidは、ユーザーが付与したアクセスのIDです。GET /session/は、エージェントのトークンを常に拒否します。
コードでの検証方法は、サーバーでトークンを検証するをご覧ください。
コンソールでの監視と取り消し
Authentication > Agent access には以下が表示されます:- 概要: 有効なエージェントセッション数、過去7日間にユーザーが承認したセッション数、エージェントを利用しているユーザー数、今月の取り消し件数を、ユーザー別およびお客様のチーム別に示します。
- 有効なエージェントセッション: 各ユーザー、説明と検証済みかどうかを含むエージェント、エージェントができること、最終アクティビティ、セッションの終了時刻を表示します。各行には Revoke ボタンがあります。

Authentication > Agent access.
メールとイベント
チームがコンソールからエージェントのアクセス権を取り消した場合、そのアクセスが終了したことを本人にメールで通知するかどうかを選択できます。 このメールには、すべてのサインインメールと同様に、お客様のブランドが使用されます。 承認と取り消しは、本人のタイムラインにsecurity.agent_access_approvedおよびsecurity.agent_access_revokedイベントとして記録されます。
Didit は、エージェントがコードを一度も交換していない場合でも、本人が同意した時点で承認を記録します。
詳細はエージェント承認の監査をご覧ください。