Votre environnement Dataverse doit être configuré pour permettre à l'enregistrement de l'application d'accéder aux données. Cela implique la création d'un utilisateur d'application et l'attribution des rôles de sécurité appropriés.
Autorisations requises
Pour créer un utilisateur d'application et attribuer des rôles de sécurité dans Dataverse, vous devez disposer des éléments suivants :
| Autorisation | Objectif |
| Rôle de sécurité Administrateur système | Requis pour créer des utilisateurs d'application et attribuer des rôles de sécurité dans l'environnement Dataverse |
| Administrateur Power Platform ou administrateur global | Requis pour accéder au centre d'administration Power Platform afin de gérer les paramètres de l'environnement |
| 💡 Remarque : si vous avez accès à l'environnement Dataverse mais que vous ne pouvez pas créer d'utilisateurs d'application, contactez votre administrateur Power Platform pour qu'il effectue cette configuration ou vous attribue le rôle d'administrateur système. | |
Création d'un utilisateur d'application
Un utilisateur d'application relie l'enregistrement de votre application à Dataverse, ce qui permet à Data Mission Sync de s'authentifier :
1. Connectez-vous au Centre d'administration Power Platform (https://admin.powerplatform.microsoft.com).
2. Sélectionnez Environnements dans le menu de navigation de gauche, puis sélectionnez votre environnement cible.
3. Sélectionnez Paramètres dans le menu supérieur.
4. Développez Utilisateurs + autorisations, puis sélectionnez Utilisateurs de l'application.
5. Cliquez sur + Nouvel utilisateur d'application.
6. Cliquez sur + Ajouter une application pour rechercher votre enregistrement d'application par nom ou ID client.
7. Sélectionnez votre application et cliquez sur Ajouter.
8. Sélectionnez l'unité commerciale (généralement l'unité commerciale racine).
9. Sous Rôles de sécurité, vous attribuerez des rôles à l'étape suivante.
10. Cliquez sur Créer.
Attribution des rôles de sécurité
L'utilisateur de l'application a besoin d'un rôle de sécurité qui lui accorde les autorisations minimales requises pour que Data Mission Sync puisse lire vos données. Nous vous recommandons de créer un rôle personnalisé avec uniquement les accès dont vous avez besoin.
Autorisations minimales requises
Data Mission Sync nécessite les autorisations suivantes pour fonctionner :
| Autorisation | Objectif |
| Lecture des tables synchronisées | Nécessaire pour extraire les données de chaque table que vous souhaitez synchroniser. Accorder l'autorisation de lecture au niveau de l'organisation pour un accès complet à tous les enregistrements. |
| Lecture des métadonnées des tableaux | Requis pour récupérer les schémas des tables (colonnes, types de données, relations) afin de créer la structure de la base de données cible. Accordé automatiquement avec la permission de lecture sur les tables. |
| Affichage de l'historique d'audit (facultatif) | Requis uniquement si vous souhaitez synchroniser la table d'audit. Nécessite également le droit de lecture sur l'entité d'audit. |
Option 1 : créer un rôle personnalisé (recommandé)
Créez un rôle de sécurité personnalisé avec un accès en lecture seule à des tables spécifiques. Cela suit le principe du moindre privilège :
1. Dans le centre d'administration Power Platform, accédez à votre environnement → Paramètres → Rôles de sécurité.
2. Cliquez sur + Nouveau rôle et donnez-lui un nom (par exemple, « Lecteur de synchronisation de mission de données »).
3. Pour chaque table que vous souhaitez synchroniser, définissez le privilège Lecture au niveau Organisation (cercle rempli).
4. Si vous synchronisez les journaux d'audit : définissez également Lecture sur l'entité Audit et activez Afficher l'historique d'audit sous Privilèges divers.
5. Enregistrez le rôle et attribuez-le à votre utilisateur d'application.
| Exigence de suivi des modifications : chaque table que vous synchronisez doit avoir le suivi des modifications activé dans Dataverse. Il s'agit d'un paramètre de table, et non d'une autorisation de rôle de sécurité. Data Mission Sync vérifiera cela lors de la première synchronisation d'une table et signalera une erreur si le suivi des modifications n'est pas activé. |
Option 2 : utiliser l'administrateur système (démarrage rapide uniquement)
Pour les tests initiaux ou la validation du concept, vous pouvez attribuer le rôle d'administrateur système qui accorde un accès complet à toutes les tables. Cependant, cela n'est pas recommandé pour une utilisation en production, car cela accorde beaucoup plus d'accès que nécessaire.
| ⚠ Important : n'utilisez pas le rôle de personnalisateur système, car il accorde l'accès à la personnalisation des tables et des métadonnées, mais pas à la lecture des données des tables. |
Vérification des autorisations
Si l'utilisateur de l'application ne dispose pas des autorisations suffisantes, vous pouvez rencontrer les erreurs suivantes :
| Erreur | Solution |
| 403 Accès refusé ou « Autorisations insuffisantes » | Accorder l'accès en lecture à la table au niveau de l'organisation |
| Le tableau n'apparaît pas dans la liste de sélection | Vérifiez que l'utilisateur de l'application dispose d'un accès en lecture à la table |
| « Le suivi des modifications n'est pas activé » | Activez le suivi des modifications sur la table dans Dataverse (il ne s'agit pas d'un problème d'autorisation) |
| L'audit de synchronisation échoue avec une erreur d'autorisation | Accordez le privilège « Afficher l'historique d'audit » et « Lire » sur l'entité Audit |
Rechercher l'URL de votre environnement
Vous aurez besoin de l'URL de votre environnement Dataverse pour configurer la connexion source dans Data Mission Sync :
1. Dans le centre d'administration Power Platform, sélectionnez votre environnement.
2. Recherchez le champ URL de l'environnement (par exemple, https://yourorg.crm.dynamics.com).
3. Copiez cette URL : vous devrez la saisir dans Data Mission Sync.
Un environnement par profil
| Chaque environnement Dataverse ne peut être connecté qu'à un seul profil Data Mission Sync. En effet, Data Mission Sync utilise l'API de suivi des modifications de Dataverse, qui conserve l'état de chaque environnement. Si vous devez synchroniser le même environnement vers plusieurs cibles, contactez le support technique pour obtenir de l'aide. |