Configurer le spoke Zendesk

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 3 minutes de lecture
  • Intégrez l’instance et Zendesk en créant une application Zendesk OAuth personnalisée pour authentifier les ServiceNow demandesServiceNow.

    Avant de commencer

    • Demandez un Hub d'intégration abonnement.
    • Activez le spoke Zendesk.
    • Rôle requis : admin.

    Créer un Zendesk client OAuth

    Créez un client OAuth pour authentifier les demandes d’API Zendesk .

    Avant de commencer

    Rôle requis : Zendesk admin

    Procédure

    1. Depuis un navigateur Web, ouvrez Zendesk.
    2. Connectez-vous à l’aide de vos informations d’identification d’administrateur.
      L’espace de travail d’agent Zendesk s’ouvre.
    3. Dans le menu de navigation de gauche d’Espace de travail d’agentZendesk, sélectionnez l’icône Administrateur (icône Administrateur).
      Le menu Admin s’ouvre.
    4. Dans le menu Administrateur, accédez à Canaux > API.
      La page API Zendesk s’ouvre.
    5. Sélectionnez l’onglet Clients OAuth , puis cliquez sur Ajouter un client OAuth.
    6. Le formulaire Créer un nouveau client OAuth s’ouvre.
    7. Renseignez les champs du formulaire.
      Tableau 1. Formulaire Créer un nouveau client OAuth
      Champ Description
      Nom du client Nom du client OAuth.
      Description Brève description du client OAuth.
      Entreprise Nom de la société dont le client OAuth accorde l’accès aux données via l’API Zendesk . Le nom de la société s’affiche lors de l’authentification de vos Zendesk demandes API.

      Ce champ se remplit automatiquement en fonction de la société à laquelle votre Zendesk compte est associé. Toutefois, vous pouvez modifier le nom de la société si nécessaire.

      Logo Logo affiché lors de l’authentification de vos Zendesk demandes API. Cliquez sur le carré vert pour localiser et sélectionner le logo que vous souhaitez afficher.
      Identificateur unique Identificateur unique pour le client OAuth. Ce champ se remplit automatiquement en fonction du nom du client OAuth que vous avez spécifié dans le champ Nom du client . Toutefois, vous pouvez modifier l’identificateur unique si nécessaire.
      Remarque :
      L’identificateur unique n’est utilisé que dans le Zendesk code.
      URL de redirection URL du fournisseur OAuth vers lequel les utilisateurs sont redirigés après authentification. Entrez https:// instance.service-now.com/oauth_redirect.do, où <instance> est le nom de votre ServiceNow instance.
    8. Cliquez sur Enregistrer.
      La boîte de dialogue Please store the secret that will appear (Veuillez stocker le secret qui s’affichera) s’ouvre.
    9. Dans la boîte de dialogue, cliquez sur OK.
      La boîte de dialogue se ferme et le formulaire se recharge à nouveau.
    10. Copiez la valeur dans le champ Secret .
      Conservez-le dans un endroit sécurisé pour une utilisation ultérieure.

    Créer une connexion Zendesk

    Créez une connexion entre vos Zendesk applications et votre ServiceNow instance afin que celle-ci puisse récupérer les données utilisateur de vos applications.

    Avant de commencer

    Rôle requis : ServiceNow admin

    Procédure

    1. Depuis votre ServiceNow instance, accédez à Automatisation des processus > Concepteur de flux.
      Flow Designer se lance dans un nouvel onglet.
    2. Sélectionnez l’onglet Connexions .
    3. Localisez votre Zendesk connexion, puis cliquez sur Ajouter une connexion.
      La boîte de dialogue Créer une connexion s’ouvre.
    4. Renseignez les champs de la boîte de dialogue.
      Tableau 2. Boîte de dialogue Créer une connexion
      Champ Description
      Information de connexion
      Nom de la connexion Nom de la Zendesk connexion. Ce champ se remplit automatiquement.
      URL de connexion URL de connexion. Saisissez https://< sous-domaine >.zendesk.com, où < sous-domaine > est le sous-domaine de votre organisation.
      Informations d'identification
      ID client OAuth Identificateur unique pour votre Zendesk client OAuth. Entrez l’identificateur unique que celui que vous avez spécifié dans Créer un Zendesk client OAuth.
      Secret client OAuth Secret affecté à votre Zendesk client OAuth. Saisissez le même secret que celui que vous avez copié dans Créer un Zendesk client OAuth.
      URL de redirection OAuth URL du fournisseur OAuth vers lequel les utilisateurs sont redirigés après authentification. Ce champ est renseigné automatiquement en fonction de l’URL de redirection que vous avez spécifiée dans Créer un Zendesk client OAuth.
    5. Cliquez sur Créer et obtenir un jeton OAuth.
      La Zendesk boîte de dialogue Autorisation OAuth s’ouvre.
    6. Dans la boîte de dialogue, cliquez sur Autoriser.
      Le jeton d’accès OAuth devient disponible pour autoriser votre Zendesk connexion.
    7. Dans votre instance ServiceNow, ajoutez un périmètre de profil d’entité OAuth.
      1. Accédez à la OAuth système > Registre d'application.
      2. Ouvrez l’enregistrement du spoke Zendesk. Par exemple, Zendesk OAuth.
      3. Dans l’onglet Profils des entités OAuth , ouvrez l’enregistrement par défaut, par exemple, Zendesk.OAuthProfile.
      4. Insérez une nouvelle ligne avec ces valeurs.
        Champ Valeur
        Périmètre de l'entité OAuth utilisateurs :écriture, lecture
        Périmètre OAuth Écriture/lecture