Tipo de recurso hostPair
Namespace: microsoft.graph.security
Nota:
Microsoft Graph API for Microsoft Defender Threat Intelligence requiere una licencia activa del Portal de Inteligencia sobre amenazas de Defender y una licencia de complemento de API para el inquilino.
Representa un par de hosts primarios y secundarios en los que se puede acceder al host secundario a través del host primario. Por ejemplo, si contoso.com redirige a microsoft.com, contoso.com representa el host primario y microsoft.com el host secundario.
Relaciones de par de host compartidas en un punto anterior o actualmente comparten una conexión observada desde un rastreo de Microsoft. Un host primario conduce al host secundario quizás a través de un simple redireccionamiento de nivel superior (HTTP 302) o algo más complejo como un iframe o una referencia de origen de script. En otros casos, un rastreo web puede revelar comportamientos extraños, como relaciones de par de host entre direcciones IP y dominios o hosts que van en contra de los estándares DNS.
La propiedad linkKind anota la razón para identificar los hosts como un par primario-secundario. Un ejemplo de esto puede ser redirect
.
Para obtener más información sobre los pares de host, consulte la documentación de Inteligencia sobre amenazas de Microsoft Defender para conjuntos de datos.
Métodos
Método | Tipo devuelto | Descripción |
---|---|---|
Get | microsoft.graph.security.hostPair | Lea las propiedades y relaciones de un objeto hostPair . |
Lista de un host | Colección microsoft.graph.security.hostPair | Obtenga una lista de objetos hostPair asociados a un host especificado, donde el host es el elemento primario o secundario. |
Lista de un host como secundario | Colección microsoft.graph.security.hostPair | Obtenga una lista de objetos hostPair asociados a un host, donde ese host es el secundario y tiene un emparejamiento entrante con un elemento primario. |
Lista de un host como elemento primario | Colección microsoft.graph.security.hostPair | Obtenga una lista de objetos hostPair asociados a un host, donde ese host es el primario y tiene un emparejamiento saliente con un elemento secundario. |
Propiedades
Propiedad | Tipo | Descripción |
---|---|---|
firstSeenDateTime | DateTimeOffset | Fecha y hora en que Inteligencia sobre amenazas de Microsoft Defender observó por primera vez el hostPair. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z . |
id | Cadena | Identificador generado por el sistema para hostPair. |
lastSeenDateTime | DateTimeOffset | Fecha y hora en que Microsoft Defender Threat Intelligence observó por última vez el hostPair. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z . |
linkKind | Cadena | La razón por la que dos hosts se identifican como hostPair. |
Relaciones
Relación | Tipo | Descripción |
---|---|---|
childHost | microsoft.graph.security.host | Se ha alcanzado el host a través de parentHost. |
parentHost | microsoft.graph.security.host | Host usado para llegar al childHost. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.security.hostPair",
"firstSeenDateTime": "String (timestamp)",
"id": "String (identifier)",
"lastSeenDateTime": "String (timestamp)",
"linkKind": "String"
}