type de ressource networkAccessTraffic

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"
  }
}