Utiliser des applications découvertes via API Graph (préversion)

Microsoft Defender for Cloud Apps prend en charge une API Graph Microsoft que vous pouvez utiliser pour utiliser des applications cloud découvertes, pour personnaliser et automatiser la fonctionnalité de la page Applications découvertes dans le portail Microsoft Defender.

Cet article fournit des exemples de procédures pour l’utilisation de l’API uploadedStreams à des fins courantes.

Prérequis

Avant de commencer à utiliser le API Graph, veillez à créer une application et à obtenir un jeton d’accès pour appeler l’API. Ensuite, utilisez le jeton d’accès pour accéder à l’API Defender for Cloud Apps.

  • Veillez à accorder à l’application des autorisations pour accéder à Defender for Cloud Apps, en lui CloudApp-Discovery.Read.All accordant des autorisations et le consentement de l’administrateur.

  • Notez le secret de votre application et copiez sa valeur pour l’utiliser ultérieurement dans vos scripts.

  • Vous avez besoin d’un streaming de données d’application cloud dans Microsoft Defender for Cloud Apps.

Pour plus d’informations, reportez-vous aux rubriques suivantes :

Obtenir des données sur les applications découvertes

Pour lister tous les flux téléchargés disponibles et obtenir un résumé général des données disponibles sur votre page Applications découvertes , exécutez la commande GET suivante. La réponse inclut les identifiants de flux dont vous avez besoin pour les requêtes suivantes :

GET https://graph.microsoft.com/beta/security/dataDiscovery/cloudAppDiscovery/uploadedStreams

Pour approfondir les données d’un flux spécifique retourné par la précédente requête GET :

  1. Copiez la valeur pertinente <streamID> (la id propriété du flux téléchargé) de la GET .../uploadedStreams réponse.

  2. Exécutez la commande GET suivante, en remplaçant <streamId> par la id valeur de la réponse précédente :

    GET https://graph.microsoft.com/beta/security/dataDiscovery/cloudAppDiscovery/uploadedStreams/<streamId>/aggregatedAppsDetails(period=duration'P90D')

Filtrer pour une période spécifique et un score de risque

Filtrez vos commandes d’API à l’aide $select de et $filter pour obtenir des données pour une période spécifique et un score de risque. Par exemple, pour afficher les noms de toutes les applications découvertes au cours des 30 derniers jours avec un score de risque inférieur ou égal à 4, exécutez :

GET https://graph.microsoft.com/beta/security/dataDiscovery/cloudAppDiscovery/uploadedStreams/<streamId>/aggregatedAppsDetails (period=duration'P30D')?$filter=riskRating  le 4 &$select=displayName

Obtenir l’identificateur d’utilisateur de tous les utilisateurs, appareils ou adresses IP à l’aide d’une application spécifique

Après avoir récupéré une application <id> depuis la aggregatedAppsDetails réponse, exécutez l’une des commandes suivantes pour identifier les utilisateurs, appareils ou adresses IP qui utilisent actuellement cette application :

  • Pour renvoyer les utilisateurs :

    GET  https://graph.microsoft.com/beta/security/dataDiscovery/cloudAppDiscovery/uploadedStreams/<streamId>/aggregatedAppsDetails (period=duration'P30D')/ <id>/users

  • Pour retourner des adresses IP :

    GET  https://graph.microsoft.com/beta/security/dataDiscovery/cloudAppDiscovery/uploadedStreams/<streamId>/aggregatedAppsDetails (period=duration'P30D')/ <id>/ipAddress

  • Pour retourner des appareils (répertorie les noms d’appareils qui ont accédé à l’application spécifiée pendant la période) :

    GET  https://graph.microsoft.com/beta/security/dataDiscovery/cloudAppDiscovery/uploadedStreams/<streamId>/aggregatedAppsDetails (period=duration'P30D')/ <id>/name

Utiliser des filtres pour afficher les applications par catégorie

Utilisez des filtres pour afficher les applications d’une catégorie spécifique, telles que les applications qui sont classées comme marketing et qui ne sont pas non plus conformes à HIPPA. Par exemple, la requête suivante renvoie des applications de catégorie marketing provenant du flux spécifié qui sont marquées comme non conformes à la HIPAA :

GET  https://graph.microsoft.com/beta/security/dataDiscovery/cloudAppDiscovery/uploadedStreams/<MDEstreamId>/aggregatedAppsDetails (period=duration 'P30D')?$filter= (appInfo/Hippa eq 'false') and category eq 'Marketing'

Contenu connexe

Pour plus d’informations, consultez Travailler avec les applications découvertes et la documentation de référence de l’API Microsoft Graph.

  • Last updated on