ZEITLICHT
Zurück zur Übersicht

API und Integrationen

Zugriffsprotokoll eines API-Schlüssels lesen

Ich möchte …

… sehen, wofür ein Schlüssel genutzt wurde, von wo aus und ob es geklappt hat.

Bevor du startest

  • Nur Inhaber und Admin sehen API-Schlüssel und ihre Zugriffsprotokolle, und zwar für jeden Schlüssel des Arbeitsbereichs.
  • Das Protokoll bewahrt Anfragen 90 Tage auf und löscht sie dann.
  • Es zeigt Anfragen mit dem richtigen Schlüssel, auch abgelehnte, zum Beispiel nach einem Widerruf. Versuche mit einem falschen Schlüssel erscheinen nicht.

So geht's

  1. Öffne im Arbeitsbereich Einstellungen und dann API-Schlüssel.
  2. Tippe auf einen Schlüssel. Seine Seite öffnet sich mit dem Namen des Schlüssels als Titel.
  3. Oben siehst du den Anfang des Schlüssels, Erstellt von … und seinen Status, etwa Aktiv, Läuft in 5 Tagen ab, Inaktiv, Abgelaufen oder Widerrufen, samt Grund, falls es einen gibt.
  4. Darunter stehen die Daten: Erstellt am …, Zuletzt genutzt am … oder Noch nicht genutzt sowie Läuft am … ab, Abgelaufen am … oder Widerrufen am ….
  5. Berechtigungen zeigt die Stufe und jede einzelne Berechtigung. Boards listet die Boards, die der Schlüssel sehen darf. Ein Board, das es nicht mehr gibt, erscheint als Gelöschtes Board.
  6. Zugriffsprotokoll listet die Anfragen, die neuesten zuerst. Jede Zeile zeigt die Anfrage, etwa GET /tasks/3f2a9c1e oder MCP tools/call get_task 3f2a9c1e, und einen Chip mit dem Statuscode der Antwort. Bei einer abgelehnten Anfrage steht zusätzlich der Grund dabei, etwa key-revoked.
  7. Die Zeile darunter nennt Datum und Uhrzeit, die IP-Adresse und das Programm, das die Anfrage geschickt hat.
  8. Tippe am Ende der Liste auf Mehr laden, um ältere Anfragen zu sehen. Klappt das Laden nicht, tippe auf Erneut versuchen.
  9. Kommt dir eine Anfrage falsch vor, tippe auf Schlüssel widerrufen und bestätige mit Widerrufen. Die Seite bleibt offen und zeigt den Schlüssel als Widerrufen.

Das Ergebnis

Du weißt, welches Programm den Schlüssel wann, von welcher Adresse aus und mit welchem Ergebnis genutzt hat.

Häufige Fragen

Was bedeuten die Statuscodes?

200 und 201 haben geklappt. 401 heißt, der Schlüssel wurde abgelehnt: Er ist falsch, abgelaufen oder widerrufen, oder die Person, die ihn erstellt hat, ist kein Admin mehr. 403 heißt, der Schlüssel darf das nicht: Eine Berechtigung fehlt, die erstellende Person hat kein Ultra, der Arbeitsbereich hat keinen API-Zugang, oder die Anfrage braucht einen Schlüssel für alle Boards, etwa beim Anlegen eines Tags oder Themas (all-boards-required). 404 heißt, die Aufgabe oder das Board gibt es nicht, oder sie liegt nicht auf den Boards des Schlüssels. 409 heißt, eine Kurz-ID passt zu mehreren Aufgaben, oder eine Anfrage mit demselben Idempotency-Key läuft noch. 422 heißt, ein Idempotency-Key wurde für eine andere Anfrage wiederverwendet. 429 heißt, es kamen zu viele Anfragen in kurzer Zeit; das Programm sollte warten und es erneut versuchen. Bekommt ein Programm immer wieder 429, zeigt das Protokoll das etwa einmal pro Minute und Schlüssel, nicht jede abgelehnte Anfrage.

Ich habe ein Konto deaktiviert oder ein Plan ist abgelaufen, aber der Schlüssel ging noch.

Änderungen am Konto der Person, die den Schlüssel erstellt hat, etwa ein deaktiviertes Konto oder ein verlorenes Ultra, können bis zu 30 Sekunden brauchen, bis der Schlüssel nicht mehr geht. Ist die Person kein Admin mehr oder verlässt sie den Arbeitsbereich, stoppt der Schlüssel sofort.

Was bedeutet MCP?

Die Anfrage kam von Claude Code oder einem anderen KI-Werkzeug, das über MCP verbunden ist. Der Name nach tools/call, etwa get_task, ist das Tool, das es benutzt hat.

Der Schlüssel ist widerrufen, aber es kommen weiter Anfragen. Was jetzt?

Ein Programm hat den Schlüssel noch. Jede dieser Anfragen wird mit 401 und key-revoked abgelehnt. Finde das Programm über die IP-Adresse und den Namen im Protokoll und entferne den Schlüssel dort.

Warum ist die Liste leer?

Der Schlüssel wurde in den letzten 90 Tagen nicht genutzt. Auf der Seite steht Noch keine Anfragen..

Verwandte Themen