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 redirect
s’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"
}