Graph Data Connect et autorisations Microsoft Graph : configuration, consentement, moindre privilège
Par Mirko Peters ·
Ce que fait Microsoft Graph Data Connect, en quoi il se distingue de l’API Graph, les étapes de configuration et d’approbation, ainsi que le fonctionnement des autorisations Graph (déléguées, d’application, consentement).
Traduit automatiquement par IA à partir de l'article original. Lire l'original en anglais
Microsoft Graph Data Connect et les autorisations Microsoft Graph sont deux sujets distincts, qui sont pourtant souvent recherchés ensemble. Data Connect est un service d’extraction de données en masse destiné aux analyses Microsoft 365. Les autorisations Graph contrôlent ce qu’une application peut faire via l’API Graph. Les deux reposent sur le consentement et les deux encouragent la même bonne pratique : demander le niveau d’accès minimal permettant d’accomplir la tâche.
Points clés
- Graph Data Connect extrait en masse des données Microsoft 365 vers un stockage Azure à des fins d’analyse. L’API Graph convient à de petits volumes de données provenant d’utilisateurs et de groupes sélectionnés.
- La configuration nécessite un administrateur général pour l’activer, une inscription d’application Entra, un compte Azure Storage et une approbation administrateur de la demande d’accès aux données.
- Les pipelines impliquent une surcharge d’environ 45 minutes, et une première exécution peut dépasser 40 minutes, consentement compris.
- Les autorisations Graph existent en deux types. Les autorisations déléguées agissent au nom d’un utilisateur connecté. Les autorisations d’application agissent sans utilisateur et nécessitent le consentement d’un administrateur.
- Microsoft recommande le modèle délégué lorsqu’il répond aux besoins de l’application, ainsi que l’autorisation la plus restreinte qui fonctionne.
- Les noms d’autorisations suivent le format {resource}.{operation}.{constraint}, par exemple Application.ReadWrite.OwnedBy.
Ce qu’est Graph Data Connect
Microsoft décrit Data Connect comme un accès sécurisé et évolutif aux jeux de données Microsoft 365 dans Microsoft Fabric, Azure Synapse et Azure Data Factory, destiné aux analyses d’entreprise. Les données proviennent de sources telles que Microsoft Entra ID, Outlook, Teams, SharePoint, Viva Insights et les groupes Microsoft.
Les jeux de données se répartissent en trois catégories : de base (contenu brut créé par le client), nettoyés (normalisés ou dédupliqués) et sélectionnés (conçus pour un scénario précis). La liste des jeux de données comprend, par exemple, TeamsCallRecords_v1, SharePointPermissions_v1, GroupMembers_v0 et PlannerTasks_v0. Les jeux de données Viva Insights nécessitent une licence Viva Insights, qui est la seule mention de licence figurant sur la page des jeux de données.
Data Connect ou API Graph
La FAQ de Data Connect le formule ainsi : les deux atteignent les mêmes données sous-jacentes. Data Connect extrait de grands volumes en masse à l’échelle de l’organisation. Les API Graph conviennent à de petits volumes de données provenant d’utilisateurs et de groupes sélectionnés. La FAQ suggère de les combiner, par exemple Data Connect pour l’extraction initiale, puis les API Graph pour les traitements en temps réel.
Limites connues d’après la FAQ :
- Les pipelines présentent une surcharge d’environ 45 minutes, quelle que soit la taille des données.
- Les utilisateurs Exchange sur site ne sont pas pris en charge, y compris dans les configurations hybrides.
- Les messages et événements des comptes de ressources ne sont pas pris en charge.
- L’accès aux jeux de données entre locataires n’est pas disponible. Les ressources Azure et Microsoft 365 doivent appartenir au même locataire Entra.
Étapes de configuration
Le guide de démarrage rapide détaille ces étapes. Les noms de menus sont repris tels que Microsoft les présente.
- Activer Data Connect. Connectez-vous à admin.microsoft.com en tant qu’administrateur général. Sélectionnez Paramètres > Paramètres de l’organisation, puis, sous l’onglet Services, sélectionnez Microsoft Graph Data Connect. Cochez l’option permettant de l’activer pour l’ensemble de l’organisation, puis enregistrez.
- Créez l’application Entra. Dans le Centre d’administration Microsoft Entra, accédez à Inscriptions d’applications > Nouvelle inscription. Sélectionnez « Comptes de cet annuaire d’organisation uniquement ». Copiez l’ID d’application (client) et l’ID de locataire, créez un secret client et enregistrez immédiatement sa valeur. Le propriétaire de l’application a besoin d’une boîte aux lettres et, conformément au guide de démarrage rapide, d’un abonnement E5 fonctionnel.
- Créez le stockage Azure. Créez un compte de stockage dans une région correspondant à votre région Microsoft 365. Attribuez à l’application le rôle Contributeur aux données Blob du stockage sous Contrôle d’accès (IAM), puis créez un conteneur privé.
- Inscrivez l’application auprès de Data Connect dans le portail Azure. Choisissez la destination, l’application, ainsi que les jeux de données et les colonnes.
- Approuvez la demande. Un administrateur ouvre Paramètres > Paramètres de l’organisation > Sécurité et confidentialité > Applications Microsoft Graph Data Connect. L’application affiche Pré-consentement. Examinez les jeux de données, puis sélectionnez Approuver. Le guide de démarrage rapide précise qu’il est impossible de s’auto-approuver.
- Exécutez le pipeline dans Synapse, Data Factory ou Fabric. Le statut passe par Initializing, Consent Pending, Extracting Data, Persisting Data puis Succeeded. La première exécution peut dépasser 40 minutes.
Les destinations prises en charge incluent Azure Data Lake Storage Gen2, Azure Storage Blob, Azure SQL DB (uniquement avec les flux de données de mappage) et Microsoft Fabric OneLake. L’authentification par principal de service est le seul mécanisme pris en charge.
Consentement et coûts
Le consentement couvre le périmètre de l’extraction : jeux de données, colonnes, utilisateurs et destination. Une exécution ayant le même périmètre ne nécessite pas de nouvelle demande. La facturation s’effectue via les abonnements Azure, par exécution de pipeline, les unités fractionnaires étant arrondies à l’unité supérieure. Selon l’exemple de la FAQ, 20 exécutions de 500 lignes chacune sont facturées 20 unités, et non 10. Les pages consultées n’indiquent pas les tarifs.
Autorisations Graph : les bases
Pour l’API Graph, Microsoft définit deux types d’autorisations.
| | Déléguées | Application | |---|---|---| | Agissent | Au nom d’un utilisateur connecté | Sans utilisateur | | Accès effectif | Limité par les autorisations de l’application et par celles de l’utilisateur | Toutes les données couvertes par l’autorisation | | Qui peut consentir | Les utilisateurs, ou les administrateurs pour tous les utilisateurs | Administrateur uniquement | | Autres noms | Étendues | Rôles d’application |
Le consentement aux autorisations d’application requiert le rôle Administrateur de rôle privilégié ou Administrateur général. Le consentement des utilisateurs aux autorisations déléguées peut toutefois être restreint par les stratégies de consentement d’application du locataire.
Nommage et moindre privilège
Les autorisations suivent le format {resource}.{operation}.{constraint}. Les exemples de la page utilisent des opérations telles que Read et ReadWrite, ainsi que des contraintes telles que All et OwnedBy. Si aucune contrainte n’est indiquée, l’accès se limite aux données appartenant à l’utilisateur connecté. Par exemple, Application.ReadWrite.OwnedBy ne gère que les applications créées ou détenues par l’application, tandis que Application.ReadWrite.All les gère toutes.
La recommandation de Microsoft : accordez le minimum d’autorisations nécessaire. Utilisez Directory.AccessAsUser.All, Directory.ReadWrite.All et Directory.Read.All avec prudence, et privilégiez les autorisations moins étendues. Le consentement spécifique à une ressource permet à un utilisateur d’accorder l’accès à une seule instance de ressource, comme une équipe, plutôt qu’à l’ensemble du locataire. Il n’est pris en charge que par un sous-ensemble de fonctionnalités.
Problèmes courants
- L’inscription de l’agent de connecteur échoue. Learn indique que les autorisations déléguées ne sont pas prises en charge pour l’inscription d’un agent de connecteur. Demandez des autorisations d’application à moindre privilège et accordez le consentement administrateur à l’échelle du locataire.
- Les membres n’affichent que id et @odata.type. L’application ne dispose pas de l’autorisation de lire ce type de membre.
- Trop d’autorisations sur une même application. Les applications dont l’audience de connexion inclut les comptes Microsoft personnels peuvent demander au maximum 30 autorisations ; les audiences organisationnelles peuvent en demander jusqu’à 400.
Ce que la documentation ne précise pas
Les pages Data Connect consultées ne décrivent pas la durée de validité d’une approbation et ne donnent pas de tarifs. Elles ne listent pas non plus les exigences de licence au-delà de la configuration du tutoriel du guide de démarrage rapide.
Articles connexes
- Microsoft Graph Data Connect
- Autorisations Microsoft Graph
- Consentement administrateur
- Inscription d’application
Sources
- Vue d’ensemble de Microsoft Graph Data Connect
- Démarrage rapide de Data Connect
- Questions fréquentes sur Data Connect
- Jeux de données, régions et récepteurs
- Vue d’ensemble des autorisations Microsoft Graph
FAQ
Quelle est la différence entre Graph Data Connect et l’API Microsoft Graph ?
La FAQ de Data Connect sur Microsoft Learn indique que les deux donnent accès aux mêmes données sous-jacentes, mais de manière différente. Data Connect est conçu pour extraire de grands volumes de données en masse pour l’ensemble de l’organisation, tandis que les API Graph conviennent à de petits volumes de données provenant d’utilisateurs et de groupes sélectionnés.
Qui approuve une application Graph Data Connect ?
Dans le guide de démarrage rapide de Microsoft, un administrateur approuve la demande dans le Centre d’administration Microsoft 365, sous Paramètres > Paramètres de l’organisation > Sécurité et confidentialité > Applications Microsoft Graph Data Connect. Ce guide précise qu’il est impossible d’approuver soi-même ses propres applications.
Chaque exécution de pipeline nécessite-t-elle une nouvelle demande de consentement ?
Non. Selon la FAQ de Data Connect, tant que le périmètre reste identique pour les jeux de données, les colonnes, les utilisateurs et le récepteur, une exécution ne nécessite pas de nouvelle demande de consentement. L’exécution du même périmètre pour des dates différentes est couverte.
Une application doit-elle utiliser des autorisations déléguées ou des autorisations d’application ?
Microsoft Learn indique que les autorisations d’application sont très privilégiées et que, dans une optique de moindre privilège, le modèle délégué est recommandé dès lors qu’il répond aux besoins de l’application. Les autorisations d’application exigent toujours le consentement d’un administrateur.