> ## 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-агентов: разрешите агентам пользователей действовать от их имени

> Didit позволяет пользователям одобрить AI-агентов, действующих от их имени, в ограниченной сессии с автозавершением и возможностью отзыва.

Агентский доступ в Didit Authentication позволяет пользователям вашего приложения разрешать своим ИИ-агентам действовать от их имени.
Пользователь видит, что запрашивает агент, одобряет запрос, и агент получает собственную сессию с ограниченным доступом. Эта сессия завершается автоматически, а пользователь или ваша команда могут отозвать её в любой момент.
Ваш бэкенд отличает запрос агента от запроса самого пользователя по параметру `act` в token.

Агентский доступ входит в каждый тариф, отдельной оплаты нет.

## Cómo funciona

1. Un agente de IA solicita actuar en nombre de una persona en tu aplicación e indica los permisos que necesita.
2. La persona inicia sesión en la pantalla de aprobación alojada de tu aplicación o en tu propia pantalla de consentimiento, y ve el nombre del agente, si está verificado y qué solicita.
3. La persona puede restringir la solicitud (menos permisos, una sesión más corta, solo algunas de sus [organizaciones](https://docs.didit.me/ru/authentication/organizations.md)) y luego aprobarla, con una nueva passkey cuando tu configuración la exija.
4. El agente recibe un código de un solo uso y lo intercambia por sus propios tokens. Sus tokens de acceso duran como máximo 5 minutos, igual que los de una persona.
5. Cada solicitud que el agente hace a tu backend incluye un token cuya claim `act` identifica al agente y los permisos que la persona aprobó.

La sesión del agente termina cuando se agota su duración, tras el tiempo de inactividad que hayas configurado, o cuando la persona o tu equipo la revocan.

## Включите доступ и выберите правила

Для нового приложения доступ агентов отключён.
Включите его в разделе **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 |
| Подтверждать запросы агентов могут только люди | Для каждого подтверждения требуется новое утверждение, созданное с помощью собственной passkey подтверждающего человека. | Выключено |

Люди могут отключить на экране подтверждения любую предложенную вами область доступа, но не могут включить её.
Изменения применяются к новым подтверждениям: активные сессии агентов сохраняют то, что человек уже подтвердил.

Настройку **Only people approve agent requests** (`agent_humans_only`) может изменить только Owner или Admin вашей организации в Didit, и для этого сначала нужен passkey в его учётной записи консоли.
Это подтверждает, что подтверждающий человек использовал собственный аутентификатор с проверкой пользователя; утверждение было создано в течение пяти минут и привязано к этому запросу. Она не определяет автоматизацию в целом.
Для собственного экрана согласия вызовы описаны в разделе [подтверждение агента с passkey](https://docs.didit.me/ru/authentication/sign-in-methods.md#одобрение-агента-с-помощью-ключа-доступа).

## Добавьте в приложение

Агенты, которые это поддерживают, сами отправляют пользователей на ваш экран подтверждения. Ваше приложение делает две вещи:

**Позвольте пользователям видеть и отзывать своих агентов.**
В React выведите `<ConnectedAgents />` на странице настроек аккаунта: он показывает агентов, которых пользователь одобрил, и у каждого есть кнопка **Отозвать**.
См. [быстрый старт для React](https://docs.didit.me/ru/authentication/quickstarts/react.md).

**Проверяйте утверждение `act` на вашем бэкенде.**
Токен доступа агента подписан тем же ключом и содержит те же `typ`, `iss` и `aud`, что и токен пользователя, поэтому отличить их можно только по `act`:

| `act` | Кто вызывает | Что разрешить |
| - | - | - |
| `null` | Сам пользователь. | То, что пользователю разрешено делать. |
| `{"sub", "agent", "scopes"}` | ИИ-агент, действующий от имени пользователя. | Только то, что предоставляет `act.scopes`, и только на маршрутах, открытых для агентов. Во всех остальных случаях отклоняйте такой запрос. |

`sid` в токене агента содержит идентификатор доступа, который предоставил пользователь. `GET /session/` всегда отклоняет токен агента.
Проверки в коде см. в разделе [Проверка токена на вашем сервере](https://docs.didit.me/ru/authentication/tokens-and-jwks.md#проверка-токена-на-вашем-сервере).

## Просмотр и отзыв в консоли

**Authentication > Agent access** показывает:

* **Сводка:** активные сессии агентов, сессии, которые пользователи одобрили за последние 7 дней, пользователи с агентом и отозванные доступы за этот месяц, в разбивке по пользователям и по вашей команде.
* **Active agent sessions:** каждый пользователь, агент с его описанием и признаком того, верифицирован ли он, что он может делать, его последняя активность и когда сессия завершится, а также кнопка **Revoke**.

![Страница Agent access в Didit Business Console с настройками агента, ключевыми показателями и активными сессиями агентов с кнопкой 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.

Отзыв немедленно завершает сессию агента, и вы можете отправить пользователю письмо о том, что сессия завершена.
Ваша команда также может завершить все сессии агентов одного пользователя: блокировка пользователя, сброс его MFA или отзыв его сессий в разделе **Users** также отзывает доступ пользователя к агенту.

## Письма и события

Когда ваша команда отзывает доступ агента из консоли, вы можете отправить пользователю письмо о прекращении доступа. Письмо оформлено в фирменном стиле вашей компании, как и каждое [письмо для входа](https://docs.didit.me/ru/authentication/branding-and-custom-domain.md#письма-для-входа).

Одобрения и отзывы доступа фиксируются как события `security.agent_access_approved` и `security.agent_access_revoked` в хронологии пользователя.
Didit записывает одобрение, когда пользователь даёт согласие, даже если агент так и не обменяет свой код.
Подробнее см. в разделе [аудит одобрения агента](https://docs.didit.me/ru/authentication/events-and-webhooks.md#аудит-одобрения-агента).


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