Intégration à Zendesk

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 7 minutes de lecture

    • L’intégration de votre Gestion des actifs logiciels application à l’application Zendesk vous permet de suivre vos abonnements logiciels et de récupérer les licences inutilisées.

    Important :
    Minimisez les risques de sécurité et protégez les informations en accordant l’accès uniquement aux autorisations nécessaires de l’utilisateur ou de l’API.
    Tableau 1. Autorisations utilisateur minimales
    Processus Rôle d’utilisateur requis dans l’application Zendesk Périmètres d’authentification
    Télécharger les abonnements Agent léger Néant
    Pull user activity (Transférer l’activité utilisateur) Agent léger Néant
    Récupérer l'abonnement administrateur Néant

    Créer un Zendesk client OAuth

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

    Avant de commencer

    Zendesk Rôle requis : admin

    Procédure

    1. Depuis un navigateur Web, ouvrez Zendesk.
    2. Connectez-vous à l’aide de vos informations d’identification d’administrateur.
    3. Dans le menu de navigation de gauche d’Espace de travail d’agentZendesk, sélectionnez l’icône Administrateur (icône Administrateur).
    4. Accédez à l’Admin Center à partir de la page Admin. Dans le menu Admin, accédez à Applications et intégrations > API.
      La page API Zendesk s’ouvre.
    5. Sélectionnez l’onglet Clients OAuth , puis Ajouter un client OAuth.
    6. Renseignez les champs du formulaire.
      Tableau 2. 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.

      Sélectionnez le carré vert pour localiser et sélectionnez 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.
      Type de client Ce champ doit être défini sur Confidentiel. Les clients d’authentification confidentiels s’exécutent sur des serveurs sécurisés, où leurs informations d’identification peuvent être conservées en toute sécurité.
      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.
    7. Sélectionnez Enregistrer.
    8. Dans la boîte de dialogue, sélectionnez OK.
      La boîte de dialogue se ferme et le formulaire se recharge à nouveau.
    9. Copiez la valeur du champ Secret .
      Enregistrez la valeur secrète 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 celle-ci puisse récupérer les données utilisateur de vos applications.

    Avant de commencer

    ServiceNow Rôle requis : 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 sélectionnez Configurer.
    4. Renseignez les champs de la boîte de dialogue.
      Tableau 3. 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. Sélectionnez Créer et obtenir un jeton OAuth.
      Remarque :
      Pour connaître le rôle requis pour effectuer cette étape, consultez la table Autorisations utilisateur minimales .
    6. Dans la boîte de Zendesk dialogue Autorisation OAuth, sélectionnez Autoriser.
      Le jeton d’accès OAuth devient disponible pour autoriser votre Zendesk connexion.

    Créer un profil d'intégration Zendesk

    Créez un profil d’intégration Zendesk pour suivre les abonnements logiciels et optimiser la gestion des licences pour vos Zendesk applications.

    Avant de commencer

    Pour créer un profil d’intégration, demandez le module d’extension ZendeskGestion des actifs logiciels - Gestion des licences SaaS (sn_sam_saas_int) auprès de ServiceNow Store.

    ServiceNow Rôle requis : sam_integrator ou admin

    Important :
    Vous devez cocher la case Spoke Zendesk pour cette intégration lors de l’installation des fonctionnalités facultatives sur la Application Manager page. Pour plus d’informations sur le choix des applications SaaS requises, reportez-vous à la section Demander le Gestion des licences SaaS.

    Pourquoi et quand exécuter cette tâche

    Si vous utilisez Software Asset Workspace, l’option de création du profil d’intégration Zendesk dans Interface utilisateur principale est inactive.

    Procédure

    1. Accédez au profil d’intégration.
      InterfaceAction
      Interface utilisateur principale
      1. Accédez à la Tout > Actifs Logiciels > Licence SaaS > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez le profil d’intégration Zendesk.
      Espace de travail des ressources logicielles
      1. Accédez à la Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez Zendesk dans la liste déroulante.
      4. Sélectionnez Continuer.
    2. Renseignez les champs du formulaire.
      Tableau 4. Formulaire Profil d’intégration
      Champ Description
      Nom d'affichage Nom du profil d’intégration. Par exemple, Intégration Zendesk.
      Statut État du profil d'intégration.
      • Si vous n’avez pas publié le profil d’intégration, ce champ est automatiquement défini sur Brouillon.
      • Si vous avez déjà publié le profil d’intégration, ce champ est automatiquement défini sur Publié.
      Type de profil Type de profil d'intégration.

      Ce champ est automatiquement défini sur Abonnement Zendesk.
    3. Examinez les rôles d’utilisateur requis ou les autorisations d’API spécifiés dans le champ de configuration du fournisseur pour chaque processus afin de minimiser les risques de sécurité et d’optimiser SaaS les licences.
      Remarque :
      Pour plus d’informations, consultez Table des autorisations utilisateur minimales .
      1. Dans la section Télécharger le flux secondaire d’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnements de téléchargement Zendesk.
        Remarque :
        La case Télécharger les abonnements est cochée par défaut et vous ne pouvez pas la désactiver.
      2. Dans la section Récupérer le flux secondaire d’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnement de récupération Zendesk.
        Remarque :
        La case Récupérer les abonnements est cochée par défaut. Si vous ne souhaitez pas récupérer les abonnements, vous pouvez décocher cette case. Si vous l’effacez, les candidats à la suppression sont créés, mais le flux secondaire d’abonnement de récupération n’est pas déclenché ou le processus de réclamation n’est pas initié.
    4. Sélectionnez Enregistrer.
      Votre ServiceNow instance crée une ébauche de profil d’intégration.

      Le champ Connexion et informations d’identification s’affiche et est automatiquement défini sur sn_zendesk_spoke. Zendesk.

    5. Sur le formulaire de profil d’intégration, sélectionnez Valider la connexion pour vérifier les détails de connexion et d’informations d’identification de cette intégration.

      La validation de la connexion vérifie les API de téléchargement d’abonnements, mais pas les API de récupération d’abonnements.

    6. Une fois la connexion vérifiée, sélectionnez Publier.
    7. Dans la boîte de dialogue Publier la confirmation, sélectionnez OK.

    Que faire ensuite

    Une fois l’intégration connectée, votre ServiceNow instance crée automatiquement des modèles logiciels, des règles de réclamation et des abonnements logiciels qui sont actualisés quotidiennement.

    Si vous souhaitez configurer plusieurs profils d’intégration avec des connexions uniques, créez des alias enfants pour gérer différentes configurations et paramètres pour chaque profil d’intégration. Pour plus d'informations, consultez Créer un alias enfant pour configurer plusieurs profils d’intégration.

    Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements utilisateur. Pour plus d'informations, consultez Examiner une règle de réclamation de logiciel.

    Créez des autorisations logicielles pour les modèles logiciels générés automatiquement afin de suivre les logiciels utilisés par rapport aux logiciels possédés.
    Le rapprochement s’exécute également sur vos abonnements en tant que tâche planifiée ou à la demande. Vous pouvez afficher vos résultats de rapprochement dans la console de licence (Gestion des actifs logiciels application classique) ou dans la vue Utilisation de la licence (Software Asset Workspace). Utilisez ces résultats pour déterminer votre position en matière de conformité de licence et corriger toute non-conformité.