Ferndesk
API

API-Schlüssel verwalten

Mit API-Schlüsseln können Sie Anfragen an die Ferndesk-API authentifizieren. Sie können Schlüssel in Ihren Kontoeinstellungen erstellen, anzeigen und widerrufen.

API-Schlüssel gewähren vollen Zugriff auf Ihren Workspace. Halten Sie diese geheim und übertragen Sie sie niemals in die Versionsverwaltung.

Einen API-Schlüssel erstellen

Um einen neuen API-Schlüssel zu generieren:

  1. Klicken Sie in der linken Seitenleiste unter „Entwickler“ auf API.

  2. Klicken Sie auf Neuer API-Schlüssel.

  3. Geben Sie einen aussagekräftigen Namen ein (z. B. „Production“ oder „CI/CD-Pipeline“).

  4. Klicken Sie auf Schlüssel erstellen.

API-Link in der linken Seitenleiste unter dem Abschnitt Entwickler
Schaltfläche Neuer API-Schlüssel im Bereich API-Schlüssel
Formular zum Erstellen eines API-Schlüssels mit Feld für den Schlüsselnamen

Kopieren Sie Ihren Schlüssel sofort. Sie können ihn nach dem Schließen des Dialogfelds nicht mehr einsehen.

Generierter API-Schlüssel mit Kopieren-Schaltfläche

Speichern Sie den Schlüssel sicher in Ihrem Passwort-Manager oder Secrets-Vault.

API-Schlüssel anzeigen

Alle Ihre API-Schlüssel werden auf der API-Seite aufgeführt. Sie sehen den Schlüsselnamen, das Erstellungsdatum und den Zeitstempel der letzten Verwendung – jedoch nicht den Schlüssel selbst.

Liste der API-Schlüssel mit Schlüsselnamen und Menüoptionen

Einen API-Schlüssel widerrufen

Falls ein Schlüssel kompromittiert wurde oder nicht mehr benötigt wird:

  1. Rufen Sie die API-Seite auf.

  2. Klicken Sie auf das Drei-Punkte-Menü neben dem Schlüssel.

  3. Wählen Sie Widerrufen.

Das Widerrufen eines Schlüssels blockiert sofort alle damit getätigten Anfragen. Alle Integrationen oder Skripte funktionieren erst wieder, wenn Sie diese mit einem neuen Schlüssel aktualisieren.

Rotieren Sie Ihre API-Schlüssel regelmäßig und widerrufen Sie ungenutzte Schlüssel, um Sicherheitsrisiken zu minimieren.

War das hilfreich?