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.networkaccess
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Représente une entrée du journal du trafic d’accès réseau. Il contient des informations complètes sur les événements de trafic réseau, offrant des informations détaillées sur la nature et les caractéristiques du trafic via les services d’accès sécurisé global (GSA).
Méthodes
| Méthode | Type de retour | Description |
|---|---|---|
| List | microsoft.graph.networkaccess.networkAccessTraffic collection | Obtenez une liste des objets microsoft.graph.networkaccess.networkAccessTraffic et leurs propriétés. |
| Obtenir | microsoft.graph.networkaccess.networkAccessTraffic | Lire les propriétés et les relations d’un objet networkAccessTraffic. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| action | microsoft.graph.networkaccess.filteringPolicyAction | Indique l’action entreprise en fonction des stratégies de filtrage. Les valeurs possibles sont : block, allow, unknownFutureValue, bypass, alert. Utilisez l’en-tête de Prefer: include-unknown-enum-members requête pour obtenir les valeurs suivantes à partir de cette énumération évolutive : bypass , alert. |
| version de l’agent | String | Représente la version du logiciel d’agent client GSA (Global Secure Access). Prend en charge $filter (eq) et $orderby. |
| applicationSnapshot | microsoft.graph.networkaccess.applicationSnapshot | ID de l’application de destination consultée dans Azure AD lors de la transaction. Prend en charge $filter (eq) et $orderby. |
| cloudApplicationMetadata | microsoft.graph.networkaccess.cloudApplicationMetadata | Contient des métadonnées sur l’application cloud impliquée dans la transaction réseau, telles que le nom, la catégorie et le niveau de risque de l’application. Prend en charge $filter (eq) et $orderby. |
| connectionId | String | Représente un identificateur unique attribué à une connexion. Prend en charge $filter (eq) et $orderby. |
| createdDateTime | DateTimeOffset | Représente la date et l’heure de création d’une entrée de journal du trafic d’accès réseau. Prend en charge $filter (eq) et $orderby. |
| description | String | Message d’erreur d’information. Par exemple : « Les renseignements sur les menaces ont détecté une transaction et déclenché une alerte. » ou « La stratégie d’accès global sécurisé (GSA) a bloqué la destination et déclenché une alerte ». Prend en charge $filter (eq) et $orderby. |
| destinationFQDN | String | Représente le nom de domaine complet (FQDN) de l’hôte ou du serveur de destination dans une communication réseau. Prend en charge $filter (eq) et $orderby. |
| destinationIp | String | Représente l’adresse IP de l’hôte ou du serveur de destination dans une communication réseau. Prend en charge $filter (eq) et $orderby. |
| destinationPort | Int32 | Représente le numéro de port réseau sur l’hôte ou le serveur de destination dans une communication réseau. Prend en charge $filter (eq) et $orderby. |
| destinationUrl | String | Représente l’URL de la destination dans une communication réseau. Prend en charge $filter (eq) et $orderby. |
| destinationWebCategory | microsoft.graph.networkaccess.webCategory | Catégorie Web du FQDN de destination (par exemple, jeux d’argent). Prend en charge $filter (eq) et $orderby. |
| deviceCategory | microsoft.graph.networkaccess.deviceCategory | Représente la classification de catégorie d’un appareil au sein d’une infrastructure réseau. Les valeurs possibles sont client, branch, unknownFutureValue. Prend en charge $filter (eq) et $orderby. |
| deviceId | String | Représente un identificateur unique attribué à un appareil au sein d’une infrastructure réseau. Prend en charge $filter (eq) et $orderby. |
| deviceOperatingSystem | String | Représente le système d’exploitation installé sur un appareil au sein d’une infrastructure réseau. Prend en charge $filter (eq) et $orderby. |
| deviceOperatingSystemVersion | String | Représente le numéro de version ou de version du système d’exploitation installé sur un appareil au sein d’une infrastructure réseau. Prend en charge $filter (eq) et $orderby. |
| filteringProfileId | String | ID du profil de filtrage associé à l’action effectuée sur le trafic. Prend en charge $filter (eq) et $orderby. |
| filteringProfileName | String | Nom du profil de filtrage associé à l’action effectuée sur le trafic. Prend en charge $filter (eq) et $orderby. |
| en-têtes | Microsoft.Graph.NetworkAccess.Headers | Représente les en-têtes inclus dans une demande ou une réponse réseau. Prend en charge $filter (eq) et $orderby. |
| httpMethod | Microsoft.Graph.NetworkAccess.httpMethod | Méthode HTTP inspectée dans le trafic HTTP intercepté. Prend en charge $filter (eq) et $orderby. |
| initiatingProcessName | String | Processus initiant la transaction de trafic. Prend en charge $filter (eq) et $orderby. |
| networkProtocol | microsoft.graph.networkaccess.networkingProtocol | Représente le protocole réseau utilisé pour la communication. Les valeurs possibles sont : ip, , igmp, ggpipxipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipv6RoutingHeaderipv6ipSecAuthenticationHeaderndipv6DestinationOptionsrawipv6NoNextHeaderspxspxIIipv4pupunknownFutureValuetcpudpidpicmpV6icmp Prend en charge $filter (eq) et $orderby. |
| operationStatus | microsoft.graph.networkaccess.networkTrafficOperationStatus | Indication si le trafic a été traité avec succès. Les valeurs possibles sont success, failure, unknownFutureValue. Prend en charge $filter (eq) et $orderby. |
| ID de stratégie | String | Représente un identificateur unique affecté à une stratégie. Prend en charge $filter (eq) et $orderby. |
| PolicyName | String | Nom de la stratégie de filtrage associée à l’action effectuée sur le trafic. Prend en charge $filter (eq) et $orderby. |
| policyRuleId | String | Représente un identificateur unique affecté à une règle de stratégie. Prend en charge $filter (eq) et $orderby. |
| policyRuleName | String | Nom de la règle associée à l’action effectuée sur le trafic. Prend en charge $filter (eq) et $orderby. |
| popProcessingRegion | String | La région de traitement du point de présence du trafic. Prend en charge $filter (eq) et $orderby. |
| privateAccessDetails | microsoft.graph.networkaccess.privateAccessDetails | Détails sur le trafic d’accès privé. Prend en charge $filter (eq) et $orderby. |
| receivedBytes | Int64 | Représente le nombre total d’octets reçus dans une communication réseau ou un transfert de données. Prend en charge $filter (eq) et $orderby. |
| remoteNetworkId | String | ID à partir duquel le trafic a été envoyé ou reçu, offrant une visibilité sur l’origine du trafic. Prend en charge $filter (eq) et $orderby. |
| resourceTenantId | String | ID de locataire propriétaire de la ressource. Prend en charge $filter (eq) et $orderby. |
| coderéponse | Int32 | Code de réponse HTTP inspecté dans le trafic HTTP intercepté. Prend en charge $filter (eq) et $orderby. |
| sentBytes | Int64 | Représente le nombre total d’octets envoyés dans une communication réseau ou un transfert de données. Prend en charge $filter (eq) et $orderby. |
| sessionId | String | Représente un identificateur unique affecté à une session ou une connexion au sein d’une infrastructure réseau. Prend en charge $filter (eq) et $orderby. |
| source Ip | String | Représente l’adresse IP source dans une communication réseau. Prend en charge $filter (eq) et $orderby. |
| port source | Int32 | Représente le numéro de port réseau sur l’hôte ou le périphérique source dans une communication réseau. Prend en charge $filter (eq) et $orderby. |
| tenantId | String | Représente un identificateur unique attribué à un client au sein d’une infrastructure réseau. Prend en charge $filter (eq) et $orderby. |
| threatType | String | Type de menace détecté dans le trafic. Prend en charge $filter (eq) et $orderby. |
| trafficType | microsoft.graph.networkaccess.trafficType | Représente le type ou la catégorie de trafic réseau. Les valeurs possibles sont : internet, private, microsoft365, all, unknownFutureValue. Prend en charge $filter (eq) et $orderby. |
| transactionId | String | Représente un identificateur unique affecté à une transaction ou une opération spécifique. Clé. Prend en charge $filter (eq) et $orderby. |
| protocole de transport | microsoft.graph.networkaccess.networkingProtocol | Représente le protocole de transport utilisé pour la communication. Les valeurs possibles sont : ip, , igmp, ggpipxipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipv6RoutingHeaderipv6ipSecAuthenticationHeaderndipv6DestinationOptionsrawipv6NoNextHeaderspxspxIIipv4pupunknownFutureValuetcpudpidpicmpV6icmp Prend en charge $filter (eq) et $orderby. |
| userId | String | Représente un identificateur unique attribué à un utilisateur. Prend en charge $filter (eq) et $orderby. |
| userPrincipalName | String | Représente le nom d’utilisateur principal (UPN) associé à un utilisateur. Prend en charge $filter (eq) et $orderby. |
| vendorNames | Collection(String) | Nom des fournisseurs qui ont détecté la menace. Prend en charge $filter (eq) et $orderby. |
Relations
| Relation | Type | Description |
|---|---|---|
| device | appareil | Représente l’appareil associé au trafic réseau, fournissant des détails sur le matériel ou la machine virtuelle impliqués dans la transaction. |
| user | utilisateur | Représente l’utilisateur associé au trafic réseau, fournissant des détails sur la personne ou le compte à l’origine de la transaction. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@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"
}
}