Kandji-API

Was ist die Kandji API?

Die Kandji API ist ein robustes Tool, das Sie bei der Verwaltung und Sicherung von Apple-Geräten in Ihrem Unternehmen unterstützt. Es ermöglicht Ihnen, Aufgaben zu automatisieren, in andere Dienste zu integrieren und die Funktionen von Kandji über die Benutzeroberfläche hinaus zu erweitern.

Generieren eines API-Tokens

Für jeden spezifischen Anwendungsfall ist es am besten, ein eindeutiges API-Token zu erstellen. Um sie leicht zu identifizieren, sollten Sie in der Kandji Web App eindeutige und aussagekräftige Namen zuweisen.

Kandji verwendet Bearertoken auf Mandantenebene, um den Zugriff auf die API zu steuern. So generieren Sie eine:

  1. Melden Sie sich an und klicken Sie auf Einstellungen.

  2. Klicken Sie auf die Registerkarte Zugriff.

  3. Klicken Sie auf die Schaltfläche API-Token hinzufügen, um einen neuen API-Schlüssel zu erstellen. 

  4. Geben Sie einen Namen und eine Beschreibung für Ihr API-Token an.

  5. Klicken Sie auf Erstellen. 

  6. Kandji zeigt ein Modal mit dem API-Token an. Klicken Sie auf das Sichtbarkeitssymbol, um es anzuzeigen, oder verwenden Sie die Schaltfläche Token kopieren, um das API-Token in Ihre Zwischenablage zu kopieren und an einem sicheren Ort zu speichern. Hinweis: Sie können die Token-Details nicht mehr sehen.

  7. Klicken Sie auf Weiter.

  8. Klicken Sie auf Konfigurieren , um die API-Berechtigungen für dieses spezielle Token zu verwalten, oder auf Überspringen , um sie später zu ändern. 

  9. Nachdem Sie Ihre Änderungen vorgenommen haben, klicken Sie auf Speichern.

  10. Nachdem Sie Ihr erstes Token erstellt haben, wird Ihre mandantenspezifische API-URL angezeigt.

Überprüfen, Ändern oder Widerrufen eines API-Tokens

Wenn Sie einen Admin-Benutzer aus der Kandji Web-App entfernen, nachdem er ein API-Token erstellt hat, wird das API-Token ebenfalls entfernt.

Nachdem Sie ein API-Token für Ihren Mandanten erstellt haben, können Sie dessen Namen und Berechtigungen ändern oder widerrufen, um weiteren Zugriff zu verhindern. 

Überprüfen oder Ändern eines Tokens

  1. Klicken Sie auf die vertikalen Auslassungspunkte neben dem Token. 

  2. Klicken Sie auf Anzeigen, um Informationen zum Token anzuzeigen, einschließlich der Berechtigungen, die dem Token zugeordnet sind. Auf dieser Seite können Sie die folgenden Optionen verwenden.

    1. Klicken Sie auf die Registerkarte Berechtigungen, um die dem Token zugeordneten Berechtigungen zu bearbeiten. 

    2. Klicken Sie auf die Registerkarte Aktivität, um die Aktivität des API-Tokens anzuzeigen, einschließlich:

      • Token erstellt

      • Name des Tokens geändert

      • Tokenberechtigungen bearbeitet

Widerrufen eines Tokens

  1. Klicken Sie in der unteren rechten Ecke auf Bearbeiten, um den Namen des Tokens zu bearbeiten.

  2. Klicken Sie auf Widerrufen, um das API-Token ungültig zu machen und seine weitere Verwendung zu verhindern. Wenn Sie ein Token widerrufen, wird es nicht mehr in der Liste der API-Token für Ihren Mandanten angezeigt. 

API-Dokumentation 

Die vollständige Dokumentation zu API-Endpunkten finden Sie unter api-docs.kandji.io. In diesem Artikel wird das Generieren eines API-Tokens in Ihrem Kandji Mandanten erläutert.

API-Ratenbegrenzung

Die Kandji -API hat derzeit ein API-Ratenlimit von 10.000 Anforderungen pro Stunde und Mandant.