rozhraní API Microsoft Defender XDR incidentů a typ prostředku incidentů

  • Platí pro: Microsoft Defender XDR

Poznámka

Vyzkoušejte naše nová rozhraní API s využitím rozhraní MS Graph Security API. Další informace najdete v tématu : Použití rozhraní Microsoft Graph Security API – Microsoft Graph | Microsoft Learn.

Důležité

Některé informace se týkají předprodeje produktu, který může být před komerčním vydáním podstatně změněn. Společnost Microsoft neposkytuje v souvislosti se zde uvedenými informacemi žádné výslovné ani předpokládané záruky.

Incident je kolekce souvisejících výstrah, které pomáhají popsat útok. Události z různých entit ve vaší organizaci se automaticky agregují podle Microsoft Defender. Pomocí rozhraní API pro incidenty můžete programově přistupovat k incidentům a souvisejícím výstrahám vaší organizace.

Kvóty a přidělení prostředků

Můžete požádat až o 50 hovorů za minutu nebo 1 500 hovorů za hodinu. Každá metoda má také své vlastní kvóty. Další informace o kvótách specifických pro metodu najdete v příslušném článku pro metodu, kterou chcete použít.

429 Kód odpovědi HTTP označuje, že jste dosáhli kvóty, a to buď podle počtu odeslaných požadavků, nebo podle přidělené doby běhu. Text odpovědi zahrnuje dobu do resetování kvóty, kterou jste dosáhli.

Oprávnění

Rozhraní API incidentů vyžaduje pro každou ze svých metod různé druhy oprávnění. Další informace o požadovaných oprávněních najdete v článku příslušné metody.

Metody

Metoda Návratový typ Popis
Uvádění incidentů Seznam incidentů Získejte seznam incidentů.
Aktualizace incidentu Incident Aktualizujte konkrétní incident.
Získání incidentu Incident Získejte jeden incident.

Text požadavku, odpověď a příklady

Další podrobnosti o tom, jak vytvořit požadavek nebo parsovat odpověď, a praktické příklady najdete v příslušných článcích o metodách.

Společné vlastnosti

Vlastnost Typ Popis
incidentId Dlouhé Jedinečné ID incidentu
redirectIncidentId long s možnou hodnotou null ID incidentu, do které se aktuální incident sloučil.
název incidentu řetězec Název incidentu.
createdTime Datetimeoffset Datum a čas vytvoření incidentu (v UTC).
lastUpdateTime Datetimeoffset Datum a čas (v UTC) byl incident naposledy aktualizován. Použijte tuto vlastnost k identifikaci incidentů, které se změnily po jejich vytvoření.
Přiřazeno řetězec Vlastník incidentu.
Závažnosti Výčtu Závažnost incidentu. Možné hodnoty jsou: UnSpecified, Informational, Low, Mediuma High. Závažnost se může měnit, jak jsou upozornění přidána nebo odebrána z incidentu. Zdroj incidentů neuvádí historii změn závažnosti.
stav Výčtu Určuje aktuální stav incidentu. Možné hodnoty jsou: Active, InProgress, Resolveda Redirected.
Klasifikace Výčtu Specifikace incidentu. Možné hodnoty jsou: TruePositive, Informational, expected activitya FalsePositive.
Stanovení Výčtu Určuje určení incidentu.

Možné hodnoty určení pro každou klasifikaci jsou:

  • PravdivěMultistage attack pozitivní: Malicious user activity (MultiStagedAttack), Compromised account (MaliciousUserActivity), Malware (CompromisedUser) – zvažte odpovídající změnu názvu výčtu ve veřejném rozhraní API (Malware), Phishing (Phishing), Unwanted software (UnwantedSoftware) a Other (Other).
  • Informační, očekávaná aktivita:Security test (SecurityTesting), Line-of-business application (LineOfBusinessApplication), Confirmed activity (ConfirmedUserActivity) – zvažte odpovídající změnu názvu výčtu ve veřejném rozhraní API a Other (Jiné).
  • Falešně pozitivní:Not malicious (Čisté) – zvažte odpovídající Not enough data to validate změnu názvu výčtu ve veřejném rozhraní API (InsufficientData) a Other (Other).
    		•
    Tagy seznam řetězců Seznam značek incidentů (pouze customTags)
    Komentáře Seznam komentářů k incidentu Objekt Komentáře incidentu obsahuje řetězec komentáře, řetězec createdBy a createTime date time.
    Výstrahy seznam výstrah Seznam souvisejících výstrah Projděte si příklady v dokumentaci k rozhraní API seznamu incidentů .

    Poznámka

    Kolem 29. srpna 2022 budou dříve podporované hodnoty určení výstrah (Apt a SecurityPersonnel) zastaralé a nebudou už dostupné prostřednictvím rozhraní API.

    Tip

    Chcete se dozvědět více? Spojte se s komunitou zabezpečení společnosti Microsoft v naší technické komunitě: Technická komunita Microsoft Defender XDR.

    • Last updated on