servicePrincipalRiskDetection 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 über erkannte gefährdete Dienstprinzipale in einem Microsoft Enttra-Mandanten dar. Microsoft Entra ID bewertet Risiken kontinuierlich basierend auf verschiedenen Signalen und maschinellem Lernen. Diese API bietet programmgesteuerten Zugriff auf alle Dienstprinzipalrisikoerkennungen in Ihrer Microsoft Entra-Umgebung.

Erbt von entity.

Weitere Informationen zu Risikoereignissen finden Sie unter Microsoft Entra ID Protection.

Hinweis: Sie müssen über eine Microsoft Entra Workload ID Premium-Lizenz verfügen, um die servicePrincipalRiskDetection-API verwenden zu können.

Methoden

Methode Rückgabetyp Beschreibung
List servicePrincipalRiskDetection-Sammlung Auflisten der Risikoerkennung von Dienstprinzipalen und deren Eigenschaften
Get servicePrincipalRiskDetection Rufen Sie eine bestimmte Risikoerkennung für Dienstprinzipale und deren Eigenschaften ab.

Eigenschaften

Eigenschaft Typ Beschreibung
Aktivität activityType Gibt den Aktivitätstyp an, mit dem das erkannte Risiko verknüpft ist.
activityDateTime DateTimeOffset Datum und Uhrzeit, zu dem die riskante Aktivität stattgefunden hat. 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 im Zusammenhang mit der Risikoermittlung. Dieser Zeichenfolgenwert wird als JSON-Objekt mit Escapezeichen für die Anführungszeichen dargestellt.
appId Zeichenfolge Der eindeutige Bezeichner für die zugehörige Anwendung.
correlationId String Korrelations-ID der Anmeldeaktivität, die der Risikoerkennung zugeordnet ist. Diese Eigenschaft ist null , wenn die Risikoerkennung keiner Anmeldeaktivität 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 oder Offline). Mögliche Werte sind: notDefined, realtime, nearRealtime, offline, unknownFutureValue.
id Zeichenfolge Eindeutiger Bezeichner der Risikoerkennung. Geerbt von entity.
ipAddress String Stellt die IP-Adresse des Clients bereit, von dem aus das Risiko aufgetreten ist.
keyIds String collection Der eindeutige Bezeichner (GUID) für die Schlüsselanmeldeinformationen, die der Risikoerkennung zugeordnet sind.
lastUpdatedDateTime DateTimeOffset Zeitpunkt (Datum und Uhrzeit), zu dem die Risikoerkennung zuletzt aktualisiert wurde.
location signInLocation Der Ort, von dem aus die Anmeldung initiiert wurde.
requestId Zeichenfolge Anforderungsbezeichner der Anmeldeaktivität im Zusammenhang mit der Risikoerkennung. Diese Eigenschaft ist null , wenn die Risikoerkennung keiner Anmeldeaktivität zugeordnet ist. Unterstützt $filter (eq).
riskDetail riskDetail Details zum erkannten Risiko.
Hinweis: Details zu dieser Eigenschaft sind nur für Workload Identities Premium-Kunden verfügbar. Ereignisse in Mandanten ohne diese Lizenz werden zurückgegeben hidden.
riskEventType Zeichenfolge Der Typ des erkannten Risikoereignisses. Die möglichen Werte sind: investigationsThreatIntelligence, generic, adminConfirmedServicePrincipalCompromised, suspiciousSignins, leakedCredentialsanomalousServicePrincipalActivity, maliciousApplication, suspiciousApplication. suspiciousAPITraffic
riskLevel riskLevel Stufe des erkannten Risikos.
Hinweis: Details zu dieser Eigenschaft sind nur für Workload Identities Premium-Kunden verfügbar. Ereignisse in Mandanten ohne diese Lizenz werden zurückgegeben hidden. Mögliche Werte sind: low, medium, high, hidden, none.
riskState riskState Der Status eines erkannten riskanten Dienstprinzipals oder einer Anmeldeaktivität. Mögliche Werte sind: none, dismissed, atRisk, confirmedCompromised.
servicePrincipalDisplayName Zeichenfolge Der Anzeigename für den Dienstprinzipal.
servicePrincipalId Zeichenfolge Der eindeutige Bezeichner für den Dienstprinzipal. Unterstützt $filter (eq).
source Zeichenfolge Quelle der Risikoermittlung. Beispiel: identityProtection.
tokenIssuerType tokenIssuerType Gibt den Typ des Tokenausstellers für das erkannte Anmelderisiko an. Die möglichen Werte sind: AzureAD.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.servicePrincipalRiskDetection",
  "id": "String (identifier)",
  "requestId": "String",
  "correlationId": "String",
  "riskEventType": "String",
  "riskState": "String",
  "riskLevel": "String",
  "riskDetail": "String",
  "source": "String",
  "detectionTimingType": "String",
  "activity": "String",
  "tokenIssuerType": "String",
  "ipAddress": "String",
  "location": {
    "@odata.type": "microsoft.graph.signInLocation"
  },
  "activityDateTime": "String (timestamp)",
  "detectedDateTime": "String (timestamp)",
  "lastUpdatedDateTime": "String (timestamp)",
  "servicePrincipalId": "String",
  "servicePrincipalDisplayName": "String",
  "appId": "String",
  "keyIds": [
    "String"
  ],
  "additionalInfo": "String"
}
  • Zuletzt aktualisiert um