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

# Token di accesso personali

> Autenticati come utente per l'accesso programmatico all'API

<div id="overview">
  ## Panoramica
</div>

I token di accesso personale (PAT) consentono agli utenti umani di autenticarsi a livello di codice con la propria identità. A differenza delle API key dell'utente di servizio (che autenticano come un utente di servizio non umano), un token di accesso personale autentica come **te** — l'utente umano che ha creato il token.

| Tipo di token                  | Si autentica come              | Identità                           | Autorizzazioni                                  |
| ------------------------------ | ------------------------------ | ---------------------------------- | ----------------------------------------------- |
| **API Key utente di servizio** | Utente di servizio (non umano) | L'identità dell'utente di servizio | Il ruolo assegnato all'utente di servizio       |
| **Token di accesso personale** | Utente (umano)                 | La tua identità utente             | Le tue autorizzazioni e le org di cui fai parte |

Tutte le credenziali API usano il formato con prefisso `cog_`. Entrambi i tipi di token vengono usati nello stesso modo nell'header `Authorization`:

```bash theme={null}
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $YOUR_PAT"
```

<div id="when-to-use-pats">
  ## Quando usare i PAT
</div>

I PAT sono pensati per gli scenari in cui ti serve un accesso programmatico all'API **a tuo nome**:

* **Script e strumenti personali** — automatizza i tuoi flussi di lavoro senza un utente di servizio condiviso
* **Sviluppo locale** — testa le integrazioni API usando il tuo account
* **Automazione di breve durata** — script una tantum che devono essere attribuiti a te

Per le integrazioni in produzione, le pipeline CI/CD e l'automazione condivisa, usa invece le [API key degli utenti di servizio](/it/api-reference/authentication#service-users-recommended-for-automation). Gli utenti di servizio offrono tracce di audit migliori, gestione centralizzata delle chiavi e controlli RBAC.

<div id="creating-and-managing-pats">
  ## Creazione e gestione dei PAT
</div>

Gestisci i tuoi PAT dalla scheda **PATs** nella pagina Settings di **Devin API**.

1. **Crea un PAT** — assegnagli un nome e una data di scadenza. Il token inizia con `cog_` e viene visualizzato una sola volta, al momento della creazione.
2. **Usa il token** nell'header `Authorization` — esattamente come un'API key di un utente di servizio. Ogni chiamata API viene autenticata con il tuo account utente: si applicano le tue autorizzazioni, le tue appartenenze alle org e il tuo audit trail.
3. **Ruota un PAT** — genera un nuovo segreto per un token esistente senza modificarne il nome; il vecchio segreto smette immediatamente di funzionare.
4. **Revoca un PAT** — invalida il token in qualsiasi momento.

I PAT sono accettati anche dagli endpoint in tempo reale, come l'ACP live WebSocket; pertanto, strumenti come Devin CLI e i client desktop possono autenticarsi con un PAT.

<div id="enterprise-governance">
  ## Governance Enterprise
</div>

Per gli account Enterprise, la disponibilità dei PAT è regolata da una **policy PAT** a livello Enterprise, applicata a tutte le organizzazioni dell'Enterprise. Gli amministratori Enterprise configurano la policy nella scheda **Policy PAT** della pagina delle Settings di **Devin API** dell'Enterprise.

<div id="policy-modes">
  ### Modalità delle policy
</div>

| Modalità                       | Comportamento                                                                                                                  |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| **Disabilitata** (predefinita) | I membri non possono creare né utilizzare PAT                                                                                  |
| **Approvazione richiesta**     | I membri inviano una richiesta per un PAT; un amministratore Enterprise deve approvarla prima che il token possa essere creato |
| **Self-service**               | I membri possono creare direttamente PAT, nel rispetto delle policy di scadenza                                                |

<div id="expiration-policy">
  ### Policy di scadenza
</div>

Quando i PAT sono abilitati per un account Enterprise, ogni PAT **deve avere una data di scadenza**, entro la durata massima prevista dalla policy (**365 giorni** per impostazione predefinita; gli amministratori possono configurare un limite più breve). Gli account non Enterprise (Teams) possono creare PAT senza scadenza.

<div id="approval-workflow">
  ### Flusso di approvazione
</div>

Con **Approvazione richiesta**:

1. Un membro richiede un PAT dalla scheda PAT (nome + scadenza).
2. Gli amministratori Enterprise visualizzano la richiesta nella **coda di approvazione** e la approvano o la rifiutano.
3. Dopo l'approvazione, il membro completa la richiesta per generare il token (visualizzato una sola volta).
4. Le richieste in attesa scadono automaticamente dopo **7 giorni** se non vengono gestite.

I richiedenti e gli amministratori ricevono notifiche via email in ogni fase del ciclo di vita del token (richiesto, approvato, rifiutato, revocato).

<div id="token-inventory-and-revocation">
  ### Inventario e revoca dei token
</div>

Gli amministratori Enterprise possono:

* **Visualizzare tutti i PAT** dell'Enterprise nell'inventario dei token, incluso lo stato di conformità alla policy corrente
* **Revocare in blocco** i token (ad es. dopo aver reso più restrittiva la policy)

Rendere più restrittiva la policy (o disabilitare i PAT) annulla le richieste in sospeso interessate e l'inventario segnala i token esistenti che non sono più conformi.

<div id="automatic-revocation">
  ### Revoca automatica
</div>

I PAT di un utente vengono revocati automaticamente quando l'utente non fa più parte dell'account, anche in caso di rimozione tramite deprovisioning SCIM o modifiche ai gruppi IdP.

<div id="security-considerations">
  ## Considerazioni sulla sicurezza
</div>

* Tratta i PAT con la stessa cura riservata alle password: forniscono pieno accesso al tuo account
* Conserva i PAT nelle variabili d'ambiente o in un gestore di segreti, mai nel codice sorgente
* Imposta la scadenza più breve adatta al tuo caso d'uso
* Revoca immediatamente i PAT se risultano compromessi
* Per qualsiasi automazione condivisa o di produzione, preferisci le API key di un utente di servizio

<div id="next-steps">
  ## Passaggi successivi
</div>

* [Panoramica dell'autenticazione](/it/api-reference/authentication) — comprendere l'intero modello di autenticazione
* [Guida rapida di Teams](/it/api-reference/getting-started/teams-quickstart) — iniziare a usare gli utenti di servizio