Zurück

Erstellen Sie API-Schlüssel für Fleet

Mit einem Fleet-API-Schlüssel kommunizieren Sie direkt mit Ihrer Fleet-Instanz. Nutzen Sie ihn, um Skripte auszuführen, Gerätedaten abzurufen oder Fleet mit anderen Tools zu verbinden.


 

Funktion

Übersicht

API-Schlüssel für Fleet (FleetDM) authentifizieren Anfragen, die direkt an Ihre Fleet-Instanz gesendet werden. Sie können sie auf drei Arten erstellen:

  • In Factorial IT, als Schlüssel mit reinem Lesezugriff.
  • Im Fleet-Dashboard, als Token, das mit Ihrem Fleet-Benutzerkonto verknüpft ist.
  • Über die Kommandozeile, mit der Fleet-CLI oder der Fleet-API.

Fleet-API-Token laufen nie von selbst ab.


 

Einen Schlüssel in Factorial IT erstellen

  1. Gehen Sie zu Einstellungen > Entwickler und scrollen Sie nach unten zum Abschnitt FleetDM API-Schlüssel.
  2. Geben Sie einen Schlüsselnamen ein, zum Beispiel den Namen des Tools, das den Schlüssel verwenden wird.
  3. Klicken Sie auf Schlüssel generieren.
  4. Kopieren Sie das Token, das im Fenster FleetDM API-Schlüssel erstellt angezeigt wird. Es bleibt danach in der Schlüsseltabelle verfügbar.

In Factorial IT erstellte Schlüssel haben nur Lesezugriff. Sie können alle Geräte und deren Daten sehen, aber keine Einstellungen ändern oder Geräteaktionen ausführen. Sie eignen sich für externe Integrationen, die Ihre Fleet-Instanz nur lesen müssen.

Um einen Schlüssel zu widerrufen, öffnen Sie das Menü ⋯ in seiner Zeile der Tabelle FleetDM API-Schlüssel und klicken Sie auf Widerrufen. Jede Integration, die ihn nutzt, funktioniert sofort nicht mehr.

Halten Sie das Token geheim. Wer es besitzt, kann Ihr Geräteinventar lesen.


 

Einen Schlüssel im Fleet-Dashboard erstellen

  1. Öffnen Sie Ihr Fleet-Dashboard aus der Konsole über Einstellungen > MDM > Fleet öffnen.
  2. Klicken Sie oben rechts auf Ihren Avatar und wählen Sie Mein Konto.
  3. Scrollen Sie nach unten zu API-Token.
  4. Klicken Sie auf API-Token abrufen.
  5. Kopieren Sie das Token. Es gehört zu Ihrem Fleet-Benutzerkonto.

Dieses Token hat dieselben Berechtigungen wie Ihr Fleet-Benutzerkonto. Halten Sie es geheim.


 

Einen Schlüssel über die Kommandozeile erstellen

Mit der Fleet-CLI:

fleetctl login --email your-email@example.com --url https://[IHRE-FLEET-INSTANZ]
fleetctl get api-token

Oder direkt über die Fleet-API:

curl -X POST https://[IHRE-FLEET-INSTANZ]/api/v1/fleet/users/[BENUTZER-ID]/api_token \
  -H "Authorization: Bearer IHR_VORHANDENES_TOKEN" \
  -H "Content-Type: application/json"

 

Den Schlüssel verwenden

Senden Sie das Token im Header Authorization:

curl https://[IHRE-FLEET-INSTANZ]/api/v1/fleet/hosts \
  -H "Authorization: Bearer IHR_FLEET_API_TOKEN"

 

Ein Token neu generieren oder widerrufen

  • In Factorial IT erstellte Schlüssel: Gehen Sie zu Einstellungen > Entwickler > FleetDM API-Schlüssel, öffnen Sie das Menü ⋯ in der Zeile des Schlüssels und klicken Sie auf Widerrufen.
  • Mit Ihrem Fleet-Benutzerkonto verknüpftes Token: Gehen Sie in Fleet zu Mein Konto und klicken Sie auf API-Token regenerieren. Das alte Token funktioniert sofort nicht mehr.

 

Tipps und Best Practices

  • Erstellen Sie einen Schlüssel pro Integration. Benennen Sie ihn nach dem Tool, damit Sie wissen, was beim Widerrufen ausfällt.
  • Verwenden Sie für Integrationen mit reinem Lesezugriff Schlüssel aus Factorial IT. Sie können keine Einstellungen ändern und keine Geräteaktionen ausführen.
  • Planen Sie eine eigene Rotation. Token laufen nie ab, widerrufen oder erneuern Sie sie daher nach einem festen Zeitplan.
  • Geben Sie ein Token niemals weiter. Wer es besitzt, kann Ihr Geräteinventar lesen, bei einem Benutzer-Token sogar mehr.
 

 

Fehlerbehebung und FAQ

Fehlerbehebung

  • Eine Integration funktioniert nicht mehr. Ihr Schlüssel wurde möglicherweise widerrufen oder das Benutzer-Token neu generiert. Erstellen Sie einen neuen Schlüssel und aktualisieren Sie die Integration.
  • Eine Anfrage zum Ändern von Einstellungen oder zum Ausführen einer Aktion schlägt fehl. In Factorial IT erstellte Schlüssel haben nur Lesezugriff. Verwenden Sie ein Token, das mit einem Fleet-Benutzerkonto mit den passenden Berechtigungen verknüpft ist.
  • Sie haben das Token verloren. Einen in Factorial IT erstellten Schlüssel finden Sie in der Schlüsseltabelle wieder. Ein Benutzer-Token generieren Sie in Fleet unter Mein Konto neu.

 

FAQ

  1. Laufen Fleet-API-Token ab?
    Nein. Sie bleiben gültig, bis Sie sie widerrufen oder neu generieren.
     
  2. Was kann ein in Factorial IT erstellter Schlüssel?
    Alle Geräte und deren Daten lesen. Er kann keine Einstellungen ändern und keine Geräteaktionen ausführen.
     
  3. Welche Berechtigungen hat ein Token aus dem Fleet-Dashboard?
    Dieselben wie Ihr Fleet-Benutzerkonto.
     
  4. Was passiert, wenn ich einen Schlüssel widerrufe?
    Jede Integration, die ihn nutzt, funktioniert sofort nicht mehr.

War dieser Artikel hilfreich?

Give feedback about this article

Können Sie nicht finden, wonach Sie suchen?

Unser Kundenserviceteam steht Ihnen zur Verfügung.

Kontakt

Knowledge Base Software powered by Helpjuice