ZEITLICHT
Zurück zur Übersicht

API und Integrationen

API-Schlüssel erstellen und widerrufen

Ich möchte …

… der Kommandozeile zl, Claude Code oder einer GitHub Action Zugriff auf die Aufgaben dieses Arbeitsbereichs geben und ihn wieder entziehen.

Bevor du startest

  • API-Schlüssel sind in der Beta. Nur Arbeitsbereiche, die an der Beta teilnehmen, zeigen API-Schlüssel.
  • Nur Inhaber und Admin sehen den Eintrag. Jeder Admin sieht alle Schlüssel des Arbeitsbereichs, auch die anderer Admins, und kann jeden widerrufen.
  • Zum Erstellen brauchst du selbst Ultra. Ohne Ultra kannst du Schlüssel trotzdem sehen und widerrufen.
  • Ein Schlüssel handelt als du: Was ein Werkzeug damit tut, zählt als deine Änderung. Behandle ihn so geheim wie ein Passwort.
  • Ein Arbeitsbereich hat höchstens 10 aktive Schlüssel, jede Person höchstens 5.

So geht's

  1. Öffne im Arbeitsbereich Einstellungen. Tippe im Abschnitt Arbeitsbereich auf API-Schlüssel (markiert mit Beta).
  2. Tippe auf API-Schlüssel erstellen. Ohne Ultra siehst du stattdessen einen Hinweis und Upgrade. Ist die Höchstzahl erreicht, widerrufe zuerst einen Schlüssel.
  3. Gib unter Name an, wofür der Schlüssel ist, zum Beispiel „GitHub Actions“ oder „Mein Laptop“. Höchstens 60 Zeichen.
  4. Wähle unter Boards entweder Alle Boards, auch neue oder Ausgewählte Boards und hake mindestens ein Board an (höchstens 30). Die übrigen Boards sieht der Schlüssel nie. Tags und Themen gehören dem ganzen Arbeitsbereich, deshalb kann nur ein Schlüssel für alle Boards sie anlegen, und nur so ein Schlüssel sieht die E-Mail-Adressen der Mitglieder.
  5. Wähle unter Berechtigungen Nur lesen, Lesen und schreiben oder Vollzugriff. Lesen und schreiben erlaubt alles außer dem Löschen von Aufgaben. Vollzugriff erlaubt zusätzlich Aufgaben löschen.
  6. Für feinere Rechte tippe auf Erweitert und hake einzelne Berechtigungen an: Aufgaben lesen (Immer enthalten), Aufgaben anlegen und bearbeiten, Personen zuweisen, Checklisten bearbeiten, Kommentare schreiben, Anhänge hochladen, Testen ausfüllen (Anleitung, Tester und Fehler) und Aufgaben löschen. Eine Auswahl, die zu keiner Stufe passt, heißt Benutzerdefiniert.
  7. Wähle unter Gültig für 30 Tage, 90 Tage, 180 Tage oder 365 Tage. Darunter steht, wann der Schlüssel abläuft. Jeder Schlüssel hat ein Ablaufdatum.
  8. Gib dein Aktuelles Passwort ein und tippe auf Schlüssel erstellen. Bei einem falschen Passwort bleibt der Dialog offen.
  9. Kopiere deinen API-Schlüssel zeigt den Schlüssel ein einziges Mal. Tippe auf Kopieren, bewahre ihn in einem Passwortmanager oder als Secret in deiner CI auf und tippe dann auf Erledigt. Hast du nicht kopiert, fragt Zeitlicht nach. Trotzdem schließen schließt den Dialog, und der Schlüssel lässt sich nicht noch einmal anzeigen.
  10. Der neue Schlüssel steht unter Aktiv, mit Name, wer ihn erstellt hat, Berechtigungen, Boards und wann er erstellt, zuletzt genutzt wurde und abläuft. In seinen letzten 7 Tagen zeigt der Status Läuft in … Tagen ab, dann Läuft morgen ab und Läuft heute ab.
  11. Um einen Schlüssel zu beenden, tippe in seiner Zeile auf Widerrufen und bestätige mit Widerrufen. Alles, was den Schlüssel nutzt, verliert sofort den Zugriff.
  12. Im Notfall tippe unten auf Alle Schlüssel widerrufen und bestätige mit Alle Schlüssel widerrufen. Dann funktioniert kein aktiver Schlüssel des Arbeitsbereichs mehr, auch nicht die anderer Admins.
  13. Widerrufene und abgelaufene Schlüssel stehen unter Widerrufen und abgelaufen, mit wer sie widerrufen hat und warum. Ziehe die Liste nach unten, um sie zu aktualisieren.

Das Ergebnis

Der Schlüssel arbeitet als du, auf den gewählten Boards und mit den gewählten Rechten, bis er abläuft oder jemand ihn widerruft. Du und der Inhaber des Arbeitsbereichs bekommt bei jedem neuen Schlüssel eine E-Mail. Sieben Tage bevor ein Schlüssel abläuft, bekommt die Person, die ihn erstellt hat, eine Erinnerung per E-Mail mit der Schaltfläche API-Schlüssel öffnen.

Häufige Fragen

Ich habe einen Schlüssel verloren. Kann ich ihn noch einmal sehen?

Nein. Zeitlicht speichert nur einen Fingerabdruck des Schlüssels. Widerrufe ihn und erstelle einen neuen.

Warum steht bei einem Schlüssel Inaktiv?

Die Person, die ihn erstellt hat, hat kein Ultra mehr oder ist kein Admin mehr, oder der API-Zugang ist für den Arbeitsbereich aus. Die Zeile nennt den Grund. Hat die Person wieder Ultra, funktioniert der Schlüssel wieder.

Was passiert, wenn ein Admin zum Mitglied wird, den Arbeitsbereich verlässt oder pausiert wird?

Die Schlüssel dieser Person in diesem Arbeitsbereich werden endgültig widerrufen, auch wenn sie später wieder Admin wird.

Wie verlängere ich einen Schlüssel?

Gar nicht. Erstelle einen neuen Schlüssel, stelle dein Werkzeug darauf um und widerrufe dann den alten. Die Erinnerung eine Woche vor dem Ende ist ein guter Zeitpunkt dafür.

Ich habe mein Passwort geändert. Funktionieren meine Schlüssel noch?

Ja. Ein neues Passwort beendet keinen Schlüssel. Wenn du glaubst, dass ein Schlüssel in falsche Hände geraten ist, widerrufe ihn oder nutze Alle Schlüssel widerrufen.

Ich habe eine E-Mail zu einem Schlüssel bekommen, den ich nicht kenne.

Öffne sofort API-Schlüssel und widerrufe ihn. Ändere danach dein Passwort.

Verwandte Themen