riskDetection-Ressourcentyp

Namespace: microsoft.graph

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 Informationen zu einem erkannten Risiko in einem Microsoft Entra Mandanten dar.

Microsoft Entra ID Protection bewertet kontinuierlich Benutzerrisiken und App- oder Benutzeranmeldungsrisiken basierend auf verschiedenen Signalen und maschinellem Lernen. Diese API bietet programmgesteuerten Zugriff auf alle Risikoerkennungen in Ihrer Microsoft Entra-Umgebung.

Weitere Informationen zur Risikoerkennung finden Sie unter Microsoft Entra ID Protection und Was sind Risikoerkennungen?

Hinweis

Die Verfügbarkeit von Risikoerkennungsdaten wird durch die Microsoft Entra Datenaufbewahrungsrichtlinien geregelt.

Methoden

Methode	Rückgabetyp	Beschreibung
Auflisten von Risikoerkennungen	riskDetection-Sammlung	Auflisten von Risikoerkennungen und deren Eigenschaften
Abrufen der Risikoerkennung	riskDetection	Rufen Sie eine bestimmte Risikoerkennung und deren Eigenschaften ab.

Eigenschaften

Eigenschaft	Typ	Beschreibung
Aktivität	activityType	Gibt den Aktivitätstyp an, mit dem das erkannte Risiko verknüpft ist. Die möglichen Werte sind signin, user, . unknownFutureValue
activityDateTime	DateTimeOffset	Datum und Uhrzeit des Auftretens der riskanten Aktivität. Der DateTimeOffset-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
additionalInfo	Zeichenfolge	Zusätzliche Informationen zur Risikoerkennung im JSON-Format.
correlationId	Zeichenfolge	Korrelations-ID der Anmeldung, die der Risikoerkennung zugeordnet ist. Diese Eigenschaft ist NULL, wenn die Risikoerkennung keiner Anmeldung zugeordnet ist.
detectedDateTime	DateTimeOffset	Datum und Uhrzeit, zu dem das Risiko erkannt wurde. Der DateTimeOffset-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
detectionTimingType	riskDetectionTimingType	Zeitpunkt des erkannten Risikos (Echtzeit/Offline). Die möglichen Werte sind notDefined, realtime, nearRealtime, offline, . unknownFutureValue
id	string	Eindeutige ID der Risikoerkennung.
ipAddress	Zeichenfolge	Gibt die IP-Adresse des Clients an, von dem aus das Risiko aufgetreten ist.
lastUpdatedDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Aktualisierung der Risikoerkennung.
location	signInLocation	Speicherort der Anmeldung.
Requestid	Zeichenfolge	Anforderungs-ID der Anmeldung, die der Risikoerkennung zugeordnet ist. Diese Eigenschaft ist NULL, wenn die Risikoerkennung keiner Anmeldung zugeordnet ist.
riskEventType	Zeichenfolge	Der Typ des erkannten Risikoereignisses. Die möglichen Werte sind adminConfirmedUserCompromised, anomalousUserActivity, , anonymizedIPAddress,attemptedPRTAccessgenericattackerinTheMiddle , , investigationsThreatIntelligenceinvestigationsThreatIntelligenceSigninLinked,leakedCredentialsmaliciousIPAddress , , maliciousIPAddressValidCredentialsBlockedIP, malwareInfectedIPAddress, mcasImpossibleTravel,mcasFinSuspiciousFileAccessnationStateIPmcasSuspiciousInboxManipulationRulessuspiciousAPITraffic ,suspiciousSendingPatternsunfamiliarFeaturessuspiciousIPAddress , . userReportedSuspiciousActivityunlikelyTravel Weitere Informationen zu den einzelnen Werten finden Sie unter Risikotypen und Erkennung.
riskDetail	riskDetail	Details zum erkannten Risiko. Die möglichen Werte sind: none, adminGeneratedTemporaryPassword, userPerformedSecuredPasswordChange, userPerformedSecuredPasswordReset, adminConfirmedSigninSafe, , aiConfirmedSigninSafe, adminDismissedAllRiskForUseruserPassedMFADrivenByRiskBasedPolicy, adminConfirmedSigninCompromised, hiddenadminConfirmedUserCompromisedadminConfirmedServicePrincipalCompromisedunknownFutureValue, , . m365DAdminDismissedDetectionadminDismissedAllRiskForServicePrincipal Beachten Sie, dass Sie den Prefer: include - unknown -enum-members Anforderungsheader verwenden müssen, um die folgenden Werte in dieser verteilbaren Enumeration abzurufen: adminConfirmedServicePrincipalCompromised , adminDismissedAllRiskForServicePrincipal , m365DAdminDismissedDetection. Hinweis: Details für diese Eigenschaft sind nur für Microsoft Entra ID P2-Kunden verfügbar. P1-Kunden werden zurückgegeben hidden.
riskLevel	riskLevel	Ebene des erkannten Risikos. Die möglichen Werte sind low, medium, high, hidden, none, . unknownFutureValue Hinweis: Details für diese Eigenschaft sind nur für Microsoft Entra ID P2-Kunden verfügbar. P1-Kunden werden zurückgegeben hidden.
riskState	riskState	Der Status eines erkannten risikobehafteten Benutzers oder einer Anmeldung. Die möglichen Werte sind none, confirmedSafe, remediated, dismissed, atRisk, confirmedCompromisedund unknownFutureValue.
source	Zeichenfolge	Quelle der Risikoerkennung. Beispiel: activeDirectory.
tokenIssuerType	tokenIssuerType	Gibt den Typ des Tokenausstellers für das erkannte Anmelderisiko an. Die gültigen Werte sind AzureAD, ADFederationServices und unknownFutureValue.
userId	Zeichenfolge	Eindeutige ID des Benutzers. Der DateTimeOffset-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
userDisplayName	string	Der Name des Benutzers.
userPrincipalName	string	Der User Principal Name (UPN) des Benutzers.
riskType (veraltet)	riskEventType	Liste der Risikoereignistypen. Hinweis: Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen riskEventType .

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
 "id": "string",
    "requestId": "string",
    "correlationId": "string",
    "riskType": {"@odata.type": "microsoft.graph.riskEventType"},
    "riskState": {"@odata.type": "microsoft.graph.riskState"},
    "riskLevel": {"@odata.type": "microsoft.graph.riskLevel"},
    "riskDetail": {"@odata.type": "microsoft.graph.riskDetail"},
    "source": "string",
    "detectionTimingType": {"@odata.type": "microsoft.graph.riskDetectionTimingType"},
    "activity": {"@odata.type": "microsoft.graph.riskUserActivity"},
    "tokenIssuerType": {"@odata.type": "microsoft.graph.tokenIssuerType"},
    "ipAddress": "string",
    "location": {"@odata.type": "microsoft.graph.signInLocation"},
    "activityDateTime": "string (timestamp)",
    "detectedDateTime": "string (timestamp)",
    "lastUpdatedDateTime": "string (timestamp)",
    "userId": "string",
    "userDisplayName": "string",
    "userPrincipalName": "string",
    "additionalInfo": "string"
}