Configurer le spoke Zendesk

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

    • Intégrez l’instance ServiceNow et Zendesk en créant une application OAuth personnalisée dans Zendesk pour authentifier les ServiceNow demandes.

    Avant de commencer

    • Demander un Hub d'intégration abonnement.
    • Activer le spoke Zendesk.
    • Zendesk Rôle requis : admin
    • Rôle requis : administrateur

    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. À partir d’un navigateur Web, ouvrez Zendesk.
    2. Connectez-vous à l’aide de vos informations d’identification administrateur.
      Agent Zendesk Workspace 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 Administrateur s’ouvre.
    4. Dans le menu Admin, accédez à Canaux > API.
      La page API s’ouvre Zendesk .
    5. Sélectionnez l’onglet Clients OAuth , puis cliquez sur Ajouter un client OAuth.
    6. Le formulaire Créer un 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.
      Société Nom de la société à laquelle le client OAuth accorde l’accès via l’API Zendesk . Le nom de l’entreprise s’affiche lors de l’authentification de vos Zendesk demandes d’API.

      Ce champ se remplit automatiquement en fonction de l’entreprise à laquelle votre Zendesk compte est associé. Toutefois, vous pouvez modifier le nom de la société si nécessaire.
      Logo Logo qui s’affiche lors de l’authentification de vos Zendesk demandes d’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 de client OAuth que vous avez spécifié dans le champ Nom du client . Toutefois, vous pouvez modifier l’identificateur unique selon vos besoins.
      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. Saisissez 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 Veuillez enregistrer le secret qui apparaîtra s’ouvre.
    9. Dans la boîte de dialogue, cliquez sur OK.
      La boîte de dialogue se ferme et le formulaire se recharge
    10. Copiez la valeur dans le champ Secret .
      Conservez-le dans un emplacement 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 votre instance puisse récupérer les données utilisateur de vos applications.

    Avant de commencer

    Rôle requis : administrateur

    Procédure

    1. À partir de votre ServiceNow instance, accédez à Automatisation des processus > Concepteur de flux.
      Flow Designer apparaît 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 le même identificateur unique que celui que vous avez spécifié dans Créer un Zendesk client OAuth.
      Secret client OAuth Clé secrète qui est affectée à votre Zendesk client OAuth. Saisissez la même clé secrète que celle que vous avez copiée 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 se remplit 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 du 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