API-Key erstellen und widerrufen
Voraussetzungen
Ein API-Key ist ein langer Zeichenschlüssel. Damit weist sich ein anderes System gegenüber checkITeasy aus, ohne E-Mail Adresse, ohne Passwort und ohne Code aus der App. Der Key gilt für Ihren Benutzer und für die Anwendung, in der Sie ihn erstellen. Was mit dem Key geschieht, geschieht in Ihrem Namen.
Öffnen Sie auf der Kontoseite den Bereich „Konfiguration" und wechseln Sie oben auf die Registerkarte „API".
Die Registerkarte (1) „API" führt die eigenen Keys mit „Gültig von", „Gültig bis", „Zugriffe" und „Letzter Zugriff". Eine Spalte mit dem Schlüssel selbst gibt es bewusst nicht. (2) ist die Schaltfläche „Neu". Hier ist noch kein Key angelegt. Klicken Sie in der Werkzeugleiste über der Liste auf „Neu".
Geben Sie im Dialog „Neuer API-Key" eine Bezeichnung ein. Daran erkennen Sie später, wofür der Key gedacht ist. Nehmen Sie zum Beispiel den Namen des anfragenden Systems.
Vor dem Anlegen fragt der Dialog nur nach einer Bezeichnung. Das Feld „Key" erscheint erst nach „OK". Davon zeigt diese Anleitung bewusst kein Bild. Klicken Sie auf „OK". Der Dialog bleibt offen und zeigt zusätzlich das Feld „Key" mit dem erzeugten Schlüssel.
Kopieren Sie den Schlüssel über die Schaltfläche daneben („Key kopieren") in die Zwischenablage. Hinterlegen Sie ihn sofort dort, wo er gebraucht wird. Am besten in einem Passwortmanager.
Beenden Sie den Dialog mit „Schließen".
Die Spalten der Liste
| Feld | Bedeutung |
|---|---|
| Bezeichnung | Der beim Anlegen vergebene Name. |
| Gültig von | Der Tag der Erstellung. |
| Gültig bis | Ein Jahr nach der Erstellung. Danach wird der Key abgelehnt und Sie brauchen einen neuen. |
| Zugriffe | Wie oft der Key bisher verwendet wurde. |
| Letzter Zugriff | Wann zuletzt etwas mit diesem Key passiert ist. So erkennen Sie am schnellsten einen ungenutzten Key. |
Einen Key widerrufen
Einen Key können Sie nicht ändern. Das gilt für die Bezeichnung und für die Laufzeit. Brauchen Sie ihn nicht mehr oder ist er in falsche Hände geraten, hilft nur löschen.
Markieren Sie in der Liste die Zeile des Keys.
Klicken Sie in der Werkzeugleiste auf „Löschen". Oder Sie klicken mit der rechten Maustaste auf die Zeile und wählen „Löschen".
Bestätigen Sie die Rückfrage „API-Key löschen". Sie nennt die Bezeichnung des betroffenen Keys.