Enregistrer l'intégration dans Microsoft Entra ID

Remarque :  Cet article s’applique à l’intégration des actions de données Microsoft Dynamics 365.

Avant d'ajouter l'intégration des actions de données Microsoft Dynamics 365, vous devez créer une application dans le centre d'administration de Microsoft Entra. Enregistrement de l'application :

  • Accorde les autorisations nécessaires au fonctionnement de l'application.
  • Génère un identifiant d'application qui est requis pour les informations d'identification lorsque vous ajoutez l'intégration des actions de données Microsoft Dynamics 365.

Enregistrer une application dans Microsoft Entra ID

Pour enregistrer une application dans votre locataire Microsoft Entra :

  1. Connectez-vous au centre d'administration de Microsoft Entra.
  2. Naviguez vers Entra ID > App registrations.
  3. Cliquez sur Nouvelle inscription.
  4. Entrez les informations suivantes :
    • Nom : Nom de application, par exemple, intégration des actions de données Microsoft Dynamics 365.
    • Types de comptes pris en charge: Sélectionnez l'option Comptes dans ce répertoire d'organisation uniquement pour un seul locataire.
      Note: Le champ Redirect URL n'est pas utilisé par l'intégration des actions de données Microsoft Dynamics 365 et ne doit pas être défini.
  5. Cliquez sur registre.

    application apparaît dans la liste des applications enregistrées.

Mise en place de l'authentification pour l'application

Vous pouvez soit créer un secret client, soit télécharger un certificat de confiance émis par une autorité de certification.

Créer un secret client

  1. Dans App registrations, sélectionnez votre application.
  2. Sélectionnez Certificats et secrets > Secrets clients et cliquez sur Nouveau secret client.
  3. Ajouter une description pour le client.
  4. Entrez une durée pour l'expiration du secret du client. Choisissez la durée qui correspond à la politique de sécurité de votre organisation.
  5. Cliquez sur Ajouter.
  6. Notez le secret du client Valeur pour l'utiliser dans votre code d'application client.
    Note: Cette valeur secrète n'est plus jamais affichée après que vous avez quitté cette page.

Télécharger un certificat de confiance

Utilisez ou générez un certificat de confiance comme décrit dans la documentation Microsoft et assurez-vous que la clé privée est accessible pour la configuration du justificatif d'identité d'intégration dans Genesys Cloud.

  1. Dans App registrations, sélectionnez votre application.
  2. Sélectionnez Certificats et secrets > Secrets clients.
  3. Cliquez sur Télécharger le certificat.
  4. Sélectionnez le fichier de certificat à télécharger.
  5. Cliquez sur Ajouter.

Lorsque vous téléchargez le certificat, l'empreinte, la date de début et les valeurs d'expiration du certificat s'affichent. Pour plus d'informations sur l'utilisation d'un certificat de confiance, voir Set up authentication dans la documentation de Microsoft Entra. 

Avertissement: Lors de l'utilisation d'un secret client ou d'un certificat pour l'intégration de Microsoft Dynamics 365 avec Genesys Cloud, il est important de comprendre que les secrets clients et les certificats expirent en fonction de la durée définie lors de la création. Pour éviter toute interruption, veillez à générer un nouveau secret client ou à télécharger un nouveau certificat, et mettez à jour les informations d'identification de l'intégration avant leur expiration.

Notez les détails suivants lorsque vous enregistrez l'application avec l'un des types d'accréditation :

  • Pour le secret du client
    • ID de l'application
    • Secret du client
  • Pour le certificat
    • ID de l'application
    • Empreinte du certificat
    • Clé privée du certificat

Créer un utilisateur d'application

Créez un utilisateur d'application dans Microsoft Dynamics 365 qui représente une application externe. Il est utilisé pour permettre un accès sécurisé et non interactif à l'API par les applications Azure enregistrées pour les intégrations.

Pour créer un utilisateur d'application :

  1. Connectez-vous au centre d'administration de Power Platform.
  2. Sélectionnez Environments dans le volet de navigation et sélectionnez un environnement dans la liste.
  3. Sélectionnez Settings.
  4. Sélectionnez Users + permissions, puis Application users.
  5. Pour ouvrir la page Créer un nouvel utilisateur d'application, sélectionnez + Nouvel utilisateur d'application.
  6. Sélectionnez + Ajouter une application, choisissez l'application Microsoft Entra enregistrée qui a été créée pour l'utilisateur de l'application, puis sélectionnez Ajouter.
  7. Sous Business Unit, sélectionnez une unité dans la liste.
  8. Sous Security Roles, sélectionnez les rôles à ajouter au nouvel utilisateur de l'application.
  9. Cliquez sur Save puis sur Create.

L'application créée par l'utilisateur est automatiquement activée par défaut. Un utilisateur d'application active a accès aux données de votre environnement au nom de l'utilisateur qui accède à l'application enregistrée.

Pour plus d'informations, voir les articles suivants dans la documentation de Microsoft Entra :

    Suivant, ajouter l’intégration.

    Pour plus d’informations sur l’intégration, voir À propos de l’intégration des actions de données Microsoft Dynamics 365.