Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph.security
Nota:
Las API de inteligencia sobre amenazas de Microsoft están disponibles para todos los clientes con una licencia de Microsoft Defender XDR o Microsoft Sentinel. No se requiere ninguna licencia independiente para acceder a estas API.
Representa un par de hosts principales-secundarios en los que se puede llegar al host secundario a través del host principal. Por ejemplo, si contoso.com redirige a microsoft.com, contoso.com representa el host principal y microsoft.com el host secundario.
Relaciones de par de hosts compartieron en un momento anterior o comparten actualmente una conexión observada desde un rastreo de Microsoft. Un host principal conduce al host secundario tal vez a través de una simple redirección de nivel superior (HTTP 302), o algo más complejo como un iframe o una referencia de fuente de script. En otros casos, un rastreo web puede revelar comportamientos extraños, como relaciones de par de hosts entre direcciones IP y dominios/hosts que van en contra de los estándares DNS.
La propiedad linkKind señala la razón para identificar los hosts como un par principal-secundario. Un ejemplo de esto puede ser redirect.
Para obtener más información acerca de los pares de hosts, consulte la documentación de la Inteligencia contra amenazas contra amenazas de Microsoft Defender para los conjuntos de datos.
Métodos
| Método | Tipo devuelto | Descripción |
|---|---|---|
| Get | microsoft.graph.security.hostPair | Lee las propiedades y relaciones de un objeto hostPair . |
| Lista para un host | Colección microsoft.graph.security.hostPair | Obtenga una lista de objetos hostPair asociados con un host especificado, donde el host es el elemento primario o secundario. |
| Enumerar un host como secundario | Colección microsoft.graph.security.hostPair | Obtenga una lista de objetos hostPair asociados con un host, donde ese host es el elemento secundario y tiene un emparejamiento entrante con un elemento primario. |
| Lista de un host como principal | Colección microsoft.graph.security.hostPair | Obtenga una lista de objetos hostPair asociados con un host, donde ese host es el principal y tiene un emparejamiento saliente con un hijo. |
Propiedades
| Propiedad | Tipo | Description |
|---|---|---|
| firstSeenDateTime | DateTimeOffset | La fecha y hora en que la Inteligencia contra amenazas contra amenazas de Microsoft Defender observó por primera vez el hostPair. El tipo de marca de tiempo representa la información de fecha y hora con 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 | Id. generado por el sistema para hostPair. |
| lastSeenDateTime | DateTimeOffset | La fecha y hora en que la Inteligencia contra amenazas contra amenazas de Microsoft Defender observó por última vez el hostPair. El tipo de marca de tiempo representa la información de fecha y hora con 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 | Description |
|---|---|---|
| childHost | microsoft.graph.security.host | Host alcanzado a través de parentHost. |
| parentHost | microsoft.graph.security.host | Host usado para llegar a 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"
}