System-API-Schlüssel

Die Seite API-Schlüssel (/system/api-keys) verwaltet Schlüssel für den programmgesteuerten Zugriff auf die System-REST-API (Header X-System-Api-Key) — etwa für Skripte, Provisionierung oder CI/CD-Automatisierung.

Schlüssel anlegen

„Neuer API-Schlüssel“ klicken.
Name vergeben (z. B. „CI/CD Pipeline“) und optional ein Ablaufdatum setzen.
„Erstellen“ klicken.

Einmalige Anzeige des neuen API-Schlüssels

Der Klartext-Schlüssel wird genau einmal angezeigt: „Kopieren Sie den Schlüssel jetzt — er wird nicht erneut angezeigt.“ Übernehmen Sie ihn mit „Kopieren“ in Ihren Passwort-Manager bzw. das Secret-Management Ihrer Automatisierung und bestätigen Sie mit „Verstanden“. Danach ist der Klartext unwiederbringlich — bei Verlust legen Sie einfach einen neuen Schlüssel an und löschen den alten.

Liste der System-API-Schlüssel

Liste und Pflege

Die Tabelle zeigt Name, Status (Aktiv/Abgelaufen/Deaktiviert), Erstellt, Ablauf, Zuletzt genutzt (Zeitpunkt und IP-Adresse; „Nie genutzt“ als Badge), Nutzungen und Aktionen (Deaktivieren/Aktivieren, Löschen). Jede Verwendung eines Schlüssels aktualisiert die Nutzungsstatistik — so erkennen Sie verwaiste Schlüssel und können sie gefahrlos entfernen.

Beispielaufruf mit dem Schlüssel (siehe auch Kapitel „System-REST-API“):

curl -H "X-System-Api-Key: vk_sys_0e18292b…" https://redact.example.com/api/system/tenants