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

# Accesso per agenti AI: far agire per gli utenti i loro agenti AI

> Con Didit gli utenti autorizzano agenti AI ad agire per loro in sessioni limitate, a scadenza automatica e revocabili in qualsiasi momento.

Didit Authentication consente alle persone che usano la tua app di approvare i propri agenti AI perché agiscano per loro. La persona vede che cosa chiede l'agente, lo approva, e l'agente ottiene una sessione propria con ambito limitato, che termina automaticamente e che la persona o il tuo team possono revocare in qualsiasi momento. Il tuo backend distingue la richiesta di un agente da quella della persona tramite il claim `act` nel token.

L'accesso per agenti è incluso in ogni piano, senza un prezzo separato.

## Come funziona

1. Un agente AI chiede di agire per conto di una persona nella tua applicazione, indicando gli scope di cui ha bisogno.
2. La persona accede alla schermata di approvazione ospitata dalla tua applicazione, oppure alla tua schermata di consenso, e vede il nome dell'agente, se è verificato e cosa richiede.
3. La persona può restringere la richiesta (meno scope, una sessione più breve, solo alcune delle sue [organizzazioni](https://docs.didit.me/it/authentication/organizations.md)), poi approva, con una passkey appena utilizzata quando le tue impostazioni la richiedono.
4. L'agente riceve un codice monouso e lo scambia con i propri token. I suoi token di accesso durano al massimo 5 minuti, come quelli di una persona.
5. Ogni richiesta che l'agente invia al tuo backend include un token il cui claim `act` indica l'agente e gli scope approvati dalla persona.

La sessione dell'agente termina quando scade la sua durata, dopo il tuo timeout di inattività, oppure quando la persona o il tuo team la revoca.

## Attiva e scegli le regole

L'accesso degli agenti è disattivato per una nuova applicazione.
Attivalo in **Authentication > Agent access**, quindi scegli **Edit settings**:

| Impostazione | Opzioni | Predefinito |
| - | - | - |
| Cosa possono fare gli agenti | **Read only** (`read`): visualizzare le informazioni sull'account della persona. **Acts for them** (`act`): modificare le impostazioni e le preferenze dell'account della persona. | Nessuna finché non ne scegli una |
| Quali agenti possono chiedere | Oggi qualsiasi agente può chiedere, e la schermata di approvazione mostra se è verificato. Consentire solo agenti verificati non è ancora disponibile. | Qualsiasi agente |
| Quanto dura una sessione | 1, 7 o 30 giorni. | 7 giorni |
| Termina dopo inattività di | 30 minuti, 2 ore o 24 ore. | 2 ore |
| Come approvano le persone | **Una passkey**, oppure **Il loro accesso abituale**. | Una passkey |
| Solo le persone approvano le richieste degli agenti | Ogni approvazione richiede una nuova asserzione dalla passkey della persona che approva. | Disattivato |

Nella schermata di approvazione, le persone possono disattivare qualsiasi ambito che offri, ma non attivarlo: non possono mai attivarne uno.
Le modifiche si applicano alle nuove approvazioni: le sessioni degli agenti attive mantengono ciò che la persona ha approvato.

L'impostazione **Solo le persone approvano le richieste degli agenti** (`agent_humans_only`) può essere modificata solo da un Owner o un Admin della tua organizzazione Didit, che deve prima avere una passkey sul proprio account della console.
Dimostra che la persona che approva ha usato il proprio autenticatore con verifica dell'utente, entro cinque minuti, e che tale verifica era associata a quella richiesta; non rileva l'automazione in generale.
Per la tua schermata di consenso, le chiamate sono descritte in [approvazione dell'agente con una passkey](https://docs.didit.me/it/authentication/sign-in-methods.md#approvazione-dell’agente-con-una-passkey).

## Aggiungilo alla tua app

Gli agenti che lo supportano inviano autonomamente le persone alla tua schermata di approvazione. La tua app fa due cose:

**Consenti alle persone di vedere e revocare i propri agenti.**
In React, esegui il rendering di `<ConnectedAgents />` nella pagina delle impostazioni dell'account: mostra l'elenco degli agenti approvati dalla persona, ciascuno con un pulsante **Revoke**.
Consulta la [guida introduttiva di React](https://docs.didit.me/it/authentication/quickstarts/react.md).

**Verifica il claim `act` sul tuo backend.**
Il token di accesso di un agente è firmato con la stessa chiave e contiene gli stessi `typ`, `iss` e `aud` di quello di una persona, quindi solo `act` li distingue:

| `act` | Chi chiama | Cosa consentire |
| - | - | - |
| `null` | La persona. | Ciò che la persona può fare. |
| `{"sub", "agent", "scopes"}` | Un agente AI che agisce per conto della persona. | Solo ciò che concede `act.scopes`, sulle route che apri agli agenti. Rifiutalo in tutti gli altri casi. |

`sid` nel token di un agente è l'ID dell'accesso concesso dalla persona, e `GET /session/` rifiuta sempre il token di un agente.
Consulta [verifica un token sul tuo server](https://docs.didit.me/it/authentication/tokens-and-jwks.md#verifica-un-token-sul-tuo-server) per i controlli nel codice.

## Monitorare e revocare nella console

**Authentication > Agent access** mostra:

* **At a glance:** sessioni attive degli agenti, sessioni approvate dalle persone negli ultimi 7 giorni, persone con un agente e revoche del mese corrente, per persone e per il tuo team.
* **Active agent sessions:** ogni persona, l'agente con la sua descrizione e se è verificato, cosa può fare, la sua ultima attività e quando termina, con un pulsante **Revoke**.

![La pagina Agent access nella Didit Business Console, con le impostazioni dell'agente, le metriche principali e le sessioni attive degli agenti con un pulsante 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.

Revocare termina subito la sessione dell'agente, e puoi inviare alla persona un'email per informarla che la sessione è stata terminata.
Il tuo team può anche terminare tutte le sessioni degli agenti di una persona: bloccare una persona, reimpostare il suo MFA o revocare le sue sessioni da **Users** revocano anche il suo accesso all'agente.

## Email ed eventi

Quando il tuo team revoca l'accesso di un agente dalla console, puoi scegliere di inviare alla persona un'email per informarla che l'accesso è terminato.
L'email usa il tuo brand, come ogni [email di accesso](https://docs.didit.me/it/authentication/branding-and-custom-domain.md#email-di-accesso).

Approvazioni e revoche vengono registrate come eventi `security.agent_access_approved` e `security.agent_access_revoked` nella timeline della persona.
Didit registra un'approvazione nel momento in cui la persona fornisce il consenso, anche se l'agente non scambia mai il proprio codice.
Vedi [audit delle approvazioni dell'agente](https://docs.didit.me/it/authentication/events-and-webhooks.md#registro-di-audit-delle-approvazioni-dell’agente).


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