Verwalten des Zugriffs auf die Zendesk-API per API-Token

Welchen Plan habe ich

Suite

Team, Growth, Professional, Enterprise oder Enterprise Plus

Support

Team, Professional oder Enterprise

Verifizierte KI-Zusammenfassung ◀▼

Sie können den API-Zugriff auf Ihr Zendesk-Konto managen, indem Sie API-Token erstellen, bearbeiten, deaktivieren, reaktivieren und löschen. Bei Enterprise-Plänen können Sie die Token-Aktivitäten im Auditprotokoll einsehen. 

Pfad: Admin Center > Apps und Integrationen > APIs > API-Token

Benutzer können ein API-Token verwenden, um API-Anfragen zu authentifizieren. API-Token sind automatisch generierte Kennwörter, die zusammen mit der E-Mail-Adresse verwendet werden können, um API-Anfragen zu authentifizieren. API-Token können auch für die Zwei-Faktor-Authentifizierung bei Integrationen genutzt werden. Jedes API-Token kann von jedem bestätigten Benutzer des Kontos verwendet werden; es ist nicht mit einem bestimmten Benutzer verknüpft. Es können mehrere Token gleichzeitig aktiv sein.

Sie können bis zu 256 Token einrichten. Wenn dieses Limit erreicht ist, müssen Sie ein vorhandenes Token löschen, um ein neues hinzuzufügen. Für Konten, die derzeit über mehr als 256 Token verfügen, gilt ein Limit von 2048 Token.

API-Token sind nicht das gleiche wie OAuth-Zugriffstoken. Weitere Informationen finden Sie unter Differences between API tokens and access tokens (Englisch) auf developer.zendesk.com.

Dieser Beitrag enthält die folgenden Abschnitte:

• Generieren von API-Token
• Bearbeiten eines API-Tokens
• Deaktivieren und Reaktivieren eines API-Tokens
• Löschen eines API-Tokens
• Einsehen der Auditprotokolle für API-Token (Enterprise)

Generieren von API-Token

Um API-Token generieren zu können, müssen Sie ein Administrator sein und der API-Tokenzugriff muss in Ihrem Konto eingeschaltet sein.

So generieren Sie ein API-Token

1. Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf APIs > API-Token.

   Eine Liste der API-Token wird angezeigt.

   

2. Klicken Sie auf API-Token hinzufügen.
3. (Optional) Geben Sie eine Beschreibung für das Token ein.
4. Klicken Sie auf Speichern, um das Token zu generieren.

   Das Token wird generiert und angezeigt:

   

5. Kopieren Sie das Token und fügen Sie es an einem sicheren Ort ein.
   Hinweis: Nachdem Sie dieses Fenster durch Klicken auf Speichern geschlossen haben, wird das vollständige Token nicht wieder angezeigt.
6. Klicken Sie erneut auf Speichern, um zur Liste mit den Token für die Zendesk-API zurückzukehren.

   Wenn Sie auf das Token klicken, um es erneut zu öffnen, wird eine verkürzte Version des Tokens angezeigt.

   

Bearbeiten eines API-Tokens

Bei Bedarf können Sie ein API-Token bearbeiten, um seine Beschreibung ändern.

So bearbeiten Sie ein API-Token

1. Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf APIs > API-Token.
2. Suchen Sie das Token, das Sie bearbeiten möchten.
3. Klicken Sie auf das Optionsmenü () neben dem Token und dann auf Bearbeiten.
4. Geben Sie eine neue Beschreibung für das Token ein und klicken Sie dann auf Speichern.

   

Deaktivieren und Reaktivieren eines API-Tokens

Bei Bedarf können Sie ein Token vorübergehend deaktivieren, um sicherzustellen, dass es nicht kompromittiert wurde, oder permanent deaktivieren, um zu untersuchen, wie es verwendet wird, ohne es tatsächlich zu löschen. Deaktivierte Token können reaktiviert werden.

So deaktivieren Sie ein API-Token

1. Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf APIs > API-Token.
2. Suchen Sie das Token, das Sie deaktivieren möchten.
3. Klicken Sie auf das Optionsmenü () neben dem Token und dann auf Deaktivieren.

   

4. Klicken Sie im Bestätigungsdialogfeld auf Deaktivieren.

   Der Status des Tokens ändern sich sofort. Sobald Sie ein Token deaktivieren, schlagen API-Aufrufe fehl, die dieses Token verwenden.

So reaktivieren Sie ein API-Token

1. Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf APIs > API-Token.
2. Suchen Sie das Token, das Sie reaktivieren möchten.
3. Klicken Sie auf das Optionsmenü () neben dem Token und dann auf Reaktivieren.
4. Klicken Sie im Bestätigungsdialogfeld auf Reaktivieren.

   Der Status des Tokens ändert sich von Deaktiviert in Aktiv. Wenn Sie ein Token reaktivieren, kann es wieder zur Authentifizierung von API-Anfragen verwendet werden.

Löschen eines API-Tokens

Ein API-Token ist wie ein Kennwort: Jeder bestätigte Benutzer des Kontos oder jeder, der die E-Mail-Adresse eines bestätigten Benutzers hat, kann es zur Authentifizierung von API-Anfragen verwenden. Wenn ein API-Token kompromittiert wurde, sollten Sie es sofort löschen. Die Löschung eines Tokens ist dauerhaft. Dieser Schritt kann nicht rückgängig gemacht werden.

Hinweis: Sie müssen ein Token zuerst deaktivieren, bevor Sie es löschen können.

So löschen Sie ein API-Token

1. Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf APIs > API-Token.
2. Suchen Sie das Token, das Sie löschen möchten, und stellen Sie sicher, dass sein Status Deaktiviert lautet.
3. Klicken Sie auf das Optionsmenü () neben dem Token und dann auf Löschen.

   

4. Klicken Sie im Bestätigungsdialogfeld auf Löschen.

Einsehen der Auditprotokolle für API-Token (Enterprise)

Bei Enterprise-Plänen werden die mit einem API-Token verbundenen Aktivitäten im Auditprotokoll aufgezeichnet, einschließlich Zeitpunkt der Erstellung, Deaktivierung oder Reaktivierung des Tokens.

So rufen Sie ein Auditprotokoll auf

1. Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf APIs > API-Token.
2. Suchen Sie das Token in der Liste.
3. Klicken Sie auf das Optionsmenü () neben dem Token und dann auf Auditprotokoll anzeigen.

   Das Auditprotokoll wird geöffnet und nach dem ausgewählten API-Token gefiltert. Sie sehen alle mit diesem Token verbundenen Aktivitäten.