Configurer MicrosoftSpoke Dynamics CRM

  • Rversion finale: Xanadu
  • Mis à jour 3 août 2023
  • 7 minutes de lecture

    • Intégrez l’instance ServiceNow et utilisez les Windows informations d’identification pour authentifier ServiceNow Microsoft Dynamics CRM les demandes.

    Avant de commencer

    • Installer Microsoft AD
    • Demander Hub d'intégration un abonnement.
    • Activez le MicrosoftSpoke Dynamics CRMfichier .
    • Rôle requis : admin.

    Pourquoi et quand exécuter cette tâche

    Effectuez ces étapes pour utiliser toutes les MicrosoftSpoke Dynamics CRM actions.

    Configurer Microsoft Dynamics CRM l’application

    Créez une application OAuth personnalisée à partir de votre Microsoft Dynamics CRM compte pour activer l’authentification OAuth 2.0 avec le Microsoft Dynamics CRM.

    Avant de commencer

    Microsoft Dynamics CRM Exigences:
    • Microsoft Dynamics CRM compte
    • Compte Microsoft Azure
    • Rôle requis : Microsoft Dynamics CRM admin

    Pourquoi et quand exécuter cette tâche

    Suivez ces étapes à partir de votre compte Azure Developer. Consultez la documentation du produit Azure pour obtenir des instructions sur la création et la configuration d’applications personnalisées.

    Procédure

    1. Connectez-vous au portail d’inscription des applications Microsoft Azure avec les informations d’identification de votre organisation.
    2. Enregistrez une nouvelle application personnalisée en renseignant le nom de l’application, le type de compte pris en charge et l’URI de redirection, puis cliquez sur Enregistrer.
      Une vue d’ensemble des informations de base de l’application s’affiche.
    3. Copiez l’ID de l’application dans un fichier texte.
      Vous utiliserez cet ID et le secret client généré lors de l’étape suivante pour enregistrer l’application en tant que fournisseur OAuth tiers sur votre ServiceNow instance. Vous utilisez l’ID d’application comme ID client lorsque vous connectez l’application à ServiceNow.
    4. Ajoutez un secret client.
      1. Dans Microsoft Azure, accédez à Gérer  > Certificats et secrets.
      2. Fournissez une description et une date d’expiration, puis cliquez sur Ajouter.
        Remarque :
        Le secret client ne s’affiche en texte brut que pendant une courte période. Vous utilisez le secret client lorsque vous connectez l’application à ServiceNow.
    5. Activez les autorisations que l’application doit prendre en charge.
      Pour plus d’informations, consultez la référence des autorisations Microsoft Graph.
      1. Dans Microsoft Azure, accédez à Gérer  > Autorisations d’API.
      2. Cliquez sur la vignette Microsoft Graph.
      3. Sélectionnez les autorisations déléguées ou d’application que l’application prend en charge.
        Les autorisations déléguées permettent à l’application d’accéder à l’API en tant qu’utilisateur connecté. Les autorisations d’application permettent à l’application de s’exécuter en tant que service ou démon en arrière-plan sans utilisateur connecté.
      4. Cliquez sur Ajouter des autorisations.

    Que faire ensuite

    S’inscrire Microsoft Dynamics CRM en tant que fournisseur OAuth.

    S’inscrire Microsoft Dynamics CRM en tant que fournisseur OAuth

    Utilisez les informations générées pendant Microsoft Dynamics CRM la configuration du compte pour vous inscrire Microsoft Dynamics CRM en tant que fournisseur OAuth et permettre à l’instance de demander des jetons OAuth 2.0.

    Avant de commencer

    • Demander Hub d'intégration un abonnement.
    • Activez Microsoft Dynamics CRM.
    • Créer une Microsoft Dynamics CRM application.
    • Rôle requis : admin.

    Procédure

    1. Dans ServiceNow, accédez à OAuth système > Registre d'application.
    2. Cliquez sur Nouveau.
    3. Dans l’écran intitulé Quel type d’application OAuth, sélectionnez Se connecter à un fournisseur OAuth tiers.
    4. Renseignez les champs du formulaire.
      Tableau 1. Formulaire des registres d'application
      Champ Valeur requise
      Nom Entrez un nom pour identifier l’enregistrement de façon unique, par exemple Profil OAuth Dynamics CRM.
      ID client Entrez l’ID de l’application Microsoft Dynamics CRM que vous avez créée dans Azure.
      Secret client Saisissez le secret client que vous avez généré lors de la création de l’application dans Azure.
      Type d'accord par défaut Sélectionnez Code d'autorisation.
      URL d'autorisation Cliquez sur l’icône de verrouillage ( icône de verrouillage), saisissez https://login.microsoftonline.com/common/oauth2/v2.0/authorize suivi d’un point d’interrogation et de l’attribut de ressource de votre instance, puis cliquez à nouveau sur l’icône de verrouillage. L’attribut de ressource de l’URL. Par exemple, ?resource=https ://mycompany.crm.dynamics.com. Cet attribut correspond à l’URL de votre Microsoft application.
      URL de jeton Cliquez sur l’icône de verrouillage ( icône de verrouillage), saisissez https://login.microsoftonline.com/common/oauth2/v2.0/token, puis cliquez à nouveau sur l’icône de verrouillage.
      URL de redirection Cliquez sur l’icône de verrouillage ( icône de verrouillage), saisissez https://<instance>.service-now.com/oauth_redirect.do, puis cliquez à nouveau sur l’icône de verrouillage.
    5. Dans la liste connexe Périmètres des entités OAuth , modifiez le périmètre de l’entité fourni pour inclure l’URL de votre Microsoft Dynamics CRM application.

      Le nom et le périmètre OAuth sont souvent la même chaîne.

      Périmètres de l’entité OAuth Microsoft Dynamics CRM.
    6. Cliquez avec le bouton droit de la souris sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
      Le système valide les informations d’identification OAuth.

    Que faire ensuite

    Créez un enregistrement d’informations d’identification pour Microsoft Dynamics CRM.

    Créer des enregistrements d’informations d’identification pour le MicrosoftSpoke Dynamics CRM

    Créez des enregistrements d’informations d’identification pour l’application OAuth personnalisée que vous avez créée pendant Microsoft Dynamics CRM la Microsoft Dynamics CRM configuration du compte. Les MicrosoftSpoke Dynamics CRM alias de connexion et d’informations d’identification utilisent ces informations d’identification pour autoriser des actions.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Connexions et informations d'identification > Informations d'identification.
    2. Cliquez sur Nouveau.
      Le système affiche le message Quel type d’informations d’identification voulez-vous créer ?
    3. Sélectionnez Informations d'identification OAuth 2.0.
      La fenêtre contextuelle affiche un formulaire d’informations d’identification OAuth 2.0 vide.
    4. Entrez ces valeurs.
      Champ Valeur requise
      Nom Saisissez un nom pour identifier l’enregistrement de façon unique. Par exemple, entrez Informations d’identification Dynamics.
      Actif Activer
      Profil de l'entité OAuth Sélectionnez le profil OAuth que vous avez créé lors de l’enregistrement de l’application personnalisée Microsoft Dynamics CRM en tant que fournisseur OAuth. Par exemple, sélectionnez le profil Dynamics OAuth.
      Ordre Sélectionnez la commande d’application de ces informations d’identification. Par exemple, saisissez 100.
    5. Enregistrez l'enregistrement.
    6. Dans Liens connexes, cliquez sur Obtenir un jeton OAuth.
      Le système affiche un message de confirmation indiquant que le flux de jetons OAuth a été effectué avec succès. Passez en revue les détails si le flux n’est pas terminé avec succès.
      Remarque :
      Assurez-vous d’autoriser les fenêtres contextuelles dans votre navigateur.

    Créer des enregistrements de connexion pour le MicrosoftSpoke Dynamics CRM

    Créez des enregistrements de connexion à votre compte Microsoft Azure. Les alias de connexion et d’informations d’identification MicrosoftSpoke Dynamics CRM utilisent ces connexions pour effectuer des actions sur Microsoft Dynamics CRM.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Connexions et informations d'identification > Alias de connexion et d'informations d'identification.
    2. Ouvrez l’alias de connexion et d’informations d’identification de l’application Microsoft Dynamics CRM .
    3. Dans l’onglet Connexions , cliquez sur Nouveau.
      Le système affiche un formulaire de connexion HTTP(s) vide.
    4. Entrez ces valeurs.
      Champ Valeur requise
      Nom Saisissez un nom pour identifier de façon unique l’enregistrement de connexion. Par exemple, entrez Connexion MS Dynamics CRM.
      Informations d'identification Sélectionnez l’enregistrement Informations d’identification que vous avez créé pour Microsoft Dynamics CRM. Par exemple, sélectionnez Informations d’identification MS Dynamics.
      Alias de connexion Sélectionnez l’enregistrement d’alias de connexion que vous avez créé pour Microsoft Dynamics CRM.
      Actif Activer
      URL de connexion Saisissez l’URL dynamique racine. Par exemple, https://<SiteName>.dynamics.com.
    5. Cliquez sur Envoyer.

    Configurer les Microsoft Dynamics CRM détails du Webhook

    Enregistrez un Microsoft Dynamics CRM webhook dans ServiceNow pour notifier l’application ServiceNow lorsque certains événements se produisent dans Microsoft Dynamics CRM.

    Avant de commencer

    Rôle requis : administrateur
    • Microsoft Dynamics CRM nécessite une inscription via l’outil d’inscription du module d’extension Windows. Pour installer l’outil d’inscription du module d’extension Windows, consultez le document Microsoft Télécharger des outils à partir de NuGet.
    • L’URL du point de terminaison est l’URL de l’instance ServiceNow sur laquelle les informations d’événement sont publiées. Par exemple, https://<nom-instance>.service-now.com/api/sn_ms_crm_spoke/dynamics_webhook_callbacks.
    • La paire clé-valeur que vous utilisez pour enregistrer le webhook dans l’outil d’inscription du module d’extension est la même que le nom et la clé d’autorisation dans les détails du webhook Dynamics CRM.

    Procédure

    1. Accédez à la Tout > Détails du webhook Dynamics CRM > Informations du client.
    2. Cliquez sur Nouveau.
    3. Dans le champ Nom , saisissez la clé de module d’extension du webhook.
    4. Dans le champ Clé d’autorisation , entrez la valeur de la paire clé-valeur du webhook.

    Configurer la Microsoft Dynamics CRM politique de décision Webhook

    Créez une politique d’acheminement de webhook et un flux secondaire en fonction de vos besoins.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Concepteur de flux > Concepteur
    2. Cliquez sur Flux secondaires.
    3. Créez une copie du flux secondaire par défaut, Process Dynamics CRM Webhook.
    4. Personnalisez le flux secondaire en fonction de vos besoins et publiez-le.
      Pour plus d’informations sur la création et l’utilisation de flux secondaires, consultez la rubrique Create a subflow in Workflow Studio
    5. Accédez à la Détails du webhook Dynamics CRM > Politique décisionnaire.
    6. Cliquez sur Nouveau dans l’onglet Décisions.
    7. Renseignez les champs du formulaire.
      Tableau 2. Formulaire Décision
      Champ Description
      Étiquette Étiquette unique pour identifier la politique d’acheminement.
      Réponse Option permettant de spécifier si cette réponse est la réponse par défaut. La réponse par défaut s’applique lorsque les conditions ne sont pas remplies.
      1. Cliquez sur l’icône Rechercher.
      2. Sélectionnez le flux secondaire requis dans la liste Document : .
        Remarque :
        Assurez-vous que le nom de la table est Flux secondaire de réponse au webhook Dynamics CRM [sn_ms_crm_spoke_dynamic_crm_webhook_answer_subflow].
      Condition Conditions à remplir lorsque les événements requis se produisent dans Microsoft Dynamics CRM.
    8. Cliquez sur Envoyer.
      Remarque :
      Ces politiques d’acheminement sont enregistrées dans les tables de décision. Les utilisateurs sont mis en garde contre la mise à jour ou la modification directe des données de ces tables.

    Résultats

    La politique de décision et le flux secondaire sont créés.