Networks, devices, and sensors · GraphQL type

WlanInterface type

A wireless LAN (Wi-Fi) adapter on an Endpoint, collected from Windows, macOS, and Linux endpoints by the periodic Wi-Fi inventory. It records the adapter's radio and connection state and maps to the general-purpose Interface for the same adapter. Its current association is a WlanInterfaceConnection, and the Wi-Fi networks its scans can see are WlanNetwork objects.

Fields

Field Name Description
id - ID! The WlanInterface'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 WlanInterface 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.
endpoint - Endpoint The Endpoint this WlanInterface belongs to if available.
interface - Interface The network interface on the endpoint that this Wireless LAN interface maps to if available.
interfaceId - String! Unique Id of the Wireless LAN interface on an endpoint. MS Windows: win32 GUID for more info see GUID structure (Microsoft) macOS: BSD-style interface name.
description - String O/S description of the interface on the endpoint if available.
mac - Mac The basic service set identifier (BSSID) of the endpoint Wireless LAN interface on the endpoint. The BSSID is usually the same as the Wlan interface Mac address.
connectionState - WlanInterfaceConnectionState The connection state of the interface.
radioState - WlanInterfaceRadioState The state of the wireless lan radio.
connections - WlanInterfaceConnectionConnection! Current connections on this Wireless LAN interface.

Arguments

limit - Int

Maximum number of results to return.

skip - Int

Number of results to skip.
connectionsSeen - WlanInterfaceConnectionConnection! Historical sightings of WlanInterfaceConnection on this Wireless LAN interface. Each edge records when the connection was observed; 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.
availableNetworks - WlanNetworkConnection! Wireless LAN networks currently visible from the interface. When timeRange is null the last 30 days will be returned. When timeRange is specified all entries seen in the time range are returned.

Arguments

limit - Int

Maximum number of results to return.

skip - Int

Number of results to skip.

timeRange - DateTimeRangeInput

Optional time range filter.

includeSeen - Boolean

When true, the payload will include information about when the edge was seen in the relationship. The data set will be limited to the time range specified in the timeRange field. If includeSeen is true and timeRange is null then seen data for the default 7 day time range will be returned.
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.

Returned by

  • wlanInterface query: Retrieves a WlanInterface by its graph object id: a Wi-Fi adapter on a Windows, macOS, or Linux endpoint, with its radio and connection state.
  • wlanInterfaceConnection query: Retrieves a WlanInterfaceConnection by its graph object id: an endpoint Wi-Fi adapter's association with one network and access point, with its…

Used by

  • Endpoint type: A Windows, macOS, or Linux computer that runs the Wartiva endpoint agent and is enrolled with an organization.
  • 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.
  • RuleApplyToOptionKey enum: Attribute keys that further scope which objects a rule applies to, in addition to its applyTo object 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…
  • WlanInterfaceEdge type: Edge payload for a WlanInterface with optional seen data.
  • WlanInterfaceList type: Collection payload for WlanInterface edges with total count.
  • WlanInterfacePayload type: Payload wrapper for a single WlanInterface result.

Related types

  • Endpoint A Windows, macOS, or Linux computer that runs the Wartiva endpoint agent and is enrolled with an organization.
  • Interface A network interface (physical, virtual, loopback, or tunnel) on an Endpoint, collected from Windows, macOS, and Linux endpoints as part of the…

Example

Example

{
  "id": "4",
  "orgId": "615f3b3b28284380e28a7342",
  "seen": SeenOnline,
  "objectType": "ACCOUNT_POLICY",
  "objectTypeLabel": "abc123",
  "displayName": "abc123",
  "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,
  "endpoint": Endpoint,
  "interface": Interface,
  "interfaceId": "abc123",
  "description": "abc123",
  "mac": "f0:18:98:14:8e:80",
  "connectionState": "NOT_READY",
  "radioState": "ON",
  "connections": WlanInterfaceConnectionConnection,
  "connectionsSeen": WlanInterfaceConnectionConnection,
  "availableNetworks": WlanNetworkConnection,
  "findings": FindingsPayload,
  "issues": IssuesPayload,
  "issuesSummary": IssuesSummary
}