Arbeiten mit ermittelten Apps über Graph-API (Vorschau)

Microsoft Defender for Cloud Apps unterstützt eine Microsoft-Graph-API, die Sie für die Arbeit mit ermittelten Cloud-Apps verwenden können, um die Funktionen der Seite "Ermittelte Apps" im Microsoft Defender-Portal anzupassen und zu automatisieren.

Dieser Artikel enthält Beispielverfahren für die Verwendung der uploadedStreams-API für allgemeine Zwecke.

Voraussetzungen

Bevor Sie mit der Verwendung des Graph-API beginnen, müssen Sie eine App erstellen und ein Zugriffstoken abrufen, um die API aufzurufen. Verwenden Sie dann das Zugriffstoken, um auf die Defender for Cloud Apps-API zuzugreifen.

  • Stellen Sie sicher, dass Sie der App Berechtigungen für den Zugriff auf Defender for Cloud Apps gewähren, indem Sie ihr CloudApp-Discovery.Read.All Berechtigungen und die Administratorzustimmung erteilen.

  • Notieren Sie sich Ihr App-Geheimnis, und kopieren Sie dessen Wert, um es später in Ihren Skripts zu verwenden.

  • Sie benötigen Cloud-App-Datenstreaming in Microsoft Defender for Cloud Apps.

Weitere Informationen finden Sie unter:

Abrufen von Daten zu ermittelten Apps

Führen Sie den folgenden GET-Befehl aus, um eine allgemeine Zusammenfassung aller auf der Seite "Ermittelte Apps" verfügbaren Daten zu erhalten:

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

So führen Sie einen Drilldown zu Daten für einen bestimmten Stream aus:

  1. Kopieren Sie den relevanten <streamID> Wert aus der GET .../uploadedStreams Antwort.

  2. Führen Sie den folgenden GET-Befehl mit dem Wert <streamID> aus:

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

Filtern nach einem bestimmten Zeitraum und einer Risikobewertung

Filtern Sie Ihre API-Befehle mithilfe von $select und $filter , um Daten für einen bestimmten Zeitraum und eine bestimmte Risikobewertung abzurufen. Um beispielsweise die Namen aller Apps anzuzeigen, die in den letzten 30 Tagen mit einer Risikobewertung niedriger oder gleich 4 ermittelt wurden, führen Sie Folgendes aus:

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

Rufen Sie den userIdentifier aller Benutzer, Geräte oder IP-Adressen ab, die eine bestimmte App verwenden

Identifizieren Sie die Benutzer, Geräte oder IP-Adressen, die derzeit eine bestimmte App verwenden, führen Sie einen der folgenden Befehle aus:

  • So geben Sie Benutzer zurück:

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

  • So geben Sie IP-Adressen zurück:

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

  • So geben Sie Geräte zurück (listet die Gerätenamen auf, die während des Zeitraums auf die angegebene App zugegriffen haben):

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

Verwenden von Filtern zum Anzeigen von Apps nach Kategorie

Verwenden Sie Filter, um Apps einer bestimmten Kategorie anzuzeigen, z. B. Apps, die als Marketing kategorisiert sind und auch nicht HIPPA-konform sind. Führen Sie beispielsweise den folgenden Befehl aus:

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

Verwandte Inhalte

Weitere Informationen finden Sie unter Arbeiten mit ermittelten Apps und in der Referenz zu Microsoft Graph-API.

  • Last updated on