Token degli agenti

Un token permette a un agente di agire per te, mai con più del tuo ruolo.

La maggior parte degli agenti accede dal browser e non ha bisogno di un token (vedi Collega il tuo agente). Usa un token per CI, macchine remote e agenti che non possono aprire un browser.

  • Un token per dispositivo o agente, con un’etichetta come ci o cursor-work. I token iniziano con sst_.
  • Viene mostrato una sola volta, alla creazione. SDD Vault ne conserva solo un hash.
  • I token di sola lettura agiscono come lettore in ogni progetto; quelli di lettura e scrittura agiscono con il tuo ruolo. Nessuno può più di te, e la costituzione resta riservata ai proprietari.
  • Un token copre l’intera organizzazione o i progetti che scegli.
  • I token scadono: la durata è obbligatoria e l’organizzazione può fissare un massimo (sddvault org security set <ORG> --token-max-days <DAYS>).
  • Possono essere revocati in qualsiasi momento; gli agenti che li usano vengono disconnessi alla chiamata successiva.

Crearne uno

Nell’app apri Token degli agenti. Oppure usa la CLI:

Terminale
sddvault tokens create acme --label ci --days 30 --read-only --project payments

sddvault tokens list elenca i tuoi token e sddvault tokens revoke <ID> ne revoca uno. L’app mostra quando, da dove e con quale client ogni token è stato usato l’ultima volta.

Usarlo

Invialo come Authorization: Bearer sst_…, oppure tienilo nella variabile d’ambiente SDD_VAULT_TOKEN e richiamala dalla tua configurazione MCP.

Terminale
export SDD_VAULT_TOKEN=sst_...

sddvault init --token scrive un token nella configurazione degli agenti che non possono accedere dal browser; aggiungi --read per renderlo di sola lettura.

Terminale
sddvault init acme/payments --token --read