Zendesk-Konfiguration

Auf dieser Seite wird beschrieben, wie Sie die Authentifizierung und Berechtigungen einrichten, bevor Sie den Zendesk-Datenspeicher erstellen.

Tokenzugriff aktivieren

Damit sich Zendesk authentifizieren und mit Ihrer Zendesk-Instanz interagieren kann, müssen Sie den Tokenzugriff aktivieren. So aktivieren Sie den Zugriff über Token:

  1. Rufen Sie Ihre Zendesk-Instanz auf und melden Sie sich mit einem Administratorkonto an.
  2. Maximieren Sie im Navigationsmenü Apps und Integrationen und wählen Sie dann unter APIs die Option API-Konfiguration aus.
  3. Klicken Sie auf das Kästchen API-Token-Zugriff zulassen.
  4. Klicken Sie auf Speichern.

Authentifizierung und Berechtigungen einrichten

Für eine sichere Integration mit OAuth 2.0 müssen Sie Ihre Anwendung in Zendesk registrieren, um die erforderliche Client-ID und den erforderlichen Clientschlüssel zu erhalten.

OAuth-Client erstellen und Anmeldedaten für die Authentifizierung abrufen

So erstellen Sie einen OAuth-Client in Zendesk und rufen die Anmeldedaten für die Authentifizierung ab:

  1. Rufen Sie Ihre Zendesk-Instanz auf und melden Sie sich mit einem Administratorkonto an.

  2. Klicken Sie auf das Symbol für Zendesk-Produkte und wählen Sie Admin Center aus.

    Zendesk Admin Center-Oberfläche.
    Zendesk Admin Center

  3. Maximieren Sie im Navigationsmenü Apps und Integrationen und wählen Sie unter APIs die Option OAuth-Clients aus.

  4. Klicken Sie auf OAuth-Client hinzufügen.

  5. Geben Sie die folgenden Kundendetails ein:

    • Name:Geben Sie einen aussagekräftigen Namen für die Anwendung ein.
    • Optional: Beschreibung:Geben Sie eine kurze Beschreibung ein.
    • Optional: Unternehmen:Geben Sie den Namen Ihres Unternehmens ein.
    • Optional: Logo:Geben Sie ein Logo an, das auf dem Zustimmungsbildschirm angezeigt wird.
    • Eindeutige Kennung (Client-ID): Geben Sie einen eindeutigen Namen für Ihren Client an. Sie können den ursprünglichen Vorschlag bearbeiten, er muss jedoch eindeutig sein.
    • Clienttyp:Wählen Sie Öffentlich für Anwendungen aus, die in einem Browser oder auf einem Mobilgerät ausgeführt werden, oder Vertraulich für Anwendungen, die auf sicheren Servern ausgeführt werden.
    • Weiterleitungs-URLs (erforderlich): Geben Sie https://vertexaisearch.cloud.google.com/oauth-redirect ein. Das ist die URL, zu der Zendesk nach der Autorisierung weiterleitet und an die der Autorisierungscode gesendet wird.

  6. Klicken Sie auf Speichern, um den geheimen Clientschlüssel zu erhalten.

    • Client-ID:Der Wert aus dem Feld Eindeutige Kennung.
    • Clientschlüssel:Ein neues Feld Secret wird angezeigt. Kopieren Sie dieses Secret und speichern Sie es sofort an einem sicheren Ort. Aus Sicherheitsgründen wird das vollständige Secret nur einmal angezeigt. Wenn Sie ihn verlieren, müssen Sie ihn neu generieren.
    Der generierte Clientschlüssel wird in der Benutzeroberfläche angezeigt.
    Generierte Clientanmeldedaten

  7. Klicken Sie noch einmal auf Speichern, um die Änderungen zu übernehmen.

Berechtigungen einrichten

So richten Sie die erforderlichen Berechtigungen ein:

  1. Rufen Sie Ihre Zendesk-Instanz auf und melden Sie sich mit einem Administratorkonto an.
  2. Klicken Sie auf das Symbol für Zendesk-Produkte und wählen Sie Admin Center aus.
  3. Maximieren Sie im Navigationsmenü Apps und Integrationen und wählen Sie unter Verbindungen die Option OAuth-Clients aus.
  4. Klicken Sie auf Client hinzufügen.

  5. Geben Sie die folgenden Kundendetails ein:

    • Name: Geben Sie einen aussagekräftigen Namen ein. Dies kann nicht geändert werden.
    • OAuth-Berechtigungstyp: Wählen Sie Autorisierungscode aus.
    • Client-ID: Geben Sie die Client-ID ein, die Sie im Abschnitt OAuth-Client in Zendesk erstellen erhalten haben.
    • Clientschlüssel: Geben Sie den Clientschlüsselwert ein, den Sie im Abschnitt OAuth-Client in Zendesk erstellen erhalten haben.
    • Autorisierungs-URL: Der Autorisierungsendpunkt hat normalerweise das Format https://<var>your-subdomain</var>.zendesk.com/oauth/authorize. Ersetzen Sie <var>your-subdomain</var> durch Ihre tatsächliche Zendesk-Subdomain.
    • Token-URL: Der Token-Endpunkt hat normalerweise das Format https://<var>your-subdomain</var>.zendesk.com/oauth/token. Ersetzen Sie <var>your-subdomain</var> durch Ihre tatsächliche Zendesk-Subdomain.
      Felder für die Eingabe von API-Bereichen im Zendesk Admin Center.
      Bereiche hinzufügen
    • Bereiche: Geben Sie je nach Verbindungsmodus die folgenden Bereiche ein, die durch Leerzeichen getrennt sind:
    Verbindungsmodus Umfang Zweck Einwilligung des Administrators erforderlich
    Föderierte Suche read, users:read Ermöglicht die Suche in Zendesk-Daten. Nein

  6. Klicken Sie auf Speichern.