> ## 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.

# Acceso de agentes: permite que los agentes de IA de tus usuarios actúen por ellos

> Con Didit, las personas aprueban a sus agentes de IA para actuar en tu app, en una sesión acotada que caduca sola y puede revocarse.

El acceso de agentes de Didit Authentication permite a las personas que usan tu aplicación aprobar sus propios agentes de IA para que actúen en su nombre.
La persona ve lo que pide el agente, lo aprueba, y el agente obtiene una sesión propia con alcance limitado que termina por sí sola y que la persona o tu equipo pueden revocar en cualquier momento.
Tu backend distingue la solicitud de un agente de la de la persona mediante la afirmación `act` del token.

El acceso de agentes está incluido en todos los planes, sin cargo adicional.

## Cómo funciona

1. Un agente de IA solicita actuar en nombre de una persona en tu aplicación e indica los ámbitos 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 ámbitos, una sesión más corta, solo algunas de sus [organizaciones](https://docs.didit.me/es/authentication/organizations.md)) y, a continuación, aprobarla. Si tu configuración lo exige, deberá usar una clave de acceso nueva para hacerlo.
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 afirmación `act` identifica al agente y los ámbitos que aprobó la persona.

La sesión del agente termina cuando se agota su tiempo de vida, cuando transcurre el tiempo de espera por inactividad configurado o cuando la persona o tu equipo la revocan.

## Actívalo y elige las reglas

El acceso de agentes está desactivado en las aplicaciones nuevas.
Actívalo en **Authentication > Agent access** y luego elige **Edit settings**:

| Configuración | Opciones | Valor predeterminado |
| - | - | - |
| Qué pueden hacer los agentes | **Solo lectura** (`read`): ver la información de la cuenta de la persona. **Actúa en su nombre** (`act`): cambiar la configuración y las preferencias de la cuenta de la persona. | Ninguno hasta que lo elijas |
| Qué agentes pueden hacer solicitudes | Hoy cualquier agente puede hacer la solicitud, y la pantalla de aprobación muestra si está verificado. Permitir solo agentes verificados todavía no está disponible. | Cualquier agente |
| Cuánto dura una sesión | 1, 7 o 30 días. | 7 días |
| Finaliza después de estar inactiva durante | 30 minutos, 2 horas o 24 horas. | 2 horas |
| Cómo aprueban las personas | **Una passkey** o **Su inicio de sesión habitual**. | Una passkey |
| Solo las personas pueden aprobar solicitudes de agentes | Cada aprobación requiere una aserción nueva de la passkey de la persona que aprueba. | Desactivado |

Las personas pueden desactivar cualquier permiso que les ofrezcas en la pantalla de aprobación, pero nunca activarlo.
Los cambios se aplican a las nuevas aprobaciones: las sesiones de agente activas mantienen lo que la persona aprobó.

**Solo las personas pueden aprobar solicitudes de agentes** (`agent_humans_only`) solo puede cambiarlo un propietario o administrador de tu organización de Didit, que primero necesita una passkey en su cuenta de la consola.
Demuestra que la persona que aprueba usó su propio autenticador con verificación de usuario, en un plazo de cinco minutos y vinculada a esa solicitud; no detecta la automatización en general.
Para tu propia pantalla de consentimiento, las llamadas están en [aprobación de agentes con una passkey](https://docs.didit.me/es/authentication/sign-in-methods.md#aprobación-de-agentes-con-passkey).

## Añádelo a tu aplicación

Los agentes que lo admiten envían a las personas a tu pantalla de aprobación por su cuenta.
Tu aplicación hace dos cosas:

**Permite que las personas vean y revoquen sus agentes.**
En React, renderiza `<ConnectedAgents />` en la página de configuración de la cuenta: muestra los agentes que la persona aprobó, cada uno con un botón **Revocar**.
Consulta el [inicio rápido de React](https://docs.didit.me/es/authentication/quickstarts/react.md).

**Comprueba el claim `act` en tu backend.**
El token de acceso de un agente se firma con la misma clave y tiene el mismo `typ`, `iss` y `aud` que el de una persona, así que solo `act` los distingue:

| `act` | Quién llama | Qué permitir |
| - | - | - |
| `null` | La persona. | Lo que la persona puede hacer. |
| `{"sub", "agent", "scopes"}` | Un agente de IA que actúa en nombre de la persona. | Solo lo que concede `act.scopes`, en las rutas que abras a los agentes. Recházalo en todas las demás. |

`sid` en el token de un agente es el ID del acceso que concedió la persona, y `GET /session/` siempre rechaza el token de un agente.
Consulta [verifica un token en tu servidor](https://docs.didit.me/es/authentication/tokens-and-jwks.md#verificar-un-token-en-tu-servidor) para ver las comprobaciones en código.

## Monitoriza y revoca en la consola

**Authentication > Agent access** muestra:

* **Resumen:** sesiones de agente activas, sesiones que las personas aprobaron en los últimos 7 días, personas con un agente y revocaciones de este mes, por personas y por tu equipo.
* **Sesiones de agente activas:** cada persona, el agente con su descripción y si está verificado, qué puede hacer, su última actividad y cuándo termina, con un botón **Revoke**.

![La página Agent access en la Didit Business Console, con la configuración del agente, las métricas clave y las sesiones de agente activas con un botón 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.

Al revocar, la sesión del agente termina de inmediato, y puedes enviar un correo electrónico a la persona para informarle de que ha terminado.
Tu equipo también puede terminar todas las sesiones de agente de una persona: bloquear a una persona, restablecer su MFA o revocar sus sesiones desde **Users** también revoca su acceso de agente.

## Correos electrónicos y eventos

Cuando tu equipo revoca el acceso de un agente desde la consola, puedes elegir enviar a la persona un correo electrónico que le informe de que el acceso ha terminado.
El correo usa tu marca, como cualquier [correo de inicio de sesión](https://docs.didit.me/es/authentication/branding-and-custom-domain.md#correos-de-inicio-de-sesión).

Las aprobaciones y las revocaciones se registran como eventos `security.agent_access_approved` y `security.agent_access_revoked` en la línea de tiempo de la persona.
Didit registra una aprobación cuando la persona da su consentimiento, aunque el agente nunca intercambie su código.
Consulta [auditoría de aprobaciones de agentes](https://docs.didit.me/es/authentication/events-and-webhooks.md#auditoría-de-aprobaciones-de-agentes).


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