Tokens de agente

Um token permite que um agente aja por si, nunca com mais do que a sua função.

A maioria dos agentes inicia sessão no navegador e não precisa de token (veja Ligar o seu agente). Use um token para CI, máquinas remotas e agentes que não conseguem abrir um navegador.

  • Um token por dispositivo ou agente, com uma etiqueta como ci ou cursor-work. Os tokens começam por sst_.
  • É mostrado uma única vez, ao ser criado. O SDD Vault guarda apenas um hash.
  • Os tokens só de leitura agem como leitor em todos os projetos; os de leitura e escrita agem com a sua função. Nenhum pode mais do que você, e a constituição continua reservada aos proprietários.
  • Um token abrange toda a organização ou os projetos que escolher.
  • Os tokens expiram: a duração é obrigatória e a organização pode definir um máximo (sddvault org security set <ORG> --token-max-days <DAYS>).
  • Podem ser revogados a qualquer momento; os agentes que os usam ficam desligados na chamada seguinte.

Criar um

Na aplicação, abra Tokens de agente. Ou use a CLI:

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

O sddvault tokens list lista os seus tokens e o sddvault tokens revoke <ID> revoga um. A aplicação mostra quando, de onde e com que cliente cada token foi usado pela última vez.

Usá-lo

Envie-o como Authorization: Bearer sst_…, ou guarde-o na variável de ambiente SDD_VAULT_TOKEN e referencie-a na sua configuração MCP.

Terminal
export SDD_VAULT_TOKEN=sst_...

O sddvault init --token escreve um token na configuração dos agentes que não conseguem iniciar sessão no navegador; acrescente --read para o tornar só de leitura.

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