Jetons d’agent

Un jeton permet à un agent d’agir pour vous, jamais avec plus que votre rôle.

La plupart des agents se connectent par le navigateur et n’ont pas besoin de jeton (voir Connecter votre agent). Utilisez un jeton pour la CI, les machines distantes et les agents qui ne peuvent pas ouvrir de navigateur.

  • Un jeton par appareil ou par agent, avec une étiquette comme ci ou cursor-work. Les jetons commencent par sst_.
  • Affiché une seule fois, à sa création. SDD Vault n’en conserve qu’une empreinte.
  • Les jetons en lecture seule agissent comme lecteur dans tous les projets ; les jetons en lecture-écriture agissent avec votre rôle. Aucun ne peut faire plus que vous, et la constitution reste réservée aux propriétaires.
  • Un jeton couvre toute l’organisation ou les projets que vous choisissez.
  • Les jetons expirent : la durée est obligatoire, et l’organisation peut fixer un maximum (sddvault org security set <ORG> --token-max-days <DAYS>).
  • Ils peuvent être révoqués à tout moment ; les agents qui les utilisent sont déconnectés à leur prochain appel.

En créer un

Dans l’application, ouvrez Jetons d’agent. Ou utilisez la CLI :

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

sddvault tokens list liste vos jetons et sddvault tokens revoke <ID> en révoque un. L’application indique quand, d’où et avec quel client chaque jeton a été utilisé pour la dernière fois.

L’utiliser

Envoyez-le sous la forme Authorization: Bearer sst_…, ou gardez-le dans la variable d’environnement SDD_VAULT_TOKEN et référencez-la depuis votre configuration MCP.

Terminal
export SDD_VAULT_TOKEN=sst_...

sddvault init --token écrit un jeton dans la configuration des agents qui ne peuvent pas se connecter par le navigateur ; ajoutez --read pour qu’il soit en lecture seule.

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