Zum Inhalt springen

Anmeldung und API-Schlüssel

Wie sich Menschen, Skripte und KI-Clients bei demi anmelden, und wie du Schlüssel sicher verwaltest.

LiveStand: 9. November 2026

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.

Text
Einstellungen › API-Schlüssel › Neuer Schlüssel  Name:    CI Export  Rechte:  Lesen, Schreiben oder Agenten ausführen  Ablauf:  nie, 30, 90 oder 365 Tage

Schlüssel verwenden

Schick den Schlüssel als Bearer-Token im Header Authorization:

Terminal
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

Terminal
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:

Terminal
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 401 ab.
  • 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.

Dein Konfigurator

Noch keine Anwendungsfälle

Dein Konfigurator ist noch leer

Füge einen Anwendungsfall hinzu, auf jeder Karte und jeder Fallseite, und sieh, was er pro Jahr bringt, mit der Rechnung dazu. Kostenlos, ohne Anmeldung, unverbindlich: probier es aus und ändere jede Zahl.

Anwendungsfälle ansehen