Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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"
}