Networks, devices, and sensors · GraphQL type

WlanInterfaceConnection type

The association between an endpoint's WlanInterface and a Wi-Fi network, identified by the adapter, the network name (SSID), and the access point's BSSID. It records the security in use (authentication and cipher algorithms), the 802.11 standard, signal and noise levels, channel, and link rates as observed from the endpoint. It links to the WlanAccessPoint the adapter is joined to and to the IP-layer Network objects reached through the connection.

Fields

Field Name Description
id - ID! The WlanInterfaceConnection's unique identifier on the security graph.
orgId - OrganizationId! Unique identifier that corresponds to your deployment of this product or a specific customer account that this Endpoint belongs to.
seen - SeenOnline! Describes when this WlanInterfaceConnection was seen.
objectType - GraphObjectType! The type of this graph object.
objectTypeLabel - String! A localized label describing the object type.
displayName - String! A concise human-friendly identifier for this object suitable for display in user interface page titles and in AI chat responses that refer to the object.
firstSeen - Time! Time this object was first seen.
lastSeen - Time! Time this object was last seen.
createdAt - Time! The time this object was created in the security graph.
updatedAt - Time! The time this object was last mutated in the security graph.
snapshotInfo - GraphObjectSnapshotInfo! Whether this object is a point-in-time snapshot of an object's state rather than the object's live state, and when that state was observed.
interfaceId - String! Unique Id of the Wireless LAN interface where this Wlan Network is connected to an endpoint. MS Windows: win32 GUID for more info see GUID structure (Microsoft) macOS: BSD-style interface name.
ssid - String! Service Set Identifier (SSID) or name of the connected Wireless LAN network. The SSID is used by clients to access the network.
securityEnabled - Boolean! Indicates whether security is enabled on the network. A value of TRUE indicates that security is enabled, otherwise it is not.
authAlgo - WlanDotAuthAlgorithm! The authentication algorithm used to join this network.
cipherAlgo - WlanDotCipherAlgorithm! The cipher algorithm used on this network.
interfaceMode - WlanInterfaceMode! The 802.11 operating mode of the endpoint's adapter on this connection, such as INFRA_NON_AP for a client station joined to an access point.
bssId - Mac The basic service set identifier (BSSID) of the AccessPoint that is connected. The BSSID is usually the same as the devices Mac address. On some systems it may be unavailable.
physicalType - WlanDot11PhysicalType! The physical hardware type or standard used to connect to the AP.
rssiDbm - Int! Wireless LAN signal strength measured in -dBm.
noiseDbm - Int Wireless LAN noise level measured in -dBm if available.
channelNumber - Int Wireless LAN radio channel number if available.
channelWidth - WlanChannelWidth Width of the radio channel in use, in megahertz, if available.
channelBand - WlanChannelBand Frequency band of the radio channel in use, such as 2.4 GHz or 5 GHz, if available.
rxRateBitsPerSecond - Uint64 Receive rate in bits per second.
txRateBitsPerSecond - Uint64! Transmit rate in bits per second.
accessPoint - WlanAccessPoint The access point this connection is currently connected to if available.
wlanInterface - WlanInterface The Wireless LAN interface this current connection belongs to.
networks - NetworkConnection! Network objects this connection is currently connected to. A connection may hold IP addresses on multiple networks (e.g. IPv4 and IPv6, or several CIDRs), so this is a collection.

Arguments

limit - Int

Maximum number of results to return.

skip - Int

Number of results to skip.
networksSeenConnectedTo - NetworkConnection! Historical sightings of this connection connected to Network objects. Each edge records when the connection was observed on that network; pass timeRange to constrain the window. When timeRange is null the last 30 days will be returned.

Arguments

limit - Int

Maximum number of results to return.

skip - Int

Number of results to skip.

timeRange - DateTimeRangeInput

Restrict edges to a date/time range.

includeSeen - Boolean

Include the per-edge seen series in the response.
findings - FindingsPayload! Policy findings for this object.

Arguments

limit - Int

Maximum number of results to return.

skip - Int

Number of results to skip.
issues - IssuesPayload! Policy issues for this object.

Arguments

limit - Int

Maximum number of results to return.

skip - Int

Number of results to skip.
issuesSummary - IssuesSummary! Summary of the active policy issues currently open on this object, broken down by severity.

Used by

  • Network type: An IP network (subnet) that a managed Endpoint has been attached to, identified by its address range in CIDR notation and, for networks outside a…
  • WlanInterface type: A wireless LAN (Wi-Fi) adapter on an Endpoint, collected from Windows, macOS, and Linux endpoints by the periodic Wi-Fi inventory.
  • GraphObjectType enum: An enumeration of the different types of security graph objects.
  • GraphObjectTypeCategory enum: High-level grouping used to organize GraphObjectType values in UI navigation and API discovery.
  • WlanInterfaceConnectionConnection type: Collection payload for WlanInterfaceConnection edges with total count.
  • WlanInterfaceConnectionEdge type: Edge payload for a WlanInterfaceConnection with optional seen data.
  • WlanInterfaceConnectionPayload type: Payload wrapper for a single WlanInterfaceConnection result.

Related types

  • Network An IP network (subnet) that a managed Endpoint has been attached to, identified by its address range in CIDR notation and, for networks outside a…
  • WlanAccessPoint A Wi-Fi access point radio, identified by the network name (SSID) it broadcasts and its BSSID, as heard by managed endpoints scanning for nearby…
  • WlanInterface A wireless LAN (Wi-Fi) adapter on an Endpoint, collected from Windows, macOS, and Linux endpoints by the periodic Wi-Fi inventory.

Example

Example

{
  "id": "4",
  "orgId": "615f3b3b28284380e28a7342",
  "seen": SeenOnline,
  "objectType": "ACCOUNT_POLICY",
  "objectTypeLabel": "xyz789",
  "displayName": "xyz789",
  "firstSeen": "2021-10-07T18:23:25.829Z",
  "lastSeen": "2021-10-07T18:23:25.829Z",
  "createdAt": "2021-10-07T18:23:25.829Z",
  "updatedAt": "2021-10-07T18:23:25.829Z",
  "snapshotInfo": GraphObjectSnapshotInfo,
  "interfaceId": "xyz789",
  "ssid": "xyz789",
  "securityEnabled": true,
  "authAlgo": "OPEN",
  "cipherAlgo": "NONE",
  "interfaceMode": "INFRA_NON_AP",
  "bssId": "f0:18:98:14:8e:80",
  "physicalType": "UNKNOWN",
  "rssiDbm": 987,
  "noiseDbm": 123,
  "channelNumber": 123,
  "channelWidth": "UNKNOWN",
  "channelBand": "UNKNOWN",
  "rxRateBitsPerSecond": "8589934592",
  "txRateBitsPerSecond": "8589934592",
  "accessPoint": WlanAccessPoint,
  "wlanInterface": WlanInterface,
  "networks": NetworkConnection,
  "networksSeenConnectedTo": NetworkConnection,
  "findings": FindingsPayload,
  "issues": IssuesPayload,
  "issuesSummary": IssuesSummary
}