Tokens de agente

Un token permite que un agente actúe por ti, nunca con más que tu rol.

La mayoría de los agentes inician sesión en el navegador y no necesitan token (consulta Conecta tu agente). Usa un token para CI, máquinas remotas y agentes que no pueden abrir un navegador.

  • Un token por dispositivo o agente, con una etiqueta como ci o cursor-work. Los tokens empiezan por sst_.
  • Se muestra una sola vez, al crearlo. SDD Vault solo conserva un hash.
  • Los tokens de solo lectura actúan como lector en todos los proyectos; los de lectura y escritura actúan con tu rol. Ninguno puede más que tú, y la constitución sigue siendo solo para propietarios.
  • Un token cubre toda la organización o los proyectos que elijas.
  • Los tokens caducan: la duración es obligatoria y la organización puede fijar un máximo (sddvault org security set <ORG> --token-max-days <DAYS>).
  • Se pueden revocar en cualquier momento; los agentes que los usan quedan desconectados en su siguiente llamada.

Crear uno

En la aplicación, abre Tokens de agente. O usa la CLI:

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

sddvault tokens list lista tus tokens y sddvault tokens revoke <ID> revoca uno. La aplicación muestra cuándo, desde dónde y con qué cliente se usó cada token por última vez.

Usarlo

Envíalo como Authorization: Bearer sst_…, o guárdalo en la variable de entorno SDD_VAULT_TOKEN y haz referencia a ella desde tu configuración MCP.

Terminal
export SDD_VAULT_TOKEN=sst_...

sddvault init --token escribe un token en la configuración de los agentes que no pueden iniciar sesión en el navegador; añade --read para que sea de solo lectura.

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