Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph.security
Hinweis
Die Microsoft Threat Intelligence-APIs sind für alle Kunden mit einer Microsoft Defender XDR- oder Microsoft Sentinel-Lizenz verfügbar. Für den Zugriff auf diese APIs ist keine separate Lizenz erforderlich.
Stellt ein Paar von übergeordneten und untergeordneten Hosts dar, bei denen der untergeordnete Host über den übergeordneten Host erreicht werden kann. Wenn contoso.com beispielsweise an microsoft.com umleitet, stellt contoso.com den übergeordneten Host dar und microsoft.com den untergeordneten Host.
Hostpaarbeziehungen, die zu einem früheren Zeitpunkt freigegeben wurden oder derzeit eine Verbindung teilen, die bei einem Microsoft-Crawl beobachtet wurde. Ein übergeordneter Host führt zum untergeordneten Host, möglicherweise über eine einfache Umleitung der obersten Ebene (HTTP 302) oder etwas Komplexeres wie einen iframe- oder Skriptquellenverweis. In anderen Fällen kann eine Webdurchforstung seltsame Verhaltensweisen aufdecken, z. B. Hostpaarbeziehungen zwischen IP-Adressen und Domänen/Hosts, die gegen DNS-Standards verstoßen.
Die linkKind-Eigenschaft gibt den Grund an, warum die Hosts als über-/untergeordnetes Paar identifiziert werden. Ein Beispiel hierfür kann sein redirect.
Weitere Informationen zu Hostpaaren finden Sie in der Dokumentation zu Microsoft Defender Threat Intelligence für Datensets.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Get | microsoft.graph.security.hostPair | Lesen der Eigenschaften und Beziehungen eines hostPair-Objekts . |
| Liste für einen Host | microsoft.graph.security.hostPair-Sammlung | Ruft eine Liste von hostPair-Objekten ab, die einem angegebenen Host zugeordnet sind, wobei der Host entweder das übergeordnete oder das untergeordnete Host ist. |
| Liste für einen Host als untergeordnetes Element | microsoft.graph.security.hostPair-Sammlung | Rufen Sie eine Liste von hostPair-Objekten ab, die einem Host zugeordnet sind, wobei dieser Host das untergeordnete Element ist und eine eingehende Kopplung mit einem übergeordneten Element aufweist. |
| Liste für einen Host als übergeordnetes Element | microsoft.graph.security.hostPair-Sammlung | Ruft eine Liste von hostPair-Objekten ab, die einem Host zugeordnet sind, wobei dieser Host das übergeordnete Element ist und eine ausgehende Kopplung mit einem untergeordneten Host aufweist. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| firstSeenDateTime | DateTimeOffset | Das Datum und die Uhrzeit, zu dem Microsoft Defender Threat Intelligence das HostPaar zum ersten Mal beobachtet hat. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. |
| id | Zeichenfolge | Eine vom System generierte ID für das HostPair. |
| lastSeenDateTime | DateTimeOffset | Das Datum und die Uhrzeit, zu der Microsoft Defender Threat Intelligence das HostPaar zuletzt beobachtet hat. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. |
| linkArt | Zeichenfolge | Der Grund, warum zwei Hosts als hostPair identifiziert werden. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| childHost | microsoft.graph.security.host | Host über parentHost erreicht. |
| parentHost | microsoft.graph.security.host | Host verwendet, um den childHost zu erreichen. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"@odata.type": "#microsoft.graph.security.hostPair",
"firstSeenDateTime": "String (timestamp)",
"id": "String (identifier)",
"lastSeenDateTime": "String (timestamp)",
"linkKind": "String"
}