Collecter les journaux d’audit à l’aide de l’API Office 365 de gestion

Les flux de synchronisation du journal d’audit se connectent à la Référence de l’API d’activité de gestion Office 365 pour collecter des données de télémétrie, telles que les utilisateurs uniques et les lancements pour les applications. Les flux utilisent une action HTTP pour accéder à l’API. Dans cet article, vous allez configurer l’enregistrement de l’application pour l’action HTTP et les variables d’environnement nécessaires à l’exécution des flux.

Prérequis

1. Complétez les articles Avant de configurer le Starter Kit CoE et Configurer les composants d’inventaire.
2. Configurez votre environnement CRM.
3. Connectez-vous avec l’identité correcte.

Avant de configurer les flux du journal d’audit

1. La recherche du journal d’audit Microsoft 365 doit être activée pour que le connecteur du journal d’audit fonctionne. Pour en savoir plus, consultez Activer ou désactiver la recherche dans le journal d’audit.
2. Votre client doit disposer d’un abonnement prenant en charge la journalisation d’audit unifiée. Pour en savoir plus, consultez Disponibilité du Centre de sécurité et de conformité pour les plans Business et Enterprise.
3. Microsoft Entra Des autorisations peuvent être nécessaires pour configurer l’enregistrement de l’application Microsoft Entra . En fonction de votre configuration Entra, il peut s’agir d’un rôle Développeur d'applications ou d’un rôle supérieur. Consultez Rôles avec le moins de privilèges par tâche dans Microsoft Entra ID pour obtenir plus d’informations.

Créer une inscription d’application Microsoft Entra pour l’accès à l’API de gestion Office 365

En suivant ces étapes, vous pouvez configurer une inscription d’application Microsoft Entra pour un appel HTTP dans un flux Power Automate pour vous connecter au journal d’audit. Pour en savoir plus, consultez Se familiariser avec les API de gestion Office 365.

1. Connectez-vous au portail Azure.

2. Accédez à Microsoft Entra ID>Inscriptions d’application.

   

3. Sélectionnez + Nouvelle inscription.

4. Saisissez un nom, tel que Gestion Microsoft 365, mais ne modifiez aucun autre paramètre. Ensuite, sélectionnez Inscrire.

5. Cliquez sur Autorisations API>+ Ajouter une autorisation.

   

6. Sélectionnez API de gestion Office 365 et configurez les autorisations comme suit :

   1. Sélectionnez Autorisations d’application, puis sélectionnez ActivityFeed.Read.

      

   2. Sélectionnez Ajouter des autorisations.

7. Sélectionnez Accorder un consentement à l’administrateur à (votre organisation). Pour en savoir plus sur la configuration du contenu administrateur, consultez Accorder le consentement de l’administrateur à l’échelle du client à une application.

   Les autorisations d’API reflètent maintenant ActivityFeed.Read délégué avec un statut de Accordé pour (votre organisation).

8. Sélectionnez Certificats et secrets.

9. Sélectionnez + Nouveau secret client.

10. Ajoutez une description et une date d’expiration conformément aux stratégies de votre organisation. Sélectionnez ensuite Ajouter.

11. Copiez et collez l’ID d’application (client) dans un document texte, par exemple le Bloc-notes.

12. Sélectionnez Présentation et copiez et collez les valeurs ID d’application (client) et ID de répertoire (client) dans le même document texte. Assurez-vous de noter quel GUID correspond à quelle valeur. Vous avez besoin de ces valeurs lorsque vous configurez le connecteur personnalisé.

Mettre à jour les variables d’environnement

Les variables d’environnement sont utilisées pour contrôler l’API à utiliser, l’API de gestion Office 365 héritée ou l’API Graph, et pour stocker l’ID et le secret client pour l’enregistrement de l’application. Les variables sont également utilisées pour définir les points de terminaison du service d’audience et d’autorité, en fonction de votre cloud pour l’action HTTP. Votre type de cloud peut être commercial, US Government Community Cloud (GCC), US GCC High ou US Department of Defense (DoD). Mettez à jour les variables d’environnement avant d’activer les flux.

Vous pouvez stocker la clé secrète client en texte brut dans la variable d’environnement Journaux d’audit - Clé secrète client, ce qui n’est pas recommandé. Au lieu de cela, nous vous recommandons de créer et de stocker la clé secrète client dans Azure Key Vault et de la référencer dans la variable d’environnement Journaux d’audit – Clé secrète Azure client .

Démarrer un abonnement au contenu du journal d’audit

1. Accédez à make.powerapps.com.

2. Sélectionnez Solutions.

3. Ouvrez la solution Center of Excellence - Composants principaux.

4. Activez le flux Administrateur | Journaux d’audit | Abonnement à l’API de gestion Office 365 et exécutez-le, puis saisissez démarrer comme opération à exécuter.

   

5. Ouvrez le flux et vérifiez que l’action de démarrage de l’abonnement a réussi.

Activer les flux

1. Accédez à make.powerapps.com.
2. Sélectionnez Solutions.
3. Ouvrez la solution Center of Excellence - Composants principaux.
4. Activez le flux Administrateur | Journaux d’audit | Mettre à jour les données (V2). Ce flux met à jour la table Power Apps avec les informations de lancement les plus récentes et ajoute des métadonnées aux enregistrements des journaux d’audit.
5. Activez le flux Administrateur | Journaux d’audit | Synchroniser les journaux d’audit (V2). Ce flux s’exécute selon un calendrier horaire et recueille les événements du journal d’audit dans la table Journal d’audit.

Fournir des commentaires

Si vous trouvez un bogue dans le Starter Kit CoE, entrez un bogue pour la solution à l’adresse aka.ms/coe-starter-kit-issues.