Partager via


Type de ressource hostPair

Espace de noms : microsoft.graph.security

Remarque

L’API Microsoft Graph pour Microsoft Defender Threat Intelligence nécessite une licence active du portail Defender Threat Intelligence et une licence de module complémentaire d’API pour le locataire.

Représente une paire d’hôtes parent-enfant dans lesquelles l’hôte enfant peut être atteint via l’hôte parent. Par exemple, si contoso.com redirige vers microsoft.com, contoso.com représente l’hôte parent et microsoft.com l’hôte enfant.

Les relations de paire d’hôtes partagées à un point antérieur ou partagent actuellement une connexion observée à partir d’une analyse Microsoft. Un hôte parent mène à l’hôte enfant par le biais d’une simple redirection de niveau supérieur (HTTP 302), ou quelque chose de plus complexe comme une référence de source d’iframe ou de script. Dans d’autres cas, une analyse web peut révéler des comportements étranges tels que des relations de paire d’hôtes entre des adresses IP et des domaines/hôtes qui vont à l’encontre des normes DNS.

La propriété linkKind indique la raison pour laquelle les hôtes sont identifiés comme une paire parent-enfant. Il peut redirects’agir, par exemple, de .

Pour plus d’informations sur les paires d’hôtes, consultez la documentation Microsoft Defender Threat Intelligence pour les jeux de données.

Méthodes

Méthode Type de retour Description
Obtenir microsoft.graph.security.hostPair Lisez les propriétés et les relations d’un objet hostPair .
Liste d’un hôte collection microsoft.graph.security.hostPair Obtenez la liste des objets hostPair associés à un hôte spécifié, où l’hôte est le parent ou l’enfant .
Liste d’un hôte en tant qu’enfant collection microsoft.graph.security.hostPair Obtenez la liste des objets hostPair associés à un hôte, où cet hôte est l’enfant et a un appairage entrant avec un parent.
Liste d’un hôte en tant que parent collection microsoft.graph.security.hostPair Obtenez la liste des objets hostPair associés à un hôte, où cet hôte est le parent et a un appairage sortant avec un enfant.

Propriétés

Propriété Type Description
firstSeenDateTime DateTimeOffset Date et heure auxquelles Microsoft Defender Threat Intelligence a observé le hostPair pour la première fois. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
id Chaîne ID généré par le système pour hostPair.
lastSeenDateTime DateTimeOffset Date et heure auxquelles Microsoft Defender Threat Intelligence a observé le hostPair pour la dernière fois. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
linkKind Chaîne Raison pour laquelle deux hôtes sont identifiés comme hostPair.

Relations

Relation Type Description
childHost microsoft.graph.security.host Hôte atteint via parentHost.
parentHost microsoft.graph.security.host Hôte utilisé pour atteindre l’enfantHost.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@odata.type": "#microsoft.graph.security.hostPair",
  "firstSeenDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "lastSeenDateTime": "String (timestamp)",
  "linkKind": "String"
}