Agent-Tokens

Ein Token lässt einen Agenten für dich handeln, nie mit mehr als deiner Rolle.

Die meisten Agenten melden sich im Browser an und brauchen kein Token (siehe Agenten verbinden). Nutze ein Token für CI, entfernte Rechner und Agenten, die keinen Browser öffnen können.

  • Ein Token pro Gerät oder Agent, mit einem Label wie ci oder cursor-work. Tokens beginnen mit sst_.
  • Es wird nur einmal angezeigt, beim Erstellen. SDD Vault speichert nur einen Hash davon.
  • Schreibgeschützte Tokens handeln in jedem Projekt als Reader; Lese-Schreib-Tokens handeln mit deiner Rolle. Keines kann mehr als du, und die Verfassung bleibt Eigentümern vorbehalten.
  • Ein Token deckt die ganze Organisation oder die Projekte ab, die du auswählst.
  • Tokens laufen ab: Die Laufzeit ist Pflicht, und die Organisation kann ein Maximum festlegen (sddvault org security set <ORG> --token-max-days <DAYS>).
  • Sie können jederzeit widerrufen werden; Agenten, die sie nutzen, werden beim nächsten Aufruf getrennt.

Eines erstellen

Öffne in der App Agent-Tokens. Oder nutze die CLI:

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

sddvault tokens list listet deine Tokens und sddvault tokens revoke <ID> widerruft eines. Die App zeigt, wann, von wo und mit welchem Client jedes Token zuletzt verwendet wurde.

Verwenden

Sende es als Authorization: Bearer sst_…, oder halte es in der Umgebungsvariable SDD_VAULT_TOKEN und verweise in deiner MCP-Konfiguration darauf.

Terminal
export SDD_VAULT_TOKEN=sst_...

sddvault init --token schreibt ein Token in die Konfiguration von Agenten, die sich nicht im Browser anmelden können; mit --read wird es schreibgeschützt.

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