Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph.networkaccess
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Stellt einen Protokolleintrag für den Netzwerkzugriff dar. Es enthält umfassende Informationen zu Netzwerkdatenverkehrsereignissen und bietet detaillierte Einblicke in die Art und die Merkmale des Datenverkehrs über die Global Secure Access (GSA)-Dienste.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List | microsoft.graph.networkaccess.networkAccessTraffic collection | Rufen Sie eine Liste der microsoft.graph.networkaccess.networkAccessTraffic-Objekte und ihrer Eigenschaften ab. |
| Get | microsoft.graph.networkaccess.networkAccessTraffic | Lesen der Eigenschaften und Beziehungen eines networkAccessTraffic-Objekts. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| Aktion | microsoft.graph.networkaccess.filteringPolicyAction | Gibt die Aktion an, die basierend auf Filterrichtlinien durchgeführt wurde. Mögliche Werte sind: block, allow, unknownFutureValue, bypass, alert. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte aus dieser entwicklungsfähigen Aufzählung zu erhalten: bypass , alert. |
| agentVersion | Zeichenfolge | Steht für die Version der GSA-Client-Agent-Software (Global Secure Access). Unterstützt $filter (eq) und $orderby. |
| applicationSnapshot | microsoft.graph.networkaccess.applicationSnapshot | Zielanwendungs-ID, auf die während der Transaktion in Azure AD zugegriffen wird. Unterstützt $filter (eq) und $orderby. |
| cloudApplicationMetadata | microsoft.graph.networkaccess.cloudApplicationMetadata | Enthält Metadaten über die Cloud-Anwendung, die an der Netzwerktransaktion beteiligt ist, z. B. Anwendungsname, Kategorie und Risikostufe. Unterstützt $filter (eq) und $orderby. |
| Verbindungs-ID | Zeichenfolge | Stellt einen eindeutigen Bezeichner dar, der einer Verbindung zugewiesen ist. Unterstützt $filter (eq) und $orderby. |
| createdDateTime | DateTimeOffset | Stellt das Datum und die Uhrzeit dar, zu dem ein Netzwerkzugriffsprotokolleintrag erstellt wurde. Unterstützt $filter (eq) und $orderby. |
| description | Zeichenfolge | Informationsfehlermeldung. Beispiel: "Threat Intelligence hat eine Transaktion erkannt und eine Warnung ausgelöst." oder "Die Global Secure Access (GSA)-Richtlinie blockierte das Ziel und löste eine Warnung aus." Unterstützt $filter (eq) und $orderby. |
| destinationFQDN | Zeichenfolge | Stellt den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Zielhosts oder -servers in einer Netzwerkkommunikation dar. Unterstützt $filter (eq) und $orderby. |
| destinationIp | Zeichenfolge | Stellt die IP-Adresse des Zielhosts oder -servers in einer Netzwerkkommunikation dar. Unterstützt $filter (eq) und $orderby. |
| destinationPort | Int32 | Stellt die Netzwerkportnummer auf dem Zielhost oder -server in einer Netzwerkkommunikation dar. Unterstützt $filter (eq) und $orderby. |
| destinationUrl | Zeichenfolge | Stellt die URL des Ziels in einer Netzwerkkommunikation dar. Unterstützt $filter (eq) und $orderby. |
| destinationWebCategory | microsoft.graph.networkaccess.webCategory | Die Webkategorie (z. B. Glücksspiel) des Ziel-FQDN. Unterstützt $filter (eq) und $orderby. |
| deviceCategory | microsoft.graph.networkaccess.deviceCategory | Stellt die Kategorieklassifizierung eines Geräts innerhalb einer Netzwerkinfrastruktur dar. Die möglichen Werte sind: client, branch, unknownFutureValue. Unterstützt $filter (eq) und $orderby. |
| deviceId | Zeichenfolge | Stellt eine eindeutige Kennung dar, die einem Gerät innerhalb einer Netzwerkinfrastruktur zugewiesen ist. Unterstützt $filter (eq) und $orderby. |
| deviceOperatingSystem | Zeichenfolge | Stellt das Betriebssystem dar, das auf einem Gerät innerhalb einer Netzwerkinfrastruktur installiert ist. Unterstützt $filter (eq) und $orderby. |
| deviceOperatingSystemVersion | Zeichenfolge | Stellt die Versions- oder Versionsnummer des Betriebssystems dar, das auf einem Gerät innerhalb einer Netzwerkinfrastruktur installiert ist. Unterstützt $filter (eq) und $orderby. |
| filteringProfileId | Zeichenfolge | Die ID des Filterprofils, das der Aktion zugeordnet ist, die für den Datenverkehr ausgeführt wird. Unterstützt $filter (eq) und $orderby. |
| filteringProfileName | Zeichenfolge | Der Name des Filterprofils, das der Aktion zugeordnet ist, die für den Datenverkehr ausgeführt wird. Unterstützt $filter (eq) und $orderby. |
| Überschriften | Microsoft.Graph.NetworkAccess.Headers | Stellt die Header dar, die in einer Netzwerkanforderung oder -antwort enthalten sind. Unterstützt $filter (eq) und $orderby. |
| httpMethod | microsoft.graph.networkaccess.httpMethod | Die HTTP-Methode, die im abgefangenen HTTP-Datenverkehr überprüft wurde. Unterstützt $filter (eq) und $orderby. |
| initiatingProcessName | Zeichenfolge | Der Prozess, der die Datenverkehrstransaktion initiiert. Unterstützt $filter (eq) und $orderby. |
| networkProtocol | microsoft.graph.networkaccess.networkingProtocol | Stellt das Netzwerkprotokoll dar, das für die Kommunikation verwendet wird. Die möglichen Werte sind: ip, icmp, igmp, ggp, ipv4, tcppupudpidpipv6ipv6RoutingHeaderipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipSecAuthenticationHeadericmpV6ipv6NoNextHeaderipv6DestinationOptionsndrawipxspxspxIIunknownFutureValue Unterstützt $filter (eq) und $orderby. |
| operationStatus | microsoft.graph.networkaccess.networkTrafficOperationStatus | Gibt an, ob der Datenverkehr erfolgreich verarbeitet wurde. Die möglichen Werte sind: success, failure, unknownFutureValue. Unterstützt $filter (eq) und $orderby. |
| policyId | Zeichenfolge | Stellt einen eindeutigen Bezeichner dar, der einer Richtlinie zugewiesen ist. Unterstützt $filter (eq) und $orderby. |
| policyName | Zeichenfolge | Der Name der Filterrichtlinie, die der Aktion zugeordnet ist, die für den Datenverkehr ausgeführt wird. Unterstützt $filter (eq) und $orderby. |
| policyRuleId | Zeichenfolge | Stellt einen eindeutigen Bezeichner dar, der einer Richtlinienregel zugewiesen ist. Unterstützt $filter (eq) und $orderby. |
| policyRuleName | Zeichenfolge | Der Name der Regel, die der Aktion zugeordnet ist, die für den Datenverkehr ausgeführt wird. Unterstützt $filter (eq) und $orderby. |
| popProcessingRegion | Zeichenfolge | Der Point-of-Presence-Verarbeitungsbereich des Datenverkehrs. Unterstützt $filter (eq) und $orderby. |
| privateAccessDetails | microsoft.graph.networkaccess.privateAccessDetails | Details zu Datenverkehr mit privatem Zugriff. Unterstützt $filter (eq) und $orderby. |
| receivedBytes | Int64 | Stellt die Gesamtzahl der Bytes dar, die in einer Netzwerkkommunikation oder Datenübertragung empfangen werden. Unterstützt $filter (eq) und $orderby. |
| remoteNetworkId | Zeichenfolge | Die ID, von der Datenverkehr gesendet oder empfangen wurde. Sie bietet Einblick in die Herkunft des Datenverkehrs. Unterstützt $filter (eq) und $orderby. |
| resourceTenantId | Zeichenfolge | Mandanten-ID, die Besitzer der Ressource ist. Unterstützt $filter (eq) und $orderby. |
| responseCode | Int32 | Der HTTP-Antwortcode, der im abgefangenen HTTP-Datenverkehr überprüft wurde. Unterstützt $filter (eq) und $orderby. |
| sentBytes | Int64 | Stellt die Gesamtanzahl von Bytes dar, die in einer Netzwerkkommunikation oder Datenübertragung gesendet werden. Unterstützt $filter (eq) und $orderby. |
| sessionId | Zeichenfolge | Stellt einen eindeutigen Bezeichner dar, der einer Sitzung oder Verbindung innerhalb einer Netzwerkinfrastruktur zugewiesen ist. Unterstützt $filter (eq) und $orderby. |
| sourceIp | Zeichenfolge | Stellt die Quell-IP-Adresse in einer Netzwerkkommunikation dar. Unterstützt $filter (eq) und $orderby. |
| sourcePort | Int32 | Stellt die Netzwerkportnummer auf dem Quellhost oder -gerät in einer Netzwerkkommunikation dar. Unterstützt $filter (eq) und $orderby. |
| tenantId | Zeichenfolge | Stellt einen eindeutigen Bezeichner dar, der einem Mandanten innerhalb einer Netzwerkinfrastruktur zugewiesen ist. Unterstützt $filter (eq) und $orderby. |
| Bedrohungstyp | Zeichenfolge | Der Typ der im Datenverkehr erkannten Bedrohung. Unterstützt $filter (eq) und $orderby. |
| trafficType | microsoft.graph.networkaccess.trafficType | Stellt den Typ oder die Kategorie des Netzwerkdatenverkehrs dar. Mögliche Werte sind: internet, private, microsoft365, all, unknownFutureValue. Unterstützt $filter (eq) und $orderby. |
| transactionId | Zeichenfolge | Stellt einen eindeutigen Bezeichner dar, der einer bestimmten Transaktion oder Operation zugeordnet ist. Key. Unterstützt $filter (eq) und $orderby. |
| transportProtocol | microsoft.graph.networkaccess.networkingProtocol | Stellt das Transportprotokoll dar, das für die Kommunikation verwendet wird. Die möglichen Werte sind: ip, icmp, igmp, ggp, ipv4, tcppupudpidpipv6ipv6RoutingHeaderipv6FragmentHeaderipSecEncapsulatingSecurityPayloadipSecAuthenticationHeadericmpV6ipv6NoNextHeaderipv6DestinationOptionsndrawipxspxspxIIunknownFutureValue Unterstützt $filter (eq) und $orderby. |
| userId | String | Stellt einen eindeutigen Bezeichner dar, der einem Benutzer zugewiesen ist. Unterstützt $filter (eq) und $orderby. |
| userPrincipalName | Zeichenfolge | Stellt den Benutzerprinzipalnamen (UPN) dar, der einem Benutzer zugeordnet ist. Unterstützt $filter (eq) und $orderby. |
| vendorNames | Collection(String) | Der Name der Anbieter, die die Bedrohung erkannt haben. Unterstützt $filter (eq) und $orderby. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| Gerät | device | Stellt das Gerät dar, das dem Netzwerkverkehr zugeordnet ist und Details zur Hardware oder zum virtuellen Computer bereitstellt, die an der Transaktion beteiligt ist. |
| Benutzer | user | Stellt den Benutzer dar, der dem Netzwerkverkehr zugeordnet ist, und stellt Details zur Person oder zum Konto bereit, die die Transaktion initiiert. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"@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"
}
}