type de ressource hostPair

Espace de noms : microsoft.graph.security

Remarque

Les API Microsoft Threat Intelligence sont disponibles pour tous les clients disposant d’une licence Microsoft Defender XDR ou Microsoft Sentinel. Aucune licence distincte n’est requise pour accéder à ces API.

Représente une paire d’hôtes parent-enfant dans laquelle 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.

Relations de paires d’hôtes partagées à un stade antérieur ou partageant 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 de quelque chose de plus complexe comme une référence de source iframe ou de script. Dans d’autres cas, une exploration du web peut révéler des comportements étranges, tels que des relations de paires 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 d’identifier les hôtes en tant que paire parent-enfant. Un exemple de ceci peut être redirect.

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

Méthodes

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

Propriétés

Propriété Type Description
firstSeenDateTime DateTimeOffset Date et heure auxquelles Microsoft Defender Threat Intelligence a observé pour la première fois hostPair. 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 String ID généré par le système pour hostPair.
lastSeenDateTime DateTimeOffset Date et heure auxquelles Microsoft Defender Threat Intelligence a observé pour la dernière fois hostPair. 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 String Raison pour laquelle deux hôtes sont identifiés comme hostPair.

Relations

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

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"
}