Networks, devices, and sensors · GraphQL type

Sensor type

A built-in network probe that gathers data about a Device or Network: host discovery, TCP and UDP port scans, and protocol-specific probes such as HTTP, TLS, SSH, SMB, DNS, SNMP, UPnP, mDNS, and DHCP. Every organization has the same sensor catalog, returned by sensors; SensorScope objects decide which sensors may run against which devices. A sensor runs in one or more zones: LAN sensors run directly on an endpoint, while SAE and PUBLIC sensors run through a SensorRequest. The network services a sensor discovers are recorded as Service objects that name the sensor that last found them.

Fields

Field Name Description
id - ID! A unique identifier for this Sensor.
zones - [SensorZone!] The zones this sensor is available in.
name - String! The display name of this sensor corresponding to its type, localized to the caller's language.
description - String! A description of what this sensor reports on, localized to the caller's language.

Used by

  • SensorRequest type: A standing request to run one Sensor against one Device IP address, optionally on a specific protocol and port, in the SAE or PUBLIC zone.
  • Service type: A network service identified on a discovered Device: one protocol (such as HTTP, TLS, SSH, SMB, DNS, SNMP, IPP, mDNS, or UPnP) acting as a client or…
  • SensorScope type: An organization's rule for which Sensor probes may run against which devices.
  • SensorsPayload type: Payload wrapper for a list of Sensor results.

Example

Example

{
  "id": "4",
  "zones": ["LAN"],
  "name": "xyz789",
  "description": "xyz789"
}