Authentifizierung
km_-API-Tokens für die REST-API, den MCP-Server von kanman und den Self-hosted Runner anlegen, verwenden und widerrufen.
API-Tokens authentifizieren deine Werkzeuge gegenüber kanman: die REST-API, den MCP-Server von kanman für die lokale Arbeit in Claude Code oder Codex und den Self-hosted Runner.
Token-Format
- Beginnt mit
km_ - Insgesamt 35 Zeichen:
km_plus 32 Zufallszeichen - Beispiel:
km_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdef
Ein Token anlegen
- Öffne im Avatar-Menü Deine Einstellungen und wähle API-Tokens (
/account/api-tokens). - Klicke auf Token erstellen.
- Gib unter Token-Name an, wo das Token genutzt wird, zum Beispiel „Laptop Anna“ oder „Ops-Runner“.
- Wähle unter Workspace den Workspace, in dem das Token gilt. Ein Token liest und handelt nur in diesem einen Workspace.
- Wähle unter Berechtigungen, was das Token darf. Für ein neues Token sind Lesen und Schreiben gewählt; mindestens eine Berechtigung ist nötig.
- Wähle unter Läuft ab 30 Tage, 90 Tage oder 1 Jahr. Jedes Token läuft ab; ein Jahr ist das Maximum.
- Klicke auf Token erstellen.
Lässt sich das Token nicht erstellen, bleibt das Formular offen und sagt es, sodass du es erneut versuchen kannst. Das Token wird genau einmal angezeigt. Kopiere es und leg es sofort in deinem Secret-Manager ab.
Tokens sind persönlich: Ein Token gehört der Person, die es angelegt hat, andere Mitglieder können es weder sehen noch nutzen, und es erreicht nur Daten des Workspaces, den du dafür gewählt hast.
Berechtigungen
| Berechtigung | In der App angezeigt als | REST-API |
|---|---|---|
read |
Lesen | Alle GET-Endpunkte. Für das Audit-Log braucht es zusätzlich das Token eines Owners oder Admins des Workspaces. |
write |
Schreiben | Entscheidungen beantworten (POST /v1/decisions/{key}/resolve) und alles, was stories:create, stories:comment und stories:start erlauben. |
stories:create |
Stories anlegen | Stories anlegen; sie gehen durch kanmans Aufnahme (POST /v1/teams/{team}/stories). |
stories:comment |
Kommentieren | Stories kommentieren (POST /v1/stories/{key}/comments). |
stories:start |
Starten und stoppen | Arbeit an einer Story starten und stoppen (POST /v1/stories/{key}/start, /stop). |
stories:ready |
Direkt in Ready | Stories direkt in Ready anlegen, ohne kanmans Aufnahme ("ready": true). Schreiben enthält das nicht. |
delete |
Löschen | Reserviert. Noch kein Endpunkt löscht Daten. |
admin |
Admin | Alles, was die anderen Berechtigungen erlauben. |
Die REST-API prüft die Berechtigung jedes Endpunkts und antwortet mit 403, wenn sie dem Token fehlt. Ein Token handelt mit den Rechten der Person, die es erstellt hat: Es funktioniert nicht mehr, wenn diese Person den Workspace verlässt oder der Workspace gelöscht wird. Der MCP-Server und der Self-hosted Runner akzeptieren jedes aktive, nicht abgelaufene Token des Workspaces, unabhängig von seinen Berechtigungen.
Das Token verwenden
Sende es im Header Authorization. Für die REST-API:
curl "https://api.kanman.ai/functions/v1/api-gateway/v1/decisions?status=pending" \
--header "Authorization: Bearer $KANMAN_API_KEY"
Für den MCP-Server in CI oder einem Skript (Menschen melden sich stattdessen im Browser an, siehe kanman in Claude Code oder Codex nutzen):
claude mcp add --transport http kanman \
https://api.kanman.ai/functions/v1/mcp \
--header "Authorization: Bearer $KANMAN_API_KEY"
Dem Self-hosted Runner übergibst du es als KANMAN_API_KEY; siehe Self-hosted Runner.
Eigenschaften eines Tokens
Die Liste unter Deine Einstellungen > API-Tokens zeigt pro Token:
| Eigenschaft | Beschreibung |
|---|---|
| Name | Der Name, den du gewählt hast |
| Workspace | Der Workspace, in dem das Token gilt |
| Präfix | Die ersten 11 Zeichen, um das Token wiederzuerkennen |
| Berechtigungen | Die erteilten Berechtigungen |
| Zuletzt benutzt | Zeitpunkt der letzten Anfrage, oder „Nie benutzt“ |
| Läuft ab | Ablaufdatum; abgelaufene Tokens werden abgelehnt |
Ablauf
Wähle die kürzeste passende Laufzeit. Leg vor dem Ablauf das neue Token an, stell deine Integration um und widerrufe dann das alte.
Ein Token widerrufen
- Öffne Deine Einstellungen > API-Tokens.
- Such das Token über Name oder Präfix.
- Klicke auf Widerrufen und bestätige.
Ein widerrufenes Token funktioniert sofort nicht mehr. Wenn du das Token eines Self-hosted Runners widerrufst, geht dieser Runner offline.
Gute Praxis
- Committe niemals Tokens. Halte sie in Umgebungsvariablen oder einem Secret-Manager.
- Leg pro Rechner oder Integration ein eigenes Token an, damit du eines widerrufen kannst, ohne die anderen zu stören.
- Prüfe ab und zu Zuletzt benutzt und widerrufe Tokens, die niemand nutzt.
- Leg Tokens nicht in Browser-Code ab und teile sie nicht zwischen Personen.
Fehler
Ein fehlendes, unbekanntes, widerrufenes oder abgelaufenes Token wird mit HTTP 401 beantwortet. Siehe Fehler und Rate Limits.
Zuletzt aktualisiert: January 1, 0001
kanman öffnen