Práce se zjištěnými aplikacemi prostřednictvím Graph API (Preview)

Microsoft Defender for Cloud Apps podporuje Graph API Microsoftu, pomocí kterého můžete pracovat se zjištěnými cloudovými aplikacemi a přizpůsobit a automatizovat funkce stránky Zjištěné aplikace na portálu Microsoft Defender.

Tento článek obsahuje ukázkové postupy pro použití rozhraní API uploadStreams pro běžné účely.

Požadavky

Než začnete používat Graph API, nezapomeňte vytvořit aplikaci a získat přístupový token pro volání rozhraní API. Pak použijte přístupový token pro přístup k rozhraní DEFENDER FOR CLOUD APPS API.

  • Nezapomeňte aplikaci udělit oprávnění pro přístup k Defender for Cloud Apps tím, že jí CloudApp-Discovery.Read.All udělíte oprávnění a souhlas správce.

  • Poznamenejte si tajný kód aplikace a zkopírujte jeho hodnotu, abyste ho mohli později použít ve skriptech.

  • Potřebujete data cloudových aplikací streamovat do Microsoft Defender for Cloud Apps.

Další informace najdete tady:

Získání dat o zjištěných aplikacích

Pro zobrazení všech dostupných nahraných streamů a získání přehledu dat dostupných na stránce Objevené aplikace spusťte následující příkaz GET. Odpověď obsahuje ID streamů, které potřebujete pro další dotazy:

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

Pro podrobnější přístup k datům pro konkrétní stream vrácený předchozím požadavkem GET:

  1. Zkopírujte příslušnou <streamID> hodnotu (vlastnost id nahraného proudu) z GET .../uploadedStreams odpovědi.

  2. Spusť následující příkaz GET a nahrazte <streamId> ho hodnotou id z předchozí odpovědi:

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

Filtrování pro konkrétní časové období a rizikové skóre

Vyfiltrujte příkazy rozhraní API pomocí $select a $filter , abyste získali data pro konkrétní časové období a rizikové skóre. Pokud například chcete zobrazit názvy všech aplikací zjištěných za posledních 30 dnů s rizikovým skóre nižším nebo rovným 4, spusťte příkaz:

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

Získání identifikátoru userIdentifier všech uživatelů, zařízení nebo IP adres pomocí konkrétní aplikace

Po získání aplikace <id> z aggregatedAppsDetails odpovědi spusťte jeden z následujících příkazů k identifikaci uživatelů, zařízení nebo IP adres, které aplikaci aktuálně používají:

  • Vrácení uživatelů:

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

  • Vrácení IP adres:

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

  • Pokud chcete vrátit zařízení (zobrazí se seznam názvů zařízení, které během tohoto období přistupovaly k zadané aplikaci):

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

Použití filtrů k zobrazení aplikací podle kategorie

Filtry slouží k zobrazení aplikací konkrétní kategorie, jako jsou aplikace, které jsou kategorizované jako Marketing a také nejsou kompatibilní s HIPPA. Například následující požadavek vrací aplikace marketingové kategorie z určeného proudu, které jsou označeny jako nevyhovující 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'

Související obsah

Další informace najdete v tématech Práce se zjištěnými aplikacemi a referenční informace k microsoft Graph API.

  • Poslední aktualizace v