Configurer une source Microsoft Dataverse pour la CDC

Cette page explique comment configurer un environnement Microsoft Dataverse pour diffuser des données de modification vers une destination compatible à l'aide de Datastream.

Avant de commencer

Avant de commencer à configurer Dataverse pour l'utiliser avec Datastream, vous devez :

  • Avoir accès à un abonnement Microsoft Azure actif avec les autorisations nécessaires pour gérer Azure Active Directory (AAD) et Dataverse.
  • Disposer d'un environnement Dataverse actif.
  • Vous savez comment parcourir et modifier les paramètres dans le portail Microsoft Azure, Dataverse et Dynamics 365.
  • Disposer des autorisations nécessaires pour enregistrer des applications dans AAD et créer ou attribuer des rôles dans Dataverse.

Configurer un environnement Microsoft Dataverse pour l'utiliser avec Datastream

Pour établir une connexion entre votre environnement Dataverse et Datastream, vous devez vous authentifier à l'aide du flux d'identifiants client OAuth 2.0. Pour ce faire, vous devez enregistrer une application dans AAD et configurer un utilisateur d'application dans Dataverse.

Enregistrer une application dans Azure Active Directory

Dataverse utilise AAD pour l'authentification. Pour enregistrer une application, procédez comme suit :

  1. Connectez-vous au portail Azure avec un compte administrateur.
  2. Dans le portail, accédez à Azure Active Directory > Inscriptions d'applications > Nouvelle inscription.

  3. Enregistrez l'application :

    1. Sous Nom de l'application, indiquez le nom de votre application (par exemple, DatastreamDataverseConnector).
    2. Sélectionnez le type de compte, généralement Comptes dans cet annuaire organisationnel uniquement.
    3. Cliquez sur S'inscrire.

  4. Après l'enregistrement, copiez l'ID (client) de l'application et l'ID (de locataire) de l'annuaire depuis la page Overview (Vue d'ensemble) vers un emplacement sûr pour une utilisation ultérieure. Ces ID sont requis pour le profil de connexion Datastream.

  5. Générez le code secret du client :

    1. Dans les paramètres de l'application enregistrée, accédez à Certificats et codes secrets > Nouveau code secret du client.
    2. Indiquez une description et définissez une date d'expiration pour votre secret.
    3. Cliquez sur Ajouter.

  6. Copiez la valeur secrète générée, car elle ne s'affiche qu'une seule fois. Vous aurez besoin du code secret lorsque vous créerez le profil de connexion Datastream.

  7. Attribuez des autorisations d'API :

    1. Accédez à Autorisations des API > Ajouter une autorisation.
    2. Sélectionnez API Microsoft > Dynamics CRM.
    3. Sélectionnez Autorisations de l'application.
    4. Cliquez sur Accorder le consentement administrateur pour votre répertoire.

Configurer l'utilisateur de l'application Dataverse

Créez un utilisateur d'application dans Dataverse pour représenter l'application AAD.

  1. Connectez-vous à votre environnement Microsoft Dataverse avec des droits d'administrateur.
  2. Accédez à Paramètres > Sécurité > Utilisateurs.
  3. Passez de la vue Utilisateurs activés à la vue Utilisateurs de l'application.
  4. Cliquez sur Nouveau pour créer un utilisateur de l'application.
  5. Collez l'ID (client) de l'application copié depuis AAD dans le champ ID d'application. D'autres informations, comme le nom d'utilisateur, sont renseignées automatiquement.
  6. Sauvegardez l'enregistrement.

  7. Attribuez des rôles de sécurité :

    1. Ouvrez l'enregistrement de l'utilisateur de l'application nouvellement créé.
    2. Cliquez sur Gérer les rôles.
    3. Attribuez les rôles de sécurité appropriés qui accordent les autorisations de lecture nécessaires pour les tables que vous souhaitez que Datastream réplique. Nous vous recommandons d'utiliser un rôle personnalisé avec les autorisations de lecture minimales requises sur les tables spécifiques plutôt qu'un rôle général, tel que Administrateur système. Assurez-vous que le rôle a accès aux métadonnées de la table en lecture.

Restrictions liées à la propriété intellectuelle

Si votre environnement ou réseau Dataverse comporte des restrictions d'adresse IP, assurez-vous que les adresses IP publiques Datastream sont autorisées à se connecter à l'URL de votre environnement Dataverse (par exemple, ORGANIZATION_NAME.crm.dynamics.com).

Étapes suivantes