alertEvidence Ressourcentyp

Namespace: microsoft.graph.security

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt Beweise im Zusammenhang mit einer Warnung dar.

Der alertEvidence-Basistyp und seine abgeleiteten Beweistypen bieten eine Möglichkeit, umfangreiche Daten zu jedem Artefakt zu organisieren und zu verfolgen, das an einer Warnung beteiligt ist. Beispielsweise kann eine Warnung über die IP-Adresse eines Angreifers, der sich mit einem kompromittierten Benutzerkonto bei einem Clouddienst anmeldet, die folgenden Beweise verfolgen:

Diese Ressource ist der Basistyp für die folgenden Beweistypen:

Eigenschaften

Eigenschaft Typ Beschreibung
createdDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der der Nachweis erstellt und der Warnung hinzugefügt wurde. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
detailedRoles String collection Ausführliche Beschreibung der Entitätsrolle(n) in einer Warnung. Werte sind Freiform.
remediationStatus microsoft.graph.security.evidenceRemediationStatus Status der durchgeführten Korrekturmaßnahme. Die möglichen Werte sind: none, remediated, prevented, blocked, notFounddeclinedunknownFutureValuerunningactiveunremediatedpendingApprovalpartiallyRemediated. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte aus dieser entwicklungsfähigen Aufzählung zu erhalten: active, pendingApproval, declined, runningunremediatedpartiallyRemediated.
remediationStatusDetails Zeichenfolge Details zum Status der Korrektur.
roles microsoft.graph.security.evidenceRole-Sammlung Die Rolle(n), die eine Beweisentität in einer Warnung darstellt, z. B. eine IP-Adresse, die einem Angreifer zugeordnet ist, hat die Beweisrolle Angreifer.
tags Zeichenfolgenauflistung Array benutzerdefinierter Tags, die einer Evidence instance zugeordnet sind, z. B. um eine Gruppe von Geräten, hochwertigen Assets usw. zu kennzeichnen
Erste Eindrücke microsoft.graph.security.evidenceVerdict Die Entscheidung, die durch eine automatisierte Untersuchung getroffen wurde. Mögliche Werte sind: unknown, suspicious, malicious, noThreatsFound, unknownFutureValue.

detectionSource-Werte

Wert Beschreibung
erkannt wurde Ein Produkt der Bedrohung, die ausgeführt wurde, wurde erkannt.
blockiert Die Bedrohung wurde zur Laufzeit behoben.
verhindert werden Das Auftreten der Bedrohung wurde verhindert (Ausführen, Herunterladen usw.).
unknownFutureValue Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

evidenceRemediationStatus-Werte

Member Beschreibung
keine Es wurden keine Bedrohungen gefunden.
Bereinigt Korrekturaktion wurde erfolgreich abgeschlossen.
verhindert werden Die Ausführung der Bedrohung wurde verhindert.
blockiert Die Bedrohung wurde während der Ausführung blockiert.
notFound Die Beweise wurden nicht gefunden.
unknownFutureValue Evolvable Enumeration Sentinel-Wert. Nicht verwenden.
Aktiv Die Untersuchung wird ausgeführt/steht aus, und die Sanierung ist noch nicht abgeschlossen.
pendingApproval Die Genehmigung der Korrekturmaßnahme steht aus.
abgelehnt Die Korrekturmaßnahme wurde abgelehnt.
nicht bereinigt wird Die Untersuchung hat die Korrektur rückgängig gemacht, und die Entität wird wiederhergestellt.
Wird ausgeführt Die Korrekturaktion wird ausgeführt.
partiallyRemediated Die Bedrohung wurde teilweise behoben.

evidenceRole-Werte

Member Beschreibung
unknown Die Beweisrolle ist unbekannt.
Kontextbezogen Eine Entität, die wahrscheinlich harmlos aufgetreten ist, aber als Nebeneffekt der Aktion eines Angreifers gemeldet wurde, z. B. wurde der gutartige services.exe Prozess verwendet, um einen schädlichen Dienst zu starten.
Gescannt Eine Entität, die als Ziel von Ermittlungsscan- oder Aufklärungsaktionen identifiziert wurde, z. B. wurde ein Portscanner verwendet, um ein Netzwerk zu scannen.
source Die Entität, von der die Aktivität stammt, z. B. Gerät, Benutzer, IP-Adresse usw.
Das Ziel Die Entität, an die die Aktivität gesendet wurde, z. B. Gerät, Benutzer, IP-Adresse usw.
erstellt Das Objekt wurde als Ergebnis der Aktionen eines Angreifers erstellt, z. B. wurde ein Benutzerkonto erstellt.
Hinzugefügt Das Objekt wurde als Ergebnis der Aktionen eines Angreifers hinzugefügt. Beispielsweise wurde ein Benutzerkonto einer Berechtigungsgruppe hinzugefügt.
kompromittiert Das Objekt wurde kompromittiert und befindet sich unter der Kontrolle eines Angreifers. Beispielsweise wurde ein Benutzerkonto kompromittiert und für die Anmeldung bei einem Clouddienst verwendet.
edited Die Entität wurde von einem Angreifer bearbeitet oder verändert. Beispielsweise wurde der Registrierungsschlüssel für einen Dienst so bearbeitet, dass er auf den Speicherort einer neuen schädlichen Nutzlast verweist.
angegriffen Das Objekt wurde angegriffen. Ein Gerät war beispielsweise Ziel eines DDoS-Angriffs.
Angreifer Das Objekt repräsentiert den Angreifer. Beispielsweise hat die IP-Adresse des Angreifers beobachtet, wie er sich mit einem kompromittierten Benutzerkonto bei einem Clouddienst angemeldet hat.
commandAndControl Das Objekt wird für Befehl und Steuerung verwendet. Beispielsweise eine C2-Domäne (Command and Control), die von Schadsoftware verwendet wird.
geladen Das Objekt wurde von einem Prozess geladen, der von einem Angreifer kontrolliert wird. Beispielsweise wurde eine DLL in einen vom Angreifer gesteuerten Prozess geladen.
verdächtig Die Entität steht im Verdacht, böswillig zu sein oder von einem Angreifer kontrolliert zu werden, wurde aber nicht belastet.
policyViolator Das Unternehmen verstößt gegen eine vom Kunden definierte Richtlinie.
unknownFutureValue Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

evidenceVerdict-Werte

Member Beschreibung
unknown Für die Beweise wurde kein Urteil gefällt.
verdächtig Empfohlene Korrekturmaßnahmen warten auf Genehmigung.
böswillig Die Beweise wurden als böswillig eingestuft.
noThreatsFound Es wurde keine Bedrohung festgestellt - die Beweise sind gutartig.
unknownFutureValue Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.security.alertEvidence",
  "createdDateTime": "String (timestamp)",
  "verdict": "String",
  "remediationStatus": "String",
  "remediationStatusDetails": "String",
  "roles": [
    "String"
  ],
  "detailedRoles": [
    "String"
  ],
  "tags": [
    "String"
  ]
}
  • Last updated on