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.networkaccess
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Representa una entrada de registro de tráfico de acceso a la red. Contiene información completa sobre eventos de tráfico de red, lo que ofrece información detallada sobre la naturaleza y las características del tráfico a través de los servicios de acceso seguro global (GSA).
Métodos
| Método | Tipo devuelto | Descripción |
|---|---|---|
| List | colección microsoft.graph.networkaccess.networkAccessTraffic | Obtenga una lista de los objetos microsoft.graph.networkaccess.networkAccessTraffic y sus propiedades. |
| Get | microsoft.graph.networkaccess.networkAccessTraffic | Lee las propiedades y relaciones de un objeto networkAccessTraffic. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| acción | microsoft.graph.networkaccess.filteringPolicyAction | Indica la acción tomada en función de las directivas de filtrado. Los valores posibles son: block, allow, unknownFutureValue, bypass, alert. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolutiva: bypass , alert. |
| agentVersion | Cadena | Representa la versión del software de agente de cliente de Global Secure Access (GSA). Admite $filter (eq) y $orderby. |
| applicationSnapshot | microsoft.graph.networkaccess.applicationSnapshot | Id. de aplicación de destino al que se accede en Azure AD durante la transacción. Admite $filter (eq) y $orderby. |
| cloudApplicationMetadata | microsoft.graph.networkaccess.cloudApplicationMetadata | Contiene metadatos sobre la aplicación en la nube involucrada en la transacción de red, como el nombre de la aplicación, la categoría y el nivel de riesgo. Admite $filter (eq) y $orderby. |
| connectionId | Cadena | Representa un identificador único asignado a una conexión. Admite $filter (eq) y $orderby. |
| createdDateTime | DateTimeOffset | Representa la fecha y hora en que se creó una entrada de registro de tráfico de acceso a la red. Admite $filter (eq) y $orderby. |
| description | Cadena | Mensaje de error informativo. Por ejemplo: "La inteligencia sobre amenazas detectó una transacción y desencadenó una alerta" o "La directiva de acceso seguro global (GSA) bloqueó el destino y desencadenó una alerta". Admite $filter (eq) y $orderby. |
| destinationFQDN | Cadena | Representa el nombre de dominio completo (FQDN) del host o servidor de destino en una comunicación de red. Admite $filter (eq) y $orderby. |
| destinationIp | Cadena | Representa la dirección IP del host o servidor de destino en una comunicación de red. Admite $filter (eq) y $orderby. |
| puerto de destino | Int32 | Representa el número de puerto de red en el host o servidor de destino en una comunicación de red. Admite $filter (eq) y $orderby. |
| destinationUrl | Cadena | Representa la dirección URL del destino en una comunicación de red. Admite $filter (eq) y $orderby. |
| destinationWebCategory | microsoft.graph.networkaccess.webCategory | La categoría web del FQDN de destino (por ejemplo, Apuestas). Admite $filter (eq) y $orderby. |
| deviceCategory | microsoft.graph.networkaccess.deviceCategory | Representa la clasificación de categoría de un dispositivo dentro de una infraestructura de red. Los valores posibles son: client, branch, unknownFutureValue. Admite $filter (eq) y $orderby. |
| deviceId | Cadena | Representa un identificador único asignado a un dispositivo dentro de una infraestructura de red. Admite $filter (eq) y $orderby. |
| deviceOperatingSystem | Cadena | Representa el sistema operativo instalado en un dispositivo dentro de una infraestructura de red. Admite $filter (eq) y $orderby. |
| deviceOperatingSystemVersion | Cadena | Representa la versión o el número de versión del sistema operativo instalado en un dispositivo dentro de una infraestructura de red. Admite $filter (eq) y $orderby. |
| filteringProfileId | Cadena | El identificador del perfil de filtrado asociado con la acción realizada en el tráfico. Admite $filter (eq) y $orderby. |
| filteringProfileName | Cadena | Nombre del perfil de filtrado asociado a la acción realizada en el tráfico. Admite $filter (eq) y $orderby. |
| encabezados | microsoft.graph.networkaccess.headers | Representa los encabezados incluidos en una solicitud o respuesta de red. Admite $filter (eq) y $orderby. |
| httpMethod | microsoft.graph.networkaccess.httpMethod | El método HTTP inspeccionado en el tráfico HTTP interceptado. Admite $filter (eq) y $orderby. |
| initiatingProcessName | Cadena | El proceso que inicia la transacción de tráfico. Admite $filter (eq) y $orderby. |
| protocolo de red | microsoft.graph.networkaccess.networkingProtocol | Representa el protocolo de red usado para la comunicación. Los valores posibles son: ip, icmp, igmp, ggpipv4tcppupudpidpipv6ipv6RoutingHeaderipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipSecAuthenticationHeadericmpV6ipv6NoNextHeaderipv6DestinationOptionsndrawipxspxspxIIunknownFutureValue Admite $filter (eq) y $orderby. |
| operationStatus | microsoft.graph.networkaccess.networkTrafficOperationStatus | Indicación de si el tráfico se procesó correctamente. Los valores posibles son: success, failure, unknownFutureValue. Admite $filter (eq) y $orderby. |
| policyId | Cadena | Representa un identificador único asignado a una directiva. Admite $filter (eq) y $orderby. |
| policyName | Cadena | Nombre de la directiva de filtrado asociada a la acción realizada en el tráfico. Admite $filter (eq) y $orderby. |
| policyRuleId | Cadena | Representa un identificador único asignado a una regla de directiva. Admite $filter (eq) y $orderby. |
| policyRuleName | Cadena | Nombre de la regla asociada a la acción realizada en el tráfico. Admite $filter (eq) y $orderby. |
| popProcessingRegion | Cadena | La región de procesamiento de punto de presencia del tráfico. Admite $filter (eq) y $orderby. |
| privateAccessDetails | microsoft.graph.networkaccess.privateAccessDetails | Detalles sobre el tráfico de acceso privado. Admite $filter (eq) y $orderby. |
| receivedBytes | Int64 | Representa el número total de bytes recibidos en una comunicación de red o transferencia de datos. Admite $filter (eq) y $orderby. |
| remoteNetworkId | Cadena | Id. desde el que se envía o recibe el tráfico, lo que proporciona visibilidad sobre el origen del tráfico. Admite $filter (eq) y $orderby. |
| resourceTenantId | Cadena | Identificador del espacio empresarial propietario del recurso. Admite $filter (eq) y $orderby. |
| responseCode | Int32 | El código de respuesta HTTP inspeccionado en el tráfico HTTP interceptado. Admite $filter (eq) y $orderby. |
| sentBytes | Int64 | Representa el número total de bytes enviados en una comunicación de red o una transferencia de datos. Admite $filter (eq) y $orderby. |
| sessionId | Cadena | Representa un identificador único asignado a una sesión o conexión dentro de una infraestructura de red. Admite $filter (eq) y $orderby. |
| dirección IP de origen | Cadena | Representa la dirección IP de origen en una comunicación de red. Admite $filter (eq) y $orderby. |
| puerto de origen | Int32 | Representa el número de puerto de red en el dispositivo o host de origen en una comunicación de red. Admite $filter (eq) y $orderby. |
| tenantId | Cadena | Representa un identificador único asignado a un inquilino dentro de una infraestructura de red. Admite $filter (eq) y $orderby. |
| threatType | Cadena | El tipo de amenaza detectada en el tráfico. Admite $filter (eq) y $orderby. |
| trafficType | microsoft.graph.networkaccess.trafficType | Representa el tipo o la categoría de tráfico de red. Los valores posibles son: internet, private, microsoft365, all, unknownFutureValue. Admite $filter (eq) y $orderby. |
| transactionId | String | Representa un identificador único asignado a una transacción u operación específica. Clave. Admite $filter (eq) y $orderby. |
| transportProtocolo | microsoft.graph.networkaccess.networkingProtocol | Representa el protocolo de transporte utilizado para la comunicación. Los valores posibles son: ip, icmp, igmp, ggpipv4tcppupudpidpipv6ipv6RoutingHeaderipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipSecAuthenticationHeadericmpV6ipv6NoNextHeaderipv6DestinationOptionsndrawipxspxspxIIunknownFutureValue Admite $filter (eq) y $orderby. |
| userId | Cadena | Representa un identificador único asignado a un usuario. Admite $filter (eq) y $orderby. |
| userPrincipalName | Cadena | Representa el nombre principal de usuario (UPN) asociado a un usuario. Admite $filter (eq) y $orderby. |
| vendorNames | Collection(String) | El nombre de los proveedores que detectaron la amenaza. Admite $filter (eq) y $orderby. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| dispositivo | dispositivo | Representa el dispositivo asociado con el tráfico de red y proporciona detalles sobre el hardware o la máquina virtual implicada en la transacción. |
| usuario | user | Representa el usuario asociado con el tráfico de red, proporcionando detalles sobre la persona o cuenta que inicia la transacción. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.networkaccess.networkAccessTraffic",
"transactionId": "String (identifier)",
"createdDateTime": "String (timestamp)",
"tenantId": "String",
"connectionId": "String",
"sessionId": "String",
"trafficType": "String",
"deviceCategory": "String",
"destinationIp": "String",
"destinationPort": "Integer",
"destinationFQDN": "String",
"destinationUrl": "String",
"sourceIp": "String",
"sourcePort": "Integer",
"deviceOperatingSystem": "String",
"deviceOperatingSystemVersion": "String",
"agentVersion": "String",
"deviceId": "String",
"userId": "String",
"userPrincipalName": "String",
"transportProtocol": "String",
"networkProtocol": "String",
"action": "String",
"policyRuleId": "String",
"policyId": "String",
"sentBytes": "Integer",
"receivedBytes": "Integer",
"headers": {
"@odata.type": "microsoft.graph.networkaccess.headers"
},
"destinationWebCategory": {
"@odata.type": "microsoft.graph.networkaccess.webCategory"
},
"filteringProfileId": "String",
"filteringProfileName": "String",
"policyName": "String",
"policyRuleName": "String",
"initiatingProcessName": "String",
"resourceTenantId": "String",
"threatType": "String",
"applicationSnapshot": {
"@odata.type": "microsoft.graph.networkaccess.applicationSnapshot"
},
"privateAccessDetails": {
"@odata.type": "microsoft.graph.networkaccess.privateAccessDetails"
},
"description": "String",
"vendorNames": ["String"],
"remoteNetworkId": "String",
"httpMethod": "String",
"responseCode": "Integer",
"operationStatus": "String",
"popProcessingRegion": "String",
"cloudApplicationMetadata": {
"@odata.type": "microsoft.graph.networkaccess.cloudApplicationMetadata"
}
}