demi kennt drei Arten, sich anzumelden. Alle drei enden beim selben Prinzip: Wer sich anmeldet, handelt mit genau den Rechten einer Person, nie mit mehr.
- Menschen im Terminal
- Browser-Anmeldung über den OAuth Device Flow:
demi auth login - Skripte und CI
- Persönlicher API-Schlüssel als Bearer-Token
- KI-Clients
- OAuth 2.1 über den MCP-Server, jede Person meldet sich selbst an
API-Schlüssel anlegen
Ein API-Schlüssel gehört immer zu einer Person und handelt mit ihren Rechten. Du legst ihn in der App oder in der CLI an.
Einstellungen › API-Schlüssel › Neuer Schlüssel Name: CI Export Rechte: Lesen, Schreiben oder Agenten ausführen Ablauf: nie, 30, 90 oder 365 Tagedemi me pats create "CI Export" --expires-at 2027-03-01T00:00:00ZSchlüssel verwenden
Schick den Schlüssel als Bearer-Token im Header Authorization:
curl https://api.godemi.com/v1/me/profile \ -H "Authorization: Bearer <your-api-key>"Schlüssel beginnen mit demi_pat_. So erkennen Secret-Scanner sie, falls einer doch in einem Repository landet.
In der CLI
printf '%s' "$DEMI_API_KEY" | demi auth login --api-key-stdinÜber --api-key-stdin landet der Schlüssel weder in der Shell-History noch in der Prozessliste. Die CLI liest ihn alternativ aus der Umgebungsvariable DEMI_API_KEY.
Mandanten wählen
Ein Schlüssel handelt in dem Mandanten, in dem er angelegt wurde. Bist du Mitglied in mehreren Mandanten, wählst du pro Anfrage einen anderen mit dem Header x-demi-tenant-id:
curl https://api.godemi.com/v1/tenants/current \ -H "Authorization: Bearer <your-api-key>" \ -H "x-demi-tenant-id: <workspace-id>"In der CLI wählst du den Mandanten mit demi config set-tenant @your-workspace oder pro Aufruf mit --tenant @your-workspace.
Ablauf und Widerruf
- Abgelaufene oder widerrufene Schlüssel lehnt die API mit
401ab. - Wird das Konto einer Person deaktiviert, gelten auch ihre Schlüssel nicht mehr.
- Widerrufen kannst du jeden Schlüssel jederzeit in der App unter Einstellungen › API-Schlüssel.
Anmeldung für KI-Clients
KI-Clients brauchen keinen Schlüssel. Sie melden sich über OAuth 2.1 am MCP-Server an: Der Client öffnet die demi-Anmeldung im Browser, du meldest dich an und wählst deinen Mandanten. Das Token bleibt im Client, nicht in einer Konfigurationsdatei. Mehr dazu: MCP-Server.
Empfehlungen
- Ein Schlüssel pro Skript. Dann kannst du einen einzeln widerrufen, ohne die anderen zu stören.
- Die kürzeste Laufzeit, die passt. 90 Tage sind für die meisten Skripte ein guter Wert.
- Nur die Rechte, die gebraucht werden. Ein Export braucht kein Schreibrecht.
- Nie im Code, nie im Prompt. Schlüssel gehören in einen Secret-Manager oder die Secrets deiner CI.
