Networks, devices, and sensors · GraphQL type

WlanNetwork type

A Wi-Fi network identified by its network name (SSID), visible to managed endpoints when they scan for nearby networks on Windows, macOS, or Linux. There is one WlanNetwork per SSID per organization, shared by every endpoint that sees it, so the record shows which WlanInterface objects have seen the network and which WlanAccessPoint radios broadcast it. It records the advertised security configuration and flags authentication and cipher algorithms known to be insecure.

Fields

Field Name Description
id - ID! The WlanNetwork'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 WlanNetwork 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.
ssid - String! Service Set Identifier (SSID) or name of the Wireless LAN network. The SSID is used by clients to access the network.
mode - WlanInterfaceMode! The 802.11 operating mode of the network as reported by the scan, such as INFRA_AP for a network run by an access point or IBSS for an ad hoc network.
connectable - Boolean! Indicates whether the network is connectable or not. If set to TRUE, the network is connectable, otherwise the network cannot be connected to.
rssiDbm - Int! Wireless LAN signal strength measured in -dBm.
noiseDbm - Int Wireless LAN noise level measured in -dBm if available.
securityEnabled - Boolean! Indicates whether security is enabled on the network. A value of TRUE indicates that security is enabled, otherwise it is not.
authAlgos - [WlanDotAuthAlgorithm!] The authentication algorithms used to join this network for the first time.
cipherAlgo - WlanDotCipherAlgorithm! The cipher algorithm to be used when joining this network.
accessPoints - WlanAccessPointConnection! Access points on this network. When timeRange is null the default time range is used. 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.

insecureAuthAlgo - Boolean! Set to true if authAlgos is known to be using an insecure algorithm.
insecureCipherAlgo - Boolean! Set to true if cipherAlgo is known to be using an insecure algorithm.
wlanInterfaces - WlanInterfaceList! Wireless LAN interfaces that have seen this network as available. When timeRange is null the default time range is used. 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

  • wlanNetwork query: Retrieves a WlanNetwork by its graph object id: a Wi-Fi network (SSID) seen by endpoint Wi-Fi scans, with its advertised security and flags for…

Used by

  • WlanAccessPoint type: 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…
  • 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.
  • WlanNetworkConnection type: Collection payload for WlanNetwork edges with total count.
  • WlanNetworkEdge type: Edge payload for a WlanNetwork with optional seen data.
  • WlanNetworkPayload type: Payload wrapper for a single WlanNetwork result.

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,
  "ssid": "abc123",
  "mode": "INFRA_NON_AP",
  "connectable": true,
  "rssiDbm": 987,
  "noiseDbm": 123,
  "securityEnabled": true,
  "authAlgos": ["OPEN"],
  "cipherAlgo": "NONE",
  "accessPoints": WlanAccessPointConnection,
  "insecureAuthAlgo": false,
  "insecureCipherAlgo": false,
  "wlanInterfaces": WlanInterfaceList,
  "findings": FindingsPayload,
  "issues": IssuesPayload,
  "issuesSummary": IssuesSummary
}