Configurer une source Microsoft Dataverse pour la CDC

Datastream vous permet de diffuser des données modifiées d'un environnement Microsoft Dataverse vers une destination compatible, telle que BigQuery ou Cloud Storage. Pour préparer votre source, vous devez enregistrer un client OAuth 2.0 dans Microsoft Entra ID, configurer un utilisateur d'application Dataverse et autoriser les adresses IP publiques Datastream si nécessaire.

Avant de commencer

Avant de commencer à configurer Dataverse pour l'utiliser avec Datastream, vous devez effectuer les opérations suivantes :

  • 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.
  • Savoir comment naviguer 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 cela, 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, saisissez 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. Une fois l'enregistrement effectué, copiez l'ID (client) de l'application et l'ID (de locataire) de l'annuaire depuis la page Vue d'ensemble vers un emplacement sécurisé 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. Saisissez une description et définissez une date d'expiration pour votre code secret.
    3. Cliquez sur Ajouter.

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

  7. Attribuez des autorisations d'API :

    1. Accédez à Autorisations d'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 annuaire.

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 d'application.
  4. Cliquez sur Nouveau pour créer un utilisateur d'application.
  5. Collez l'ID (client) de l'application copié à partir d'AAD dans le champ ID de l'application. D'autres informations, telles que 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 d'application que vous venez de créer.
    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 en lecture aux métadonnées de la table.

Restrictions liées aux adresses IP

Si votre environnement ou réseau Dataverse est soumis à des restrictions liées aux adresses 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).

Étape suivante