Search Tokens for IT Assets

Syntax help displayed in UI for tokens. Click each token to learn more about it.

Note:

- For all the date-related tokens, the date search is evaluated only for UTC format. The actual search results might show you the date as per your time zone.

- For the range searches, remember that the QQL search tokens are case-sensitive. Hence, make sure that you enter the correct token syntax. For more information, see Range Searches.

- While using the nested QQL queries for software-related tokens using the 'not' operator and multiple values in [], the placement of 'not' is very important. Make sure to enter the correct token syntax. Otherwise, you will not get the expected results. For more information, see the Nested Queries section from the How to Search topic.

Asset Inventory and Passive Sensor | AWS EC2 | Microsoft Azure | Google Cloud Platform | Oracle Cloud Infrastructure | IBM Cloud |Passive Sensor only |Alibaba| Certificates 

Asset Inventory and Passive Sensor

accounts.usernameaccounts.username

Use a text value ##### to help you find an account username you're looking for.

Example

Show findings with username administrator

accounts.username:"administrator"

agent.activations.keyagent.activations.key

Use a text value ##### to define the agent activation key you're interested in.

Example

Show assets with agents activated using this key

agent.activations.key: "057cc48a-8d84-48eb-add4-97a605d0567d"

agent.activations.statusagent.activations.status

Select the agent activation status (ACTIVE, INACTIVE, UNSUPPORTED) you're interested in. Select from names in the drop-down menu.

Example

Show assets with active agents

agent.activations.status: ACTIVE

agent.agentIDagent.agentID

Use a text value ##### to help you find systems with a Qualys agent ID of interest.

Example

Show findings with this agent ID

asset.agentID:"0fc8e682-e9cc-4e7d-b92a-0c905d81ec74"

agent.configurationProfileagent.configurationProfile

Use values within quotes or backticks to help you find the agent configuration profile you're looking for. Quotes can be used when the value has more than one word.

Examples

Show any findings related to profile name

agent.configurationProfile: Initial Profile

Show any findings that contain parts of the name

agent.configurationProfile: "Initial Profile"

Show any findings that match exact value

agent.configurationProfile: `Initial Profile`

agent.connectedFromagent.connectedFrom

Use a text value ##### to define the external IP address a cloud agent connected from.

Example

Show findings for an external IP address that an agent connected from

agent.connectedFrom: 10.0.100.11

asset.isContainerHostasset.isContainerHost

Use the values true | false to define assets hosting containers.

Example

Show assets that host containers

asset.isContainerHost: "true"

asset.hostingCategory1asset.hostingCategory1

Use a value to filter your assets based on the hosting category. The supported values are CDN, Cloud, OnPrem, and ThirdParty.

Example

Show findings with hosting catagory CDN

asset.hostingCategory1:"CDN"

agent.lastActivityagent.lastActivity

Use a date range or specific date to define when last agent activity occurred.

Examples

Show last agent activity within certain dates

agent.lastActivity:[2019-01-01 ... 2019-01-15]

Show last agent activity starting 2019-01-15, ending 1 month ago

agent.lastActivity:[2019-01-15 ... now-1M]

Show last agent activity starting 2 weeks ago, ending 1 second ago

agent.lastActivity:[now-2w ... now-1s]

Show last agent activity on a specific date

agent.lastActivity:'2019-03-18'

agent.lastCheckedInagent.lastCheckedIn

Use a date range or specific date to define when agents last checked in to the platform.

Examples

Show findings with last check in within a specific date range.

agent.lastCheckedIn:[2020-01-01 ... 2020-01-10]

Show findings with last check in starting 2019-11-01, ending 1 month ago.

agent.lastCheckedIn:[2019-11-01 ... now-1M]

Show findings with last check in starting 2 weeks ago, ending 1 second ago.

agent.lastCheckedIn:[now-2w ... now-1s]

Show findings with last check in on a specific date

agent.lastCheckedIn:'2020-02-11'

Show findings with last check in before (older than) last 30 days.

agent.lastCheckedIn<now-30d

Note: In this case, we recommend not to use the NOT operator in your range search to form a query like NOT lastCheckedIn:[now-30d...now-2s]. See 'Say no to NO' section in the 'QQL Best Practices' topic in the Unified Dashboard online Help.

Show findings with last check in within last 30 days excluding day 30

agent.lastCheckedIn>now-30d

Show findings with last check in within last 30 days including day 30

agent.lastCheckedIn>=now-30d

Show findings with last check in which is older than last 30 days excluding day 30

agent.lastCheckedIn<now-30d

Show findings with last check in which is older than last 30 days including day 30

agent.lastCheckedIn<=now-30d

agent.lastInventoryagent.lastInventory

Use a date range or specific date to define when last inventory scan was performed.

Examples

Show last inventory scan within certain dates

agent.lastInventory:[2019-01-01 ... 2019-01-15]

Show last inventory scan starting 2019-01-15, ending 1 month ago

agent.lastInventory:[2019-01-15 ... now-1M]

Show last inventory scan starting 2 weeks ago, ending 1 second ago

agent.lastInventory:[now-2w ... now-1s]

Show last inventory scan on a specific date

agent.lastInventory:'2019-03-18'

agent.udcManifestAssignedagent.udcManifestAssigned

Use the values true | false to find assets with PC agents assigned a UDC manifest. Assets are found when agents have the PC module enabled and one or more user defined controls have been added to your subscription.

Examples

Show assets with agents assigned a UDC manfest

agent.udcManifestAssigned: "true"

Show assets with agents not assigned a UDC manifest

agent.udcManifestAssigned: "false"

agent.versionagent.version

Use a text value ##### to help you find agents with certain version number.

Example

Show agents of this version

asset.version:1.3.2.0

agent.swCAIdealCandidateagent.swCAIdealCandidate

Use the value to find assets on which at least one of the software components from Ruby, Node.js, Go, Rust, PHP, Python, Java Platform, Standard Edition (Java SE) is identified. The supported values are ‘true’ and ‘false’.

Example

Show assets on which at least one of the software components is identified

agent.swCAIdealCandidate:true

asset.agentIDasset.agentID

Use an integer value ##### to help you find systems with a cloud agent ID you're looking for.

Example

Show findings with this agent ID

asset.agentID:12345679

asset.assetIDasset.assetID

Use an integer value ##### to help you find systems with a Qualys asset ID of interest.

Note: The same token is used to find the certificates for assets with the specified asset ID, but the token syntax is different. See all token examples.

Example

Show findings with this asset ID

asset.assetID:122855563

Find the certificates for assets with the specified asset ID

Examples for Certificate Token

Show certificates on assets with the specified asset ID.

asset:(assetID: 49267969)

asset.urlasset.url

Use value to filter web assets based on the IP, domain, subdomain, or URL used during Web Application creation.

Example

Show the web application that matches the asset URL.

asset.url:http://172.31.28

Show the web application that matches the asset URL

asset.url:https://10.100.200.60:12345/

asset.biosAssetTagasset.biosAssetTag

Use values within quotes or backticks to help you find assets with a certain BIOS asset tag.

Examples

Show any findings that contain this BIOS asset tag

asset.biosAssetTag:113632

Show any findings that contain parts of BIOS asset tag

asset.biosAssetTag:"113632"

Show any findings that match exact value

asset.biosAssetTag:`113632`

asset.biosDescriptionasset.biosDescription

Use values within quotes or backticks to help you find the BIOS description you're looking for.

Examples

Show any findings that contain parts of description

asset.biosDescription:"American Megatrends Inc."

Show any findings that match exact value "American Megatrends Inc."

asset.biosDescription:`American Megatrends Inc.`

asset.biosSerialNumberasset.biosSerialNumber

Use a text value ##### to help you find assets with a certain BIOS Serial Number

Example

Show findings with this BIOS Serial Number

asset.biosSerialNumber:C02S50JDFVH8

asset.cpuCountasset.cpuCount

Use an integer value ##### to help you find assets with some number of CPUs.

Example

Show assets that have 2 CPUs

asset.cpuCount:2

asset.createdasset.created

Use a date range or specific date to define when assets were created.

Note: The same token is used to find the certificates for the specified asset creation date, but the token syntax is different. See all token examples.

Examples

Show assets created within certain dates

asset.created:[2019-01-01 ... 2019-01-15]

Show assets created starting 2019-01-15, ending 1 month ago

asset.created:[2019-01-15 ... now-1M]

Show assets created starting 2 weeks ago, ending 1 second ago

asset.created:[now-2w ... now-1s]

Show assets created on a specific date

asset.created:'2019-03-18'

Find the certificates for the specified asset creation date

Examples for Certificate Token

Show assets created within certain dates

asset:(created: [2023-01-01 ... 2024-01-15])

Show assets created starting 2019-01-15, ending 1 month ago

asset:(created: [2019-01-15... now-1M])

Show assets created starting 2 weeks ago, ending 1 second ago

asset:(created: [now-2w ... now-1s])

Show assets created on a specific date

asset:(created: `2024-01-18`)

asset.criticalityScoreasset.criticalityScore

Use values within quotes or backticks to help you find the assets you're looking for based on the asset criticality score. The supported values are 1 to 5.

Note: The same token is used to find the certificates for the specified asset criticality score, but the token syntax is different. See all token examples.

Examples

Show assets based on the asset criticality score 1

asset.criticalityScore:`1`

find the certificates for the specified asset criticality score

Examples for Certificate Token

Show certificates for assets with the following criticality score

asset:(criticalityScore: 5)

asset.riskScoreasset.riskScore

Use a numerical value ##### to search all the assets with their severity based on the calculated risk score between 0 to 1000.

Note: The same token is used to find the certificates for assets with the specified asset risk score, but the token syntax is different. See all token examples.

Examples

Show all the assets with a risk score 900

asset.riskScore:900

Show all the assets with risk score between the range 800 to 1000

asset.riskScore:[800 ... 1000]

Show all the assets with a risk score greater than 500

asset.riskScore >500

Show all the assets with a risk score less than or equal to 800

asset.riskScore <=800

Find the certificates for assets with the specified asset risk score

Examples for Certificate Token

Show certificats for assets with a risk score 800

asset:(riskScore:800)

Show certificats for assets with risk score between the range 700 to 1000

asset:(riskScore:[700 ... 1000])

Show certificats for assets with a risk score greater than 600

asset:(riskScore >600)

Show certificats for assets with a risk score less than or equal to 600

asset:(riskScore <=600)

asset.biosHardwareUUIDasset.biosHardwareUUID

Use a text value ##### to help you find assets with a certain bios hardware UUID

Example

Show findings with this bios hardware UUID

asset.biosHardwareUUID:152FBCC6-641B-5661-9E68-DEF35D8C4B51

asset.hostIDasset.hostID

Use an integer value ##### to help you find the asset with a certain Qualys host ID (UUID), assigned by an agent or a scanner appliance when Agentless Tracking is used.

Example

Show assets having this host ID

asset.hostID:43954857

asset.lastBootasset.lastBoot

Use a date range or specific date to define when assets were last booted.

Examples

Show assets last booted within certain dates

asset.lastBoot:[2019-01-01 ... 2019-01-15]

Show assets last booted starting 2019-01-15, ending 1 month ago

asset.lastBoot:[2019-01-15 ... now-1M]

Show assets last booted starting 2 weeks ago, ending 1 second ago

asset.lastBoot:[now-2w ... now-1s]

Show assets last booted on a specific date

asset.lastBoot:'2019-03-18'

asset.lastLoggedOnUserasset.lastLoggedOnUser

Use a text value ##### to help you find assets last logged into by a user of interest.

Examples

Show assets with last logon by user asmith

asset.lastLoggedOnUser:asmith

asset.lastUpdatedasset.lastUpdated

Use a date range or specific date to define when assets were last updated.

Note: The same token is used to find the certificates for the specified asset last updated date, but the token syntax is different. See all token examples.

Examples

Show assets last updated within certain dates

asset.lastUpdated:[2019-01-01 ... 2019-01-15]

Show assets last updated starting 2019-01-15, ending 1 month ago

asset.lastUpdated:[2019-01-15... now-1M]

Show assets last updated starting 2 hours ago, ending 1 second ago

asset.lastUpdated:[now-2h ... now-1s]

Show assets last updated starting 4 hours ago, ending 1 hour ago

asset.lastUpdated:[now-4h ... now-1h]

Show assets last updated starting 2 weeks ago, ending 1 second ago

asset.lastUpdated:[now-2w ... now-1s]

Show assets last updated on a specific date

asset.lastUpdated:'2019-03-18'

Find the certificates for the specified asset creation date

Examples for Certificate Token

Show certificates for assets last updated within certain dates

asset:(lastUpdated: [2019-01-01 ... 2019-01-15])

Show certificates for assets last updated starting 2019-01-15, ending 1 month ago

asset:(lastUpdated: [2019-01-15... now-1M])

Show certificates for assets last updated starting 2 weeks ago, ending 1 second ago

asset:(lastUpdated: [now-2w ... now-1s])

Show certificates for assets last updated on a specific date

asset:(lastUpdated: `2024-01-18`)

asset.nameasset.name

Use values within quotes or backticks to help you find the asset name you're looking for.

Examples

Show any findings that match the beginning of any substrings within the asset name

asset.name:"ACMENVT7"

Show any findings that match exact value "ACMENVT7"

asset.name:`ACMENVT7`

asset.netbiosNameasset.netbiosName

Use a text value ##### to define the asset NetBIOS name you're interested in.

Examples

Show the asset with this name

asset.netbiosName:ACMENVT7

asset.timezoneasset.timezone

Use a text value ##### in quotes to find assets with a certain timezone set.

Example

Show assets with this timezone

asset.timezone:"-08:00"

asset.totalMemoryasset.totalMemory

Use an integer value ##### to help you find assets with a certain total system memory (MB).

Example

Show findings with total system memory greater than 900 MB

asset.totalMemory>900

Show findings with total system memory greater than or equal to 900 MB

asset.totalMemory>=900

Show findings with total system memory less than 300 MB

asset.totalMemory<300

Show findings with total system memory less than or equal to 300 MB

asset.totalMemory<=300

asset.trackingMethodasset.trackingMethod

Find assets with certain tracking method (ACTIVE_DIRECTORY, BMC_HELIX, DNSNAME, EASM, GCP_INSTANCE_ID, ICS_OCA, INSTANCE_ID, IP, NETBIOS, NONE, OCA, ORACLE, PASSIVE_SENSOR, QAGENT, SEM, SERVICE_NOW, THIRD_PARTY, VIRTUAL_MACHINE_ID, and WEBHOOK). Select from values in the drop-down menu.

Example

Find assets with this tracking method

asset.trackingMethod: QAGENT

asset.domainRoleasset.domainRole

Use values within quotes or backticks to help you find the assets with certain domain role (Standalone Workstation, Member Workstation, Standalone Server, Member Server, Backup Domain Controller, and Primary Domain Controller). Select from values in the drop-down menu.

Examples

Show any findings that contain parts of name

asset.domainRole:"Member Ser"

Show any findings that match exact value "Member Server"

asset.domainRole:`Member Server`

asset.typeasset.type

Find assets of a certain type (container host, hypervisor, virtual machine). Select from the asset types in the drop-down menu.

Example

Find assets of type hypervisor

asset.type: hypervisor

asset.lastLocationasset.lastLocation

Use a text value ##### to help you find assets based on last location.

Example

Show assets with last location as Redwood City, California - United States

asset.lastLocation: 'Redwood City, California - United States'

Example

Show assets with last location with exact string

asset.lastLocation: `Redwood City, California - United States`

asset.lastLocation.continentasset.lastLocation.continent

Use a text value ##### to help you find assets based on continent of the last location.

Example

Show assets with last location continent as North America

asset.lastLocation.continent: North America

asset.lastLocation.countryasset.lastLocation.country

Use a text value ##### to help you find assets based on country of the last location.

Example

Show assets with last location country as United States

asset.lastLocation.country: United States

asset.lastLocation.stateasset.lastLocation.state

Use a text value ##### to help you find assets based on state of the last location.

Example

Show assets with last location state as California

asset.lastLocation.state: California

asset.lastLocation.cityasset.lastLocation.city

Use a text value ##### to help you find assets with city of the last location.

Example

Show assets with assigned location city as Miami

asset.lastLocation.city: Miami

asset.lastLocation.postalasset.lastLocation.postal

Use an integer value ##### to help you find the assets based on postal of the last location.

Example

Show assets with last location postal as 94065

asset.lastLocation.postal: 94065

asset.operationalStatusasset.operationalStatus

Use a text value ##### to help you find assets based on operational status.

Example

Show assets with operational status as Repair

asset.operationalStatus: Repair

asset.environmentasset.environment

Use a text value ##### to help you find assets based on environment.

Example

Show assets with environment as Production

asset.environment: Production

asset.ownedByasset.ownedBy

Use values within quotes or backticks to help you find assets owned by.

Examples

Show any findings that contain parts of name

asset.ownedBy:"Joey"

Show any findings that match exact value "Joey Bolick"

asset.ownedBy:`Joey Bolick`

asset.managedByasset.managedBy

Use values within quotes or backticks to help you find assets managed by.

Examples

Show any findings that contain parts of name

asset.managedBy:"Byron"

Show any findings that match exact value "Byron Fortuna"

asset.managedBy:`Byron Fortuna`

asset.supportedByasset.supportedBy

Use values within quotes or backticks to help you find assets supported by.

Examples

Show any findings that contain parts of name

asset.supportedBy:"John"

Show any findings that match exact value "John Doe"

asset.supportedBy:`John Doe`

asset.supportGroupasset.supportGroup

Use values within quotes or backticks to help you find assets with support group.

Note: The same token is used to find the certificates for assets with the specified support group, but the token syntax is different. See all token examples.

Examples

Show any findings that contain parts of name

asset.supportGroup:"Compliance"

Show any findings that match exact value "Compliance Managers"

asset.supportGroup:`Compliance Managers`

Find the certificates for assets with the specified support group.

Examples for Certificate Token

Show any findings that contain parts of name

asset:(supportGroup:"Compliance")

Show any findings that match exact value "Compliance Managers"

asset:(supportGroup:`Compliance Managers`)

asset.org.companyasset.org.company

Use a text value ##### to help you find assets with company.

Example

Show assets with company as Qualys

asset.org.company: Qualys

asset.org.departmentasset.org.department

Use a text value ##### to help you find assets with department.

Example

Show assets with department as Development

asset.org.department: Development

asset.assignedLocation.nameasset.assignedLocation.name

Use values within quotes or backticks to help you find assets with name of the assigned location.

Examples

Show any findings that contain parts of name

asset.assignedLocation.name:"401 Biscayne St, Miami"

Show any findings that match exact value "401 Biscayne St, Miami FL"

asset.assignedLocation.name:`401 Biscayne St, Miami FL`

asset.assignedLocation.cityasset.assignedLocation.city

Use a text value ##### to help you find assets with city of the assigned location.

Example

Show assets with assigned location city as Miami

asset.assignedLocation.city: Miami

asset.assignedLocation.stateasset.assignedLocation.state

Use a text value ##### to help you find assets with state of the assigned location.

Example

Show assets with assigned location state as FL

asset.assignedLocation.state: FL

asset.assignedLocation.countryasset.assignedLocation.country

Use a text value ##### to help you find assets with country of the assigned location.

Example

Show assets with assigned location country as USA

asset.assignedLocation.country: USA

businessApp.namebusinessApp.name

Use values within quotes or backticks to help you find the business application name you're looking for.

Examples

Show any findings that contain parts of name

businessApp:(name:"HR")

Show any findings that match exact value "HR Intranet"

businessApp:(name:`HR Intranet`)

businessApp.idbusinessApp.id

Use a text value ##### to help you find business application using unique ID.

Example

Show findings with business app ID as APP007

businessApp:(id:APP007)

businessApp.operationalStatusbusinessApp.operationalStatus

Use a text value ##### to help you find business applications based on operational status.

Example

Show business applications with operational status as Installed

businessApp:(operationalStatus: Installed)

businessApp.businessCriticalitybusinessApp.businessCriticality

Use values within quotes or backticks to help you find the business application you're looking for.

Examples

Show any findings that contain parts of name

businessApp:(businessCriticality:"1 - most")

Show any findings that match exact value "1 - most critical"

businessApp:(businessCriticality:`1 - most critical`)

businessApp.environmentbusinessApp.environment

Use a text value ##### to help you find business application based on environment.

Example

Show assets with business application environment as Production

businessApp:(environment: Production)

businessApp.ownedBybusinessApp.ownedBy

Use values within quotes or backticks to help you find business applications owned by.

Examples

Show any findings that contain parts of name

businessApp:(ownedBy:"Joey")

Show any findings that match exact value "Joey Bolick"

businessApp:(ownedBy:`Joey Bolick`)

businessApp.managedBybusinessApp.managedBy

Use values within quotes or backticks to help you find business applications managed by.

Examples

Show any findings that contain parts of name

businessApp:(managedBy:"Byron")

Show any findings that match exact value "Byron Fortuna"

businessApp:(managedBy:`Byron Fortuna`)

businessApp.supportedBybusinessApp.supportedBy

Use values within quotes or backticks to help you find business applications supported by.

Examples

Show any findings that contain parts of name

businessApp:(supportedBy:"John")

Show any findings that match exact value "John Doe"

businessApp:(supportedBy:`John Doe`)

businessApp.supportGroupbusinessApp.supportGroup

Use a text value ##### to help you find business applications with support group.

Example

Show assets with business application support group as Security

businessApp:(supportGroup: Security)

qualysCorrelationIDqualysCorrelationID

Use a text value ##### to help you find assets with Qualys Correlation ID.

Examples

Show assets with this correlation ID

qualysCorrelationID: 0f1b031712682e27cca306e4a2a9e3144696ac099b08fcdf76ccb6f3647ec058

Show assets without any correlation ID

qualysCorrelationID: UNIDENTIFIED

Show all assets with correlation ID

qualysCorrelationID: *

connectors.connector.nameconnectors.connector.name

Use a text value ##### to define the connector name you're interested in.

Example

Show findings detected by connector name myec2

connectors.connector.name: myec2

connectors.connectorIdconnectors.connectorId

Enter the connector ID that is an integer value ##### to help you find assets sourced from a specific connector created by the user.

Note: This token is for the new feature, Third-Party Asset Identification, which is in the Beta phase. The feature is in early stage and only available on a request basis. Contact your Technical Account Manager (TAM) for more information.

Example

Show findings with this connector ID

connectors.connectorId:1278237

connectors.firstDiscoveredconnectors.firstDiscovered

Use a date range or specific date to define when findings were first discovered.

Examples

Show findings first discovered within certain dates

connectors.firstDiscovered:[2023-10-21 ... 2023-01-15]

Show findings first discovered starting 2023-01-01, ending 1 month ago

connectors.firstDiscovered:[2016-01-01 ... now-1M]

Show findings first discovered on certain date

connectors.firstDiscovered:[2023-06-01]

Show findings first discovered within certain number of days

connectors.firstDiscovered:[80..140]

connectors.lastDiscoveredconnectors.lastDiscovered

Use a date range or specific date to define when findings were last discovered.

Examples

Show findings last discovered within certain dates

connectors.lastDiscovered:[2023-10-21 ... 2023-01-15]

Show findings last discovered starting 2023-01-01, ending 1 month ago

connectors.lastDiscovered:[2016-01-01 ... now-1M]

Show findings last discovered on certain date

connectors.lastDiscovered:[2023-06-01]

Show findings last discovered within certain number of days

connectors.lastDiscovered:[80..140]

container.productcontainer.product

Use a text value ##### to define the container product.

Examples

Show container product

container.product: CONTAINERD

Show container product

container.product: DOCKER

container.versioncontainer.version

Use a text value ##### to help you find containers with certain version number.

Example

Show containers of this version

container.version:1.6

container.noOfContainerscontainer.noOfContainers

Use an integer value ##### to help you find assets with some number of containers. The value is displayed only for VM scan or Agent scan (and not for sensors).

Example

Show findings with 2 containers

container.noOfContainers:2

container.noOfImagescontainer.noOfImages

Use an integer value ##### to help you find assets with some number of container images. The value is displayed only for VM scan or Agent scan (and not for sensors).

Example

Show findings with 5 container images

container.noOfImages:5

container.hasSensorcontainer.hasSensor

Use the values true | false to choose whether to show container hosts that have the Container Sensor installed.

Example

Show container hosts with container sensor installed.

container.hasSensor:"true"

customAttributes.connectorIdcustomAttributes.connectorId

Provide the value to identify your assets based on the connector Id. Enter the connector Id as 0, which is the default connector Id for connector 'Qualys'.

Example

Find assets for connector 'Qualys'

customAttributes:(connectorId:0)

customAttributes.keycustomAttributes.key

Provide the value to identify your assets based on the key entered as part of the custom attribute.

Example

Find assets with "Department" as part of the key name

customAttributes:(key:"Department")

The result includes assets with the 'Department' custom attribute key.

Note: If 'Department' is part of the key name, such as Department 1, Department A-C, or Department US, those assets are also included in the result.

customAttributes.valuecustomAttributes.value

Provide the value to identify your assets based on the value entered as part of the custom attribute.

Example

Find assets with "DEVOPS" as part of the key value

customAttributes:(value:"DEVOPS")

The result includes assets with the 'DEVOPS' custom attribute value.

Note: If 'DEVOPS' is part of the value name, such as DEVOPS CSAM, DEVOPS CA, or DEVOPS PM, those assets are also included in the result.

easm.tags.nameeasm.tags.name

Provide the value to filter assets based on tags discovered
through EASM.

Example

Find assets with "cloud" tag

easm.tags.name: cloud

hardwarehardware

Use values within quotes or backticks to help you find the hardware name you're looking for.

Examples

Show any findings that contain parts of name

hardware:"Dell Latitude e7470"

Show any findings that match exact value

hardware:`Dell Latitude e7470`

hardware.categoryhardware.category

Use values within quotes or backticks to help you find the hardware category you're looking for.

Examples

Show any findings that match exact value

hardware.category:Printers/Laser

hardware.category1hardware.category1

Use text value ##### to find assets with hardware category 1 value.

Example

If you are searching for assets that are laser printers, then category1 is Printers and category2 is Laser.

Show any findings that match exact value

hardware.category1:Printers

hardware.category2hardware.category2

Use text value ##### to find assets with hardware category 2 value.

Example

If you are searching for assets that are laser printers, then category1 is Printers and category2 is Laser.

Show any findings that match exact value

hardware.category2:Laser

hardware.lifecycle.gahardware.lifecycle.ga

Use a date range or specific date to define a hardware general availability date of interest.

Examples

Show findings with hardware GA date in this date range

hardware.lifecycle.ga:[2019-01-01 ... 2019-01-15]

Show findings with hardware GA date starting 2019-01-15, ending 1 month ago

hardware.lifecycle.ga:[2019-01-15 ... now-1M]

Show findings with hardware GA date starting 2 weeks ago, ending 1 second ago

hardware.lifecycle.ga:[now-2w ... now-1s]

Show findings with this hardware GA date

hardware.lifecycle.ga:'2019-03-18'

hardware.lifecycle.introhardware.lifecycle.intro

Use a date range or specific date to define a hardware introduction date of interest.

Examples

Show findings with hardware introduction date in this date range

hardware.lifecycle.intro:[2019-01-01 ... 2019-01-15]

Show findings with hardware introduction date starting 2019-01-15, ending 1 month ago

hardware.lifecycle.intro:[2019-01-15 ... now-1M]

Show findings with hardware introduction date starting 2 weeks ago, ending 1 second ago

hardware.lifecycle.intro:[now-2w ... now-1s]

Show findings with this hardware introduction date

hardware.lifecycle.intro:'2019-03-18'

hardware.lifecycle.eoshardware.lifecycle.eos

Use a date range or specific date to define a hardware End-of-Sale date of interest.

Examples

Show findings with hardware End-of-Sale date in this date range

hardware.lifecycle.eos:[2019-01-01 ... 2019-01-15]

Show findings with hardware End-of-Sale date starting 2019-01-15, ending 1 month ago

hardware.lifecycle.eos:[2019-01-15 ... now-1M]

Show findings with hardware End-of-Sale date starting 2 weeks ago, ending 1 second ago

hardware.lifecycle.eos:[now-2w ... now-1s]

Show findings with this hardware End-of-Sale date

hardware.lifecycle.eos:'2019-03-18'

hardware.lifecycle.obshardware.lifecycle.obs

Use a date range or specific date to define a hardware obsolete date of interest.

Examples

Show findings with hardware obsolete date in this date range

hardware.lifecycle.obs:[2019-01-01 ... 2019-01-15]

Show findings with hardware obsolete date starting 2019-01-15, ending 1 month ago

hardware.lifecycle.obs:[2019-01-15 ... now-1M]

Show findings with hardware obsolete date starting 2 weeks ago, ending 1 second ago

hardware.lifecycle.obs:[now-2w ... now-1s]

Show findings with this hardware obsolete date

hardware.lifecycle.obs:'2019-03-18'

hardware.lifecycle.stagehardware.lifecycle.stage

Use a text value ##### in quotes to define the hardware lifecycle stage (INTRO, GA, EOS, OBS)

Example

Show End-of-Sale hardware

hardware.lifecycle.stage:"EOS"

hardware.manufacturerhardware.manufacturer

Use values within quotes or backticks to find assets having a certain hardware manufacturer.

Example

Show any findings that match exact value "Dell"

hardware.manufacturer:`Dell`

hardware.modelhardware.model

Use values within quotes or backticks to find assets having a certain hardware model.

Example

Show any findings that match exact value "e7470"

hardware.model:`De7470`

hardware.producthardware.product

Use values within quotes or backticks to find assets having a certain hardware product.

Example

Show any findings that match exact value "Latitude"

hardware.product:`Latitude`

interfaces:(addressinterfaces:(address

Use values to define an IP address you're interested in.

Examples

Show the exact match of the IP address

interfaces:(address:`10.10.100.20`)

Show any findings that contain parts of the IP address

interfaces:(address:"10.10.100.2")

interfaces:(address: 10.10.100.2)

interfaces:(dnsAddressinterfaces:(dnsAddress

Use a text value ##### to define a DNS address you're interested in.

Example

Show the asset with DNS address 10.0.100.11

interfaces:(dnsAddress:10.0.100.11)

interfaces:(gatewayAddressinterfaces:(gatewayAddress

Use a text value ##### to help you find assets with a certain default gateway address.

Example

Show assets with this default gateway address

interfaces:(gatewayAddress:10.11.65.1)

interfaces:(hostnameinterfaces:(hostname

Use values within quotes or backticks to help you find the hostname you're looking for.

Examples

Show any findings related to name

interfaces:(hostname: xpsp2-jp-26-111)

Show any findings that contain parts of name

interfaces:(hostname: "xpsp2-jp-26-111")

Show any findings that match exact value "xpsp2-jp-26-111"

interfaces:(hostname: `xpsp2-jp-26-111`)

Show any findings related to name (we'll match super domains)

interfaces:(hostname: qcentos71sqp3.rdlab.acme.com)

Show any findings that match exact value "qcentos71sqp3.rdlab.acme.com"

interfaces:(hostname: `qcentos71sqp3.rdlab.acme.com`)

Show findings according to values entered in the square brackets.

Note: You can add multiple values in []. However, it's important to understand that partial values are not supported. You must enter the exact match value.

Example with correct syntax - interfaces:(hostname: [win7-181, bridge.vuln.qa.qualys.com])

Example with incorrect syntax - interfaces:(hostname: [win7, bridge.vuln.qa])

interfaces:(interfaceNameinterfaces:(interfaceName

Use a text value ##### to help you find a certain interface name.

Example

Show the asset with name PRO/1000

interfaces:(interfaceName:PRO/1000)

interfaces:(macAddressinterfaces:(macAddress

Use values within quotes to help you find a MAC address you're interested in.

Example

Show the asset with this MAC address

interfaces:(macAddress:"00:50:56:A9:73:5A")

interfaces:(manufacturerinterfaces:(manufacturer

Use values within quotes to help you find the interface hardware manufacturer you're interested in.

Example

Show the asset with interface hardware manufacturer

interfaces:(manufacturer:"Apple")

interfaces:(netmaskinterfaces:(netmask

Use values to help you find the IP addresses from a particular class or range of IP addresses you're interested in.

Example

Show the assets with the following netmask

interfaces:(netmask:255.255.255.0)

inventory:(createdinventory:(created

Use a date range or specific date to define when assets were created (i.e. when first scanned by a scanner appliance, or when agent was installed).

Examples

Show assets created within certain dates

inventory:(created: [2019-01-01 ... 2019-01-15])

Show assets created starting 2019-01-15, ending 1 month ago

inventory:(created: [2019-01-15 ... now-1M])

Show assets created starting 2 weeks ago, ending 1 second ago

inventory:(created: [now-2w ... now-1s])

Show assets created on specific date

inventory:(created: '2019-03-18')

inventory:(lastUpdatedinventory:(lastUpdated

Use a date range or specific date to define when assets were updated (i.e. when re-scanned by a scanner appliance, or when host data uploaded to the cloud platform by an agent).

Examples

Show assets updated within certain dates

inventory:(lastUpdated: [2019-01-01 ... 2019-01-15])

Show assets updated starting 2019-01-15, ending 3 months ago

inventory:(lastUpdated: [2019-01-15 ... now-3M])

Show assets updated starting 2 weeks ago, ending 1 second ago

inventory:(lastUpdated: [now-2w ... now-1s])

Show assets updated on a specific date

inventory:(lastUpdated:'2019-03-18')

passiveSensor.idpassiveSensor.id

Type

Use an integer value ##### to help you find assets sensed by a certain sensor ID.

Example

Show this sensor ID

passiveSensor.id:"003687557369:1654660042:3809075:704:1654660042:3809075:704"

passiveSensor.locationpassiveSensor.location

Use a text value ##### to help you find assets based on specific sensor location.

Examples

Show assets with sensor location (appliance location label) as SanJose1

passiveSensor.location:"SanJose1"

passiveSensor.namepassiveSensor.name

Use a text value ##### to help you find assets based on specific sensor name.

Examples

Show assets with sensor name as ITCorp-appliance

passiveSensor.name:"ITCorp-appliance"

inventory:(sourceinventory:(source

Use a text value ##### to help you find assets from a certain Qualys source. (API, Active Directory, Appliance, Azure, BMC Helix, CAPS, CMDB, Cloud Agent, EASM, EC2, GCP, ICS OCA, IP Scanner, Malware Domain, Mobility Scanner, OCA, OCI, Passive Sensor, ServiceNow, WMWare vSphere, VMware ESXi, and Webhook) Select from values in the drop-down menu.

Examples

Show findings from cloud agents

inventory:(source: Cloud Agent)

Show findings from Passive Sensor

inventory:(source: Passive Sensor)

openPorts:(descriptionopenPorts:(description

Use values within quotes or backticks to help you find the service description detected on an open port.

Examples

Show any findings with this description

openPorts:(description: Windows Remote Desktop)

Show any findings that contain parts of description

openPorts:(description: "Windows Remote Desktop")

Show any findings that match exact value "Windows Remote Desktop"

openPorts:(description: `Windows Remote Desktop`)

openPorts:(detectedServiceopenPorts:(detectedService

Use values within quotes or backticks to help you find the detected service you're looking for.

Examples

Show any findings with this service name

openPorts:(detectedService: win_remote_desktop)

Show any findings that contain parts of name

openPorts:(detectedService: "win_remote_desktop")

Show any findings that match exact value "win_remote_desktop"

openPorts:(detectedService: `win_remote_desktop`)

openPorts:(firstFoundopenPorts:(firstFound

Use a date range or specific date to define when open ports were first found.

Examples

Show open ports found within certain dates

openPorts:(firstFound: [2019-01-01 ... 2019-01-15])

Show open ports found starting 2019-01-15, ending 3 months ago

openPorts:(firstFound: [2019-01-15 ... now-3M])

Show open ports found starting 2 weeks ago, ending 1 second ago

openPorts:(firstFound: [now-2w ... now-1s])

Show open ports found on a specific date

openPorts:(firstFound:'2019-03-18')

openPorts:(lastUpdatedopenPorts:(lastUpdated

Use a date range or specific date to define when open ports were last updated.

Examples

Show open ports last updated within certain dates

openPorts:(lastUpdated:[2019-01-01 ... 2019-01-15])

Show open ports last updated starting 2019-01-15, ending 1 month ago

openPorts:(lastUpdated:[2019-01-15 ... now-1M])

Show open ports last updated starting 2 weeks ago, ending 1 second ago

openPorts:(lastUpdated:[now-2w ... now-1s])

Show open ports last updated on a specific date

openPorts:(lastUpdated:'2019-03-18')

openPorts:(portopenPorts:(port

Use an integer value ##### to help you find assets with some open port.

Example

Show assets with open port 80

openPorts:(port:80)

openPorts:(protocolopenPorts:(protocol

Use a text value ##### (UDP or TCP) to define the port protocol you're interested in.

Examples

Show findings found on TCP

openPorts:(protocol: TCP)

Show findings found on port 80 and TCP

openPorts:(port: 80 AND protocol: TCP)

openPorts:(detectionScoreopenPorts:(detectionScore

Filter the open ports based on the QDS score.

Examples

Show open ports based on the following QDS score

openPorts:(detectionScore: 80)

Show open ports based on the following QDS score

openPorts:(detectionScore>80)

Show open ports based on the following QDS score

openPorts:(detectionScore<80)

Show open ports based on the following QDS score

openPorts:(detectionScore>=80)

openPorts:(authorizationopenPorts:(authorization

Use the values Authorized, Unauthorized, or Needs Review to filter the ports.

Example

Show open ports that are marked Authorized

openPorts:(authorization: "Authorized")

operatingSystemoperatingSystem

Use values within quotes or backticks to help you find the full operating system name you're looking for.

Examples

Show any findings that contain components of OS name

operatingSystem:"Windows 7 SP2 Enterprise"

Show any findings that match exact value

operatingSystem:`Windows 7 SP2 Enterprise`

operatingSystem.architectureoperatingSystem.architecture

Use text value ##### to help you find the operating system architecture you're looking for, i.e. 32-Bit or 64-Bit.

Example

Show any findings that match exact value

operatingSystem.architecture:64-Bit

operatingSystem.categoryoperatingSystem.category

Use text value ##### to help you find the full operating system category name you're looking for, i.e. Windows, Unix, Linux, Mac and more.

Example

Show any findings that match exact value

operatingSystem.category:Windows/Embedded

operatingSystem.category1operatingSystem.category1

Use text value ##### to help you find the operating system category 1 value you're looking for.

Example

Show any findings that match exact value

If you are searching for assets with Windows Embedded operating system, then category1 is Windows and category2 is Embedded.

operatingSystem.category1:Windows

operatingSystem.category2operatingSystem.category2

Use values within quotes or backticks to help you find the operating system category 1 value you're looking for.

Example

If you are searching for assets with Windows Embedded operating system, then category1 is Windows and category2 is Embedded.

Show any findings that match exact value

operatingSystem.category2:Embedded

operatingSystem.editionoperatingSystem.edition

Use text value ##### to help you find the operating system edition you're looking for.

Example

Show any findings that match exact value

operatingSystem.edition:Enterprise

operatingSystem.installDateoperatingSystem.installDate

Use a date range or specific date to define an operating system install date of interest.

Examples

Show findings with operating system install date in this date range

operatingSystem.installDate:[2019-01-01 ... 2019-01-15]

Show findings with operating system install date starting 2019-01-15, ending 1 month ago

operatingSystem.installDate:[2019-01-15 ... now-1M]

Show findings with operating system install date starting 2 weeks ago, ending 1 second ago

operatingSystem.installDate:[now-2w ... now-1s]

Show findings with this operating system install date

operatingSystem.installDate:'2019-03-18'

operatingSystem.lifecycle.gaoperatingSystem.lifecycle.ga

Use a date range or specific date to define an OS general availability date of interest.

Examples

Show findings with OS GA date in this date range

operatingSystem.lifecycle.ga:[2019-01-01 ... 2019-01-15]

Show findings with OS GA date starting 2019-01-15, ending 1 month ago

operatingSystem.lifecycle.ga:[2019-01-15 ... now-1M]

Show findings with OS GA date starting 2 weeks ago, ending 1 second ago

operatingSystem.lifecycle.ga:[now-2w ... now-1s]

Show findings with this OS GA date

operatingSystem.lifecycle.ga:'2019-03-18'

operatingSystem.lifecycle.eoloperatingSystem.lifecycle.eol

Use a date range or specific date to define an operating system End-of-Life date of interest.

Examples

Show findings with operating system End-of-Life date in this date range

operatingSystem.lifecycle.eol:[2019-01-01 ... 2019-01-15]

Show findings with operating system End-of-Life date starting 2019-01-15, ending 1 month ago

operatingSystem.lifecycle.eol:[2019-01-15 ... now-1M]

Show findings with operating system End-of-Life date starting 2 weeks ago, ending 1 second ago

operatingSystem.lifecycle.eol:[now-2w ... now-1s]

Show findings with this operating system End-of-Life date

operatingSystem.lifecycle.eol:'2019-03-18'

operatingSystem.lifecycle.eosoperatingSystem.lifecycle.eos

Use a date range or specific date to define an operating system End-of-Support date of interest.

Examples

Show findings with operating system End-of-Support date in this date range

operatingSystem.lifecycle.eos:[2019-01-01 ... 2019-01-15]

Show findings with operating system End-of-Support date starting 2019-01-15, ending 1 month ago

operatingSystem.lifecycle.eos:[2019-01-15 ... now-1M]

Show findings with operating system End-of-Support date starting 2 weeks ago, ending 1 second ago

operatingSystem.lifecycle.eos:[now-2w ... now-1s]

Show findings with this operating system End-of-Support date

operatingSystem.lifecycle.eos:'2019-03-18'

operatingSystem.lifecycle.stageoperatingSystem.lifecycle.stage

Use a text value ##### to define an OS lifecycle stage you're looking for, i.e. active, eol, obsolete.

Examples

Show findings having this OS lifecycle stage

operatingSystem.lifecycle.stage:eol

Show findings with OS category Windows and OS lifecycle stage "active"

operatingSystem:(category:Windows AND lifecycle.stage:eol)

operatingSystem.marketVersionoperatingSystem.marketVersion

Use text value ##### to help you find the operating system market version, e.g. Windows OS.

Example

Show any findings that match exact value

operatingSystem.marketVersion:7

operatingSystem.nameoperatingSystem.name

Use text value ##### to help you find the operating system brand name you're looking for, e.g. Windows OS.

Example

Show any findings that match exact value

operatingSystem.name:Windows 10

operatingSystem.publisheroperatingSystem.publisher

Use a text value ##### to define an operating system manufacturer you're looking for.

Example

Show findings with this exact software publisher

operatingSystem.publisher:Microsoft

operatingSystem.updateoperatingSystem.update

Use a text value ##### to define an OS update version of interest.

Example

Show findings with this exact OS update version

operatingSystem.update:SP2

operatingSystem.versionoperatingSystem.version

Use a text value ##### to define the OS version you're interested in.

Example

Show findings with this exact OS version

operatingSystem.version:16.1

processorsprocessors

Use values within quotes or backticks to help you find the full processor name you're looking for.

Examples

Show any findings that contain parts of name

processors:"iIntel Xwon® CPU ES-2673 v3"

Show any findings that match exact value

processors:`Intel Xwon® CPU ES-2673 v3`

processors.coresPerSocketprocessors.coresPerSocket

Use the value to show the number of cores per socket.

Example

Show the number of cores per socket

processors.coresPerSocket:2

processors.multithreadingStatus processors.multithreadingStatus

Use the values ENABLED | DISABLED to define whether your processor is multi-threading enabled.

Example

Show multi-threading enabled processor

processors.multithreadingStatus: "ENABLED"

processors.numberOfCpuprocessors.numberOfCpu

Use the value to show the number of logical CPUs.

Example

Show the logical CPUs

processors.numberOfCpu:4

processors.numberOfSockets processors.numberOfSockets

Use the value to show the number of sockets.

Example

Show number of sockets

processors.numberOfSockets:2

processors.speedprocessors.speed

Use an integer value ##### to help you find assets with a certain processor speed (MHz).

Example

Show assets with this processor speed

processors.speed:2394

processors.threadsPerCoreprocessors.threadsPerCore

Use the value to show the number of threads per core.

Example

Show number of threads per core

processors.threadsPerCore:1

providerprovider

Find assets synced from a certain cloud provider (AWS, AZURE, GCP). Select from names in the drop-down menu.

Examples

Show assets synced from Amazon AWS

provider: "AWS"

sensors.activatedForModulessensors.activatedForModules

Select the name ##### of an activated module you're interested in. Select CERT, EDR, FIM, OCA, PC, PM, SCA, SwCA, VM, WAF, WAS, or XDR from the drop-down menu.

Examples

Show sensors activated for VM

sensors.activatedForModules: "VM"

Show sensors activated for VM and PC

sensors.activatedForModules: "VM" AND sensors.activatedForModules: "PC"

sensors.lastFullScansensors.lastFullScan

Use a date range or specific date to define when last full scan was performed.

Examples

Show last full scan within certain dates

sensors.lastFullScan:[2019-01-01 ... 2019-01-15]

Show last full scan starting 2019-01-15, ending 1 month ago

sensors.lastFullScan:[2019-01-15 ... now-1M]

Show last full scan starting 2 weeks ago, ending 1 second ago

sensors.lastFullScan:[now-2w ... now-1s]

Show last full scan on a specific date

sensors.lastFullScan:'2019-03-18'

agent.errorStatusagent.errorStatus

Use the values true | false to define agents with or without error status.

Example

Show agents with error status

agent.errorStatus: "true"

sensors.lastComplianceScansensors.lastComplianceScan

Use a date range or specific date to define when last compliance scan was performed.

Examples

Show last compliance scan within certain dates

sensors.lastComplianceScan:[2019-01-01 ... 2019-01-15]

Show last compliance scan starting 2019-01-15, ending 1 month ago

sensors.lastComplianceScan:[2019-01-15 ... now-1M]

Show last compliance scan starting 2 weeks ago, ending 1 second ago

sensors.lastComplianceScan:[now-2w ... now-1s]

Show last compliance scan on a specific date

sensors.lastComplianceScan:'2019-03-18'

sensors.lastVmScansensors.lastVmScan

Use a date range or specific date to define when last VM scan was performed.

Examples

Show last VM scan within certain dates

sensors.lastVmScan:[2019-01-01 ... 2019-01-15]

Show last VM scan starting 2019-01-15, ending 1 month ago

sensors.lastVmScan:[2019-01-15 ... now-1M]

Show last VM scan starting 2 weeks ago, ending 1 second ago

sensors.lastVmScan:[now-2w ... now-1s]

Show last VM scan on a specific date

sensors.lastVmScan:'2019-03-18'

sensors.lastVmScanDateScannersensors.lastVmScanDateScanner

Use a date range or specific date to define when last VM scan was performed by scanner.

Examples

Show last VM scan within certain dates

sensors.lastVmScanDateScanner:[2019-01-01 ... 2019-01-15]

Show last VM scan starting 2019-01-15, ending 1 month ago

sensors.lastVmScanDateScanner:[2019-01-15 ... now-1M]

Show last VM scan starting 2 weeks ago, ending 1 second ago

sensors.lastVmScanDateScanner:[now-2w ... now-1s]

Show last VM scan on a specific date

sensors.lastVmScanDateScanner:'2019-03-18'

sensors.lastVmScanDateAgentsensors.lastVmScanDateAgent

Use a date range or specific date to define when last VM scan was performed by agent.

Examples

Show last VM scan within certain dates

sensors.lastVmScanDateAgent:[2019-01-01 ... 2019-01-15]

Show last VM scan starting 2019-01-15, ending 1 month ago

sensors.lastVmScanDateAgent:[2019-01-15 ... now-1M]

Show last VM scan starting 2 weeks ago, ending 1 second ago

sensors.lastVmScanDateAgent:[now-2w ... now-1s]

Show last VM scan on a specific date

sensors.lastVmScanDateAgent:'2019-03-18'

sensors.lastPcScanDateScannersensors.lastPcScanDateScanner

Use a date range or specific date to define when last PC scan was performed by scanner.

Examples

Show last PC scan within certain dates

sensors.lastPcScanDateScanner:[2019-01-01 ... 2019-01-15]

Show last PC scan starting 2019-01-15, ending 1 month ago

sensors.lastPcScanDateScanner:[2019-01-15 ... now-1M]

Show last PC scan starting 2 weeks ago, ending 1 second ago

sensors.lastPcScanDateScanner:[now-2w ... now-1s]

Show last PC scan on a specific date

sensors.lastPcScanDateScanner:'2019-03-18'

sensors.lastPcScanDateAgentsensors.lastPcScanDateAgent

Use a date range or specific date to define when last PC scan was performed by agent.

Examples

Show last PC scan within certain dates

sensors.lastPcScanDateAgent:[2019-01-01 ... 2019-01-15]

Show last PC scan starting 2019-01-15, ending 1 month ago

sensors.lastPcScanDateAgent:[2019-01-15 ... now-1M]

Show last PC scan starting 2 weeks ago, ending 1 second ago

sensors.lastPcScanDateAgent:[now-2w ... now-1s]

Show last PC scan on a specific date

sensors.lastPcScanDateAgent:'2019-03-18'

sensors.pendingActivationForModulessensors.pendingActivationForModules

Select the name ##### of a module that's pending activation. Select from names in the drop-down menu.

Examples

Show sensors pending activation for VM

sensors.pendingActivationForModules: "VM"

Show sensors pending activation for VM and FIM

sensors.pendingActivationForModules: "VM" AND sensors.pendingActivationForModules: "FIM"

services.descriptionservices.description

Use values within quotes or backticks to help you find assets with a service description you're looking for.

Examples

Show any findings that contain parts of description

services:(description:"Certificate Propagation")

Show any findings that match exact value "Windows Event Log"

services:(description:`Certificate Propagation`)

services.nameservices.name

Use text value ##### within values to help you find assets with a service name you're looking for.

Example

Show any findings that match exact value

services:(name:CertPropSvc)

services.statusservices.status

Use text value ##### within values to help you find the service status you're looking for.

Example

Show any findings that match exact value

services:(status:RUNNING)

software:(architecturesoftware:(architecture

Use text value ##### to help you find the software architecture you're looking for, i.e 32-Bit or 64-Bit.

Example

Show any findings that match exact value

software:(architecture:64-Bit)

software:(categorysoftware:(category

Use values within quotes or backticks to help you find a software category.

Example

Show any findings that match exact value

software:(category:`Application Development/Testing`)

software:(isRequiredsoftware:(isRequired

Use the values true | false to define whether software is a required.

Example

Show software that is required

software:(isRequired: "true")

asset.hasMissingSoftwareasset.hasMissingSoftware

Use the values true | false to define whether asset has a missing software.

Example

Show asset that has a missing software

asset.hasMissingSoftware: "true"

missingSoftware.category1missingSoftware.category1

Use text value ##### to help you find the missing software category 1 value you're looking for.

Example

If you are searching for assets missing testing software, then category1 is Application Development and category2 is Testing.

Show any findings that match exact value

missingSoftware.category1:Application Development

missingSoftware.category2missingSoftware.category2

Example

If you are searching for assets missing testing software, then category1 is Application Development and category2 is Testing.

Show any findings that match exact value

missingSoftware.category2:Testing

missingSoftware.publishermissingSoftware.publisher

Use a text value ##### to find a software without publisher.

Example

Show findings without this software publisher

missingSoftware.publisher:Microsoft

missingSoftware.productmissingSoftware.product

Use a text value ##### to find a software without product name.

Example

Show findings with this exact product name

missingSoftware.product:Office

missingSoftware.namemissingSoftware.name

Use values within quotes or backticks to help you find the missing software name you're looking for. Quotes can be used when the value has more than one word.

Examples

Show any findings with this name

missingSoftware.name: VMware Tools

Show any findings that contain parts of name

missingSoftware.name: "VMware Tools"

Show any findings that match exact value

missingSoftware.name: `VMware Tools`

Find assets with certain tag and missing software

tags.name: `Cloud Agent` AND missingSoftware.name: `Cisco AnyConnect Secure Mobility Client` AND version: `3.1.12345`

software:(category1software:(category1

Use text value ##### to help you find the software category 1 value you're looking for.

Example

If you are searching for assets having testing software, then category1 is Application Development and category2 is Testing.

Show any findings that match exact value

software:(category1:Application Development)

software:(category2software:(category2

Use text value ##### to help you find the software category 2 value you're looking for.

Example

If you are searching for assets having testing software, then category1 is Application Development and category2 is Testing.

Show any findings that match exact value

software:(category2:Testing)

software:(editionsoftware:(edition

Use text value ##### to help you find the software edition you're looking for.

Example

Show any findings that match exact value

software:(edition:Professional)

software:(installDatesoftware:(installDate

Use a date range or specific date to define when software was installed.

Examples

Show software installed within certain dates

software:(installDate:[2019-01-01 ... 2019-01-15])

Show software installed starting 2019-01-15, ending 1 month ago

software:(installDate:[2019-01-15 ... now-1M])

Show software installed starting 2 weeks ago, ending 1 second ago

software:(installDate:[now-2w ... now-1s])

Show software installed on a specific date

software:(installDate:'2019-03-18')

software.installPathsoftware.installPath

Use a text value ##### to define a software install path you're looking for.

Example

Show findings with this exact software install path

software:(installPath:C:\Program Files\)

software:(isPackagesoftware:(isPackage

Use the values true | false to define whether software is a package.

Example

Show software that is a package

software:(isPackage: "true")

software:(isPCSupportedsoftware:(isPCSupported

Use the values true | false to define whether software is PC supported.

Example

Show software that is PC supported

software:(isPCSupported: "true")

software:(hasRunningInstancesoftware:(hasRunningInstance

Use the values true | false to find whether software has a running instance.

Example

Show software that has a running instance

software:(hasRunningInstance: "true")

software:(isPackageComponentsoftware:(isPackageComponent

Use the values true | false to define whether software is a package component.

Example

Show software that is a package component

software:(isPackageComponent: "true")

software:(lastUpdatedsoftware:(lastUpdated

Use a date range or specific date to define when a software was last updated.

Examples

Show software last updated within certain dates

software:(lastUpdated:[2019-01-01 ... 2019-01-15])

Show software last updated starting 2019-01-15, ending 1 month ago

software:(lastUpdated:[2019-01-15 ... now-1M])

Show software last updated starting 2 weeks ago, ending 1 second ago

software:(lastUpdated:[now-2w ... now-1s])

Show software last updated on a specific date

software:(lastUpdated:'2019-03-18')

software:(lastUseDatesoftware:(lastUseDate

Use a date range or specific date to define when a software was last used.

Note: This token is not supported for windows assets.

Examples

Show software last used within certain dates

software:(lastUseDate:[2019-01-01 ... 2019-01-15])

Show software last used starting 2019-01-15, ending 1 month ago

software:(lastUseDate:[2019-01-15 ... now-1M])

Show software last used starting 2 weeks ago, ending 1 second ago

software:(lastUseDate:[now-2w ... now-1s])

Show software last used on a specific date

software:(lastUseDate:'2019-03-18')

software:(license.categorysoftware:(license.category

Use text value ##### to help you find a software license category, i.e. Open Source, Commercial.

Example

Show any findings that match exact value

software:(license.category:`Open Source`)

software:(license.subcategorysoftware:(license.subcategory

Use text value ##### to help you find a software license subcategory, i.e. GPL, Apache 2.0, BSD.

Example

Show any findings that match exact value

software:(license.subcategory:Apache 2.0)

software:(lifecycle.gasoftware:(lifecycle.ga

Use a date range or specific date to define a software general availability date of interest.

Examples

Show findings with software GA date in this date range

software:(lifecycle.ga:[2019-01-01 ... 2019-01-15])

Show findings with woftware GA date starting 2019-01-15, ending 1 month ago

software:(lifecycle.ga:[2019-01-15 ... now-1M])

Show findings with software GA date starting 2 weeks ago, ending 1 second ago

software:(lifecycle.ga:[now-2w ... now-1s])

Show findings with this software GA date

software:(lifecycle.ga:'2019-03-18')

software:(lifecycle.eolsoftware:(lifecycle.eol

Use a date range or specific date to define an software End-of-Life date of interest.

Examples

Show findings with software End-of-Life date in this date range

software:(lifecycle.eol:[2019-01-01 ... 2019-01-15])

Show findings with software End-of-Life date starting 2019-01-15, ending 1 month ago

software:(lifecycle.eol:[2019-01-15 ... now-1M])

Show findings with software End-of-Life date starting 2 weeks ago, ending 1 second ago

software:(lifecycle.eol:[now-2w ... now-1s])

Show findings with this software End-of-Life date

software:(lifecycle.eol:'2019-03-18')

software:(lifecycle.eossoftware:(lifecycle.eos

Use a date range or specific date to define an software End-of-Support date of interest.

Examples

Show findings with software End-of-Support date in this date range

software:(lifecycle.eos:[2019-01-01 ... 2019-01-15])

Show findings with software End-of-Support date starting 2019-01-15, ending 1 month ago

software:(lifecycle.eos:[2019-01-15 ... now-1M])

Show findings with software End-of-Support date starting 2 weeks ago, ending 1 second ago

software:(lifecycle.eos:[now-2w ... now-1s])

Show findings with this software End-of-Support date

software:(lifecycle.eos:'2019-03-18')

software:(lifecycle.stagesoftware:(lifecycle.stage

Use a text value ##### to define a software lifecycle stage you're looking for, i.e. active, eol, obsolete.

Examples

Show findings having this software lifecycle stage

software:(lifecycle.stage:eol)

Show findings having software category Windows and software lifecycle stage "active"

software:(category:Windows AND lifecycle.stage:eol)

software:(marketVersionsoftware:(marketVersion

Use text value ##### to help you find a software market version, e.g. Windows OS.

Example

Show any findings that match exact value

software:(marketVersion:7)

software:(namesoftware:(name

Use values within quotes or backticks to help you find the software name you're looking for. Quotes can be used when the value has more than one word.

Examples

Show any findings with this name

software:(name: VMware Tools)

Show any findings that contain parts of name

software:(name: "VMware Tools")

Show any findings that match exact value

software:(name: `VMware Tools`)

Find assets with certain tag and software installed

tags.name: `Cloud Agent` AND software: (name: `Cisco AnyConnect Secure Mobility Client` AND version: `3.1.12345`)

software:(productsoftware:(product

Use a text value ##### to define a software product name you're looking for.

Example

Show findings with this exact product name

software:(product:Office)

software:(authorizationsoftware:(authorization

Use text value ##### to help you find the installations of the software product with authorization you're looking for, i.e. Authorized, Unauthorized, or Needs Review.

Example

Show installations of the software that was marked as Authorized.

software:(authorization:`Authorized`)

Show installations of the software that was marked as Unauthorized.

software:(authorization:`Unauthorized`)

Show installations of the software that needs review.

software:(authorization:`Needs Review`)

software:(publishersoftware:(publisher

Use a text value ##### to define a software manufacturer you're looking for.

Example

Show findings with this exact software publisher

software:(publisher:Microsoft)

software:(supportStagesoftware:(supportStage

Use a text value ##### to define the software support stage.

Example

Show software having premium support

software:(supportStage: Premier Support)

software:(authorizationDetectionScoresoftware:(authorizationDetectionScore

Use a text value ##### to find the installations of the software product with the QDS you're looking for.

Example

Show the installations of the software product with the following QDS

software:(authorizationDetectionScore: 30)

software:(lifecycle.detectionScoresoftware:(lifecycle.detectionScore

Use a text value ##### to find the software product with the lifecycle detection score you are looking for

Examples

Show the software product with the lifecycle detection score

software:(lifecycle.detectionScore: 80)

Show the software product with the lifecycle detection score

software:(lifecycle.detectionScore>80)

Show the software product with the lifecycle detection score

software:(lifecycle.detectionScore<80)

Show the software product with the lifecycle detection score

software:(lifecycle.detectionScore<=80)

Show the software product with the lifecycle detection score

software:(lifecycle.detectionScore>=80)

software.typesoftware.type

Use a text value ##### to define a software type of interest.

Example

Show findings having this software type

software:(type:Installer Package)

software:(updatesoftware:(update

Use a text value ##### to define a software update version of interest.

Example

Show findings with this exact software update version

software:(update:16.0.1.2)

Show findings with software update version greater than 16.0.1.2

software:(update>16.0.1.2)

Show findings with software update version greater than or equal to 16.0.1.2

software:(update>=16.0.1.2)

Show findings with software update version less than 16.0.1.2

software:(update<16.0.1.2)

Show findings with software update version less than or equal to 16.0.1.2

software:(update<=16.0.1.2)

Show findings with software update version within this version range

software:(update:[16.0.1.2 ... 16.0.1.5])

software:(versionsoftware:(version

Use a text value ##### to define the software version you're interested in.

Example

Show findings with this exact software version

software:(version:16.0)

Show findings with software version greater than 16.0

software:(version>16.0)

Show findings with software version greater than or equal to 16.0

software:(version>=16.0)

Show findings with software version less than 16.0

software:(version<16.0)

Show findings with software version less than or equal to 16.0

software:(version<=16.0)

Show findings with software version within this version range

software:(version:[16.0 ... 20.0])

software:(componentsoftware:(component

Use a value Client, Server or " " (empty field) to identify the software component.

Example

Show findings with Client software component

software:(component:Client)

software:(firstFoundsoftware:(firstFound

Use a date range or specific date to define when software was first found.

Examples

Show assets with software first found within certain dates

software:(firstFound: [2017-06-15 ... 2017-06-30])

Show assets with software first found starting 2017-06-22, ending 1 month ago

software:(firstFound: [2017-06-22 ... now-1M])

Show assets with software first found starting 2 weeks ago, ending 1 second ago

software:(firstFound: [now-2w ... now-1s])

Show assets with software first found on specific date

software:(firstFound:'2017-06-14')

tags.businessImpacttags.businessImpact

Find assets with certain business impact (HIGH, MINOR, LOW, MEDIUM, CRITICAL). Select from tag values in the drop-down menu.

Example

Find assets with high business impact

tags.businessImpact: HIGH

tags.nametags.name

Use values within quotes or backticks to help you find the asset tag you're looking for.

Examples

Show any findings that contain "network" and "blue" in name

tags.name: "network blue"

Show any findings that contain "network" or "blue" in name (another method)

tags.name: "network" OR tags.name: blue"

Show any findings that match exact value "Cloud Agent"

tags.name: `Cloud Agent`

volumes.freevolumes.free

Use an integer value ##### to help you find assets with a certain free volume space (GB).

Examples

Show findings with free volume space greater than 90 GB

volumes:(free>90)

Show findings with free volume space greater than or equal to 90 GB

volumes:(free>=90)

Show findings with free volume space less than 30 GB

volumes:(free<30)

Show findings with free volume space less than or equal to 30 GB

volumes:(free<=30)

volumes.namevolumes.name

Use an integer value ##### to help you find assets with a certain volume name.

Example

Show findings with this volume name

volumes:(name:D:)

volumes.sizevolumes.size

Use an integer value ##### to help you find assets with a certain volume size (GB).

Example

Show findings with volume size greater than 90 GB

volumes:(size>90)

Show findings with volume size greater than or equal to 90 GB

volumes:(size>=90)

Show findings with volume size less than 30 GB

volumes:(size<30)

Show findings with volume size less than or equal to 30 GB

volume:(size<=30)

gcp.labels.namegcp.labels.name

Use a text value ##### to find VM instances with a certain GCP labels name (case insensitive).

Examples

Find VM instances with key "department"

gcp.labels:(name: department)

Find VM instances that match exact key value "department"

gcp.labels:(name: 'department')

Find VM instances with key starting "dep"

gcp.labels:(name: dep*)

gcp.labels.valuegcp.labels.value

Use a text value ##### to find VM instances with a certain GCP labels value (case insensitive).

Examples

Find VM instances with tag value "product-management"

gcp.labels:(value: product-management)

Find VM instances that match exact key value "product-management"

gcp.labels:(value: 'product-management')

Find VM instances with tag value starting "product"

gcp.labels:(value: product*)

asset.org.nameasset.org.name

Use values within quotes or backticks to help you find the assets with the organization name you're looking for.

Note: The same token is used to find the certificates for assets with the specified org name, but the token syntax is different. See all token examples.

Examples

Show assets details that match the exact value of the organization name

asset.org.name: `Qualys, Inc.`

Show assets details that contain parts of the organization name

asset.org.name: "Qualys,"

Find tcertificates for assets with the specified org name

Examples for Certificate Token

Show assets details that match the exact value of the organization name

asset:(org.name: `Qualys, Inc.`)

Show assets details that contain parts of the organization name

asset:(org.name: "Qualys,")

asset.ispasset.isp

Use values within quotes or backticks to help you find the assets with the Internet Service Provider (ISP) name you're looking for.

Note: The same token is used to find the certificates for assets with the specified ISP, but the token syntax is different. See all token examples.

Examples

Show assets that match the exact ISP name

asset.isp: `amazon.com, Inc.`

Show assets that are with the parts of the ISP name

asset.isp: "amazon.com,"

Find the certificates for assets with the specified ISP

Examples for Certificate Token

Show certificates that match the exact ISP name

asset:(isp: `amazon.com, Inc.`)

Show certificates that are with the parts of the ISP name

asset:(isp: "amazon.com,")

asset.asnasset.asn

Use values within quotes or backticks to help you find the assets with the ASN value you're looking for.

Examples

Show assets that match the exact value of ASN

asset.asn: `AS8075`

Show assets that are with the parts of the ASN

asset.asn: "AS807"

asset.domainasset.domain

Use values within quotes or backticks to help you find the assets with their domain.

Note: The same token is used to find the certificates for assets with the specified domain, but the token syntax is different. See all token examples.

Examples

Show assets that match the exact value of the domain

asset.domain: `qualys.com`

Show assets that contain parts of the domain

asset.domain: "qualys."

Find the certificates for assets with the specified domain

Examples for Certificate Token

Show certificates for assets that match the exact value of the domain

asset:(domain: `qualys.com`)

Show certificates for assets that contain parts of the domain

asset:(domain: "qualys.")

asset.subdomainasset.subdomain

Use values within quotes or backticks to help you find assets using their subdomains.

Note: The same token is used to find the certificates for assets with the specified subdomain, but the token syntax is different. See all token examples.

Examples

Show assets that match the exact value of the subdomains

asset.subdomain: `doc.qualys.com`

Show assets that contain the parts of the subdomains

asset.subdomain: "doc.qualys."

Find certificates that match the exact value of the subdomains

asset:(subdomain: `doc.qualys.com`)

Find certificates that contain the parts of the subdomains

asset:(subdomain: "doc.qualys.")

whoIs.creationDatewhoIs.creationDate

Use a date range or specific date to find all the assets with the whoIs creation date.

Examples

Show assets with whoIs creation date within certain dates

whoIs:(creationDate: [2019-01-01 ... 2019-01-15])

Show assets with whoIs creation date starting 2019-01-15, ending 1 month ago

whoIs:(creationDate: [2019-01-15 ... now-1M])

Show assets with whoIs creation date starting 2 weeks ago, ending 1-second ago

whoIs:(creationDate: [now-2w ... now-1s])

Show assets with whoIs creation date last updated on a specific date

whoIs:(creationDate: `2022-06-04`)

whoIs.registrantOrgwhoIs.registrantOrg

Use values within quotes or backticks to find all the assets using the registrant organization of domain or subdomain.

Examples

Show all the assets for which the exact registrant organization of domain/subdomain matches

whoIs:(registrantOrg: `Qualys, Inc`)

Show all the assets for which the part of the registrant organization of domain/subdomain matches

whoIs:(registrantOrg: "Qualys,")

whoIs.registrantEmailIdwhoIs.registrantEmailId

Use values within quotes or backticks to find all the assets using the registrant email id of domain or subdomain.

Examples

Show all the assets for which the exact registrant email id of the domain or subdomain matches

whoIs:(registrantEmailId: `66aab8e6ace-49101@contact.qualys.net`)

Show all the assets for which the part of the registrant email id of the domain or subdomain matches

whoIs:(registrantEmailId: "66aab8e6ace-49101@contact.qualys.net")

whoIs.registrarwhoIs.registrar

Use values within quotes or backticks to find all the assets using the registrar.

Examples

Show all the assets for which the exact registrar matches

whoIs:(registrar: `abc net`)

Show all assets for which the part of the registrar matches

whoIs:(registrar: "abc net")

agent.statusagent.status

Select the agent status (ACTIVE or INACTIVE) you're interested in.

Example

Show assets with active agents

agent.status: ACTIVE

agent.platformagent.platform

Use a text value ##### to find assets on Windows or Linux platforms.

Example

Show assets on windows platform

agent.platform: Windows

sensors.firstEasmScanDatesensors.firstEasmScanDate

Shows a list of externally exposed assets based on their first scan date.

Example

Show a list of externally exposed assets scanned for the first time on or after 2022-10-04

sensors.firstEasmScanDate >= '2022-10-04'

Show a list of externally exposed assets that are scanned for the first time before 2022-10-04

sensors.firstEasmScanDate <= '2022-10-04'

Show a list of externally exposed assets that are scanned for the first time after 2022-10-04

sensors.firstEasmScanDate > '2022-10-04'

Show a list of externally exposed assets that are scanned for the first time on 2022-10-04

sensors.firstEasmScanDate = '2022-10-04'

sensors.lastEasmScanDatesensors.lastEasmScanDate

Shows a list of externally exposed assets based on their latest scan date.

Example

Show a list of externally exposed assets from the latest scan on or after 2022-10-04

sensors.lastEasmScanDate >= '2022-10-04'

Show a list of externally exposed assets from the latest scan before 2022-10-04

sensors.lastEasmScanDate <= '2022-10-04'

Show a list of externally exposed assets from the latest scan after 2022-10-04

sensors.lastEasmScanDate > '2022-10-04'

Show a list of externally exposed assets from the latest scan on 2022-10-04

sensors.lastEasmScanDate = '2022-10-04'

ruleNameruleName

Use a text value ##### to find the asset identification rules by providing the exact rule name or a fragment of the rule name.

Note: This token is for the "Third-Party Asset Import" which is a new feature in the Beta phase. It's in the early stage and only available on a request basis. Contact your Technical Account Manager (TAM) for more information.

Examples

Show findings that include the following content part in the rule name

ruleName:"IP and Mac"

Show findings with the exact rule name

ruleName:`IP and Mac Rule`

identificationAttributeidentificationAttribute

Select one of the attributes to find asset identification rules created by using that attribute. The supported attributes are FQDN, Hardware UUID, Hostname, IP Address, Instance UUID, MAC Address, Netbios, and Serial Number.

Note: This token is for the "Third-Party Asset Import" which is a new feature in the Beta phase. It's in the early stage and only available on a request basis. Contact your Technical Account Manager (TAM) for more information.

Example

Show findings with the specified attribute.

identificationAttribute:`Hostname`

agent.isPassiveSensoragent.isPassiveSensor

Select the value to view assets for which the cloud agent acts as a passive sensor. The supported values are true and false.

Select true to view assets for which the cloud agent acts as a passive sensor.

Examples

Show findings to view assets for which the cloud agent acts as a passive sensor.

agent.isPassiveSensor:true

Show findings to view assets for which the cloud agent doesn't act as a passive sensor.

agent.isPassiveSensor:false

openPorts:(discoverySourcesopenPorts:(discoverySources

Use a text value ##### to help you find open ports detected from a certain discovery source. (Active Directory, BMC Helix, CMDB, Cloud Agent, EASM, ICS OCA, IP Scanner, OCA, Passive Sensor, ServiceNow, Unknown, and Webhook) Select from values in the drop-down menu.

Examples

Show findings from cloud agents

openPorts:(discoverySources: Cloud Agent)

Show findings from Passive Sensor

openPorts:(discoverySources: CMDB)

software:(discoverySourcessoftware:(discoverySources

Use a text value ##### to help you find software detected from a certain discovery source. (Active Directory, BMC Helix, CMDB, Cloud Agent, EASM, ICS OCA, IP Scanner, OCA, Passive Sensor, ServiceNow, Unknown, and Webhook) Select from values in the drop-down menu.

Examples

Show findings from cloud agents

software:(discoverySources: Cloud Agent)

Show findings from Passive Sensor

software:(discoverySources: CMDB)

operatingSystem.lifecycle.detectionScoreoperatingSystem.lifecycle.detectionScore

Use a text value ##### to show findings that match the specified operating system lifecycle detection score

Examples

Show findings with the the operating system lifecycle detection score

operatingSystem.lifecycle.detectionScore: 20)

Show findings with the operating system lifecycle detection score

operatingSystem.lifecycle.detectionScore>20)

Show findings with the operating system lifecycle detection score

operatingSystem.lifecycle.detectionScore<20)

Show findings with the operating system lifecycle detection score

operatingSystem.lifecycle.detectionScore>=20)

Show findings with the operating system lifecycle detection score

operatingSystem.lifecycle.detectionScore<=20)

missingSoftware.detectionScoremissingSoftware.detectionScore

Use a text value ##### to show findings that match the missing software detection score

Examples

Show findings with the the missing software detection score

missingSoftware.detectionScore: 50)

Show findings with the missing software detection score

missingSoftware.detectionScore>50)

Show findings with the missing software detection score

missingSoftware.detectionScore<50)

Show findings with the missing software detection score

missingSoftware.detectionScore>=50)

Show findings with the missing software detection score

missingSoftware.detectionScore<=50)

AWS EC2

Use these tokens when searching your AWS EC2 assets on the Assets list.

- Your results may return Terminated instances. It's recommended you include aws.ec2instanceState in your query to reduce the number of results.

- The syntax is different when writing queries for tag rules than when searching assets in the Assets list. Be sure to follow the syntax tips in the drop-down when writing your query.

aws.ec2.accountIdaws.ec2.accountId

Use a text value ##### to find EC2 instances with a certain account ID.

Examples

Find EC2 instances that match this account ID

aws.ec2.accountId: 123456789012

Find EC2 instances with account ID starting "12345"

aws.ec2.accountId: 12345*

Find EC2 instances where account ID is null (remove the colon)

aws.ec2.accountId is null

aws.ec2.availabilityZoneaws.ec2.availabilityZone

Use a text value ##### to find EC2 instances by the availability zone in which the instance launched.

Example

Find EC2 instances in the us-east-1a availability zone

aws.ec2.availabilityZone: us-east-1a

aws.ec2.hasAgentaws.ec2.hasAgent

Use the values true | false to define whether the EC2 asset has a cloud agent.

Examples

Show findings with a cloud agent

aws.ec2.hasAgent: true

Show findings without a cloud agent

aws.ec2.hasAgent: false

aws.ec2.hostnameaws.ec2.hostname

Use a text value ##### to find the EC2 hostname you're looking for.

Examples

Find instances related to name

aws.ec2.hostname: abc.qualys.com

Find instances that match exact value

aws.ec2.hostname: `abc.qualys.com`

aws.ec2.imageIdaws.ec2.imageId

Use a text value ##### to find EC2 instances with a certain Image (AMI) ID.

Examples

Find instances related to the Image ID

aws.ec2.imageId: ami-2ea83347

Find instances that match exact value

aws.ec2.imageId: `ami-2ea83347`

aws.ec2.instanceIdaws.ec2.instanceId

Use a text value ##### to find EC2 instances by the instance ID.

Example

Find EC2 instances with this ID

aws.ec2.instanceId: i-1234567890abcdef0

aws.ec2.instanceStateaws.ec2.instanceState

Select the name of the instance state (PENDING, RUNNING, TERMINATED, STOPPED, STOPPING, SHUTTING-DOWN) you're interested in. Select from names in the drop-down menu.

Example

Find running EC2 instances

aws.ec2.instanceState: RUNNING

aws.ec2.instanceTypeaws.ec2.instanceType

Select the type of instance you're interested in. Select from names in the drop-down menu.

Example

Find EC2 instances with instance type t2.micro

aws.ec2.instanceType: t2.micro

aws.ec2.isQualysScanneraws.ec2.isQualysScanner

Use the values true | false to define whether the EC2 asset is a Qualys scanner.

Examples

Show findings where assets are scanners

aws.ec2.isQualysScanner: true

Show findings where assets are not scanners

aws.ec2.isQualysScanner: false

aws.ec2.kernelIdaws.ec2.kernelId

Use a text value ##### to find EC2 instances by kernel ID (AKI).

Example

Find EC2 instances with this kernel ID

aws.ec2.kernelId: aki-70ab0c10

aws.ec2.launchDateaws.ec2.launchDate

Use a date range or specific date to define when the EC2 instance launched. Enter dates in yyyy-mm-dd format.

Examples

Find EC2 instances launched within certain dates

aws.ec2.launchDate: [2017-06-15 ... 2017-06-30]

Find EC2 instances launched on specific date

aws.ec2.launchDate:'2017-08-15'

aws.ec2.privateDNSaws.ec2.privateDNS

Use a text value ##### to define a private DNS address you're interested in.

Example

Find the EC2 instance with this private DNS address

aws.ec2.privateDNS: ip-10-90-2-85.ec2.internal

aws.ec2.privateIpAddressaws.ec2.privateIpAddress

Use a text value ##### to define a private IPv4 address or range of IPs you're interested in.

Examples

Find EC2 instances with this private IP address

aws.ec2.privateIpAddress: 10.90.0.119

Find EC2 instances within this IP range

aws.ec2.privateIpAddress: [10.1.78.23 ... 10.100.78.235]

aws.ec2.publicDNSaws.ec2.publicDNS

Use a text value ##### to define a public DNS address you're interested in.

Example

Find the EC2 instance with this public DNS address

aws.ec2.publicDNS: ec2-52-70-141-154.compute-1.amazonaws.com

aws.ec2.publicIpAddressaws.ec2.publicIpAddress

Use a text value ##### to define a public IPv4 address or range of IPs you're interested in.

Examples

Find EC2 instances with this public IP address

aws.ec2.publicIpAddress: 52.70.141.154

Find EC2 instances within this IP range

aws.ec2.publicIpAddress: [52.70.141.154 ... 52.70.141.164]

aws.ec2.region.codeaws.ec2.region.code

Select the code of the region you're interested in. Select from codes in the drop-down menu.

Example

Find EC2 instances in the us-east-1 region

aws.ec2.region.code: us-east-1

aws.ec2.region.nameaws.ec2.region.name

Select the name of the region you're interested in. Select from names in the drop-down menu.

Example

Find EC2 instances in the US East (N. Virginia) region

aws.ec2.region.name: US East (N. Virginia)

aws.ec2.spotInstanceaws.ec2.spotInstance

Use the values true | false to define whether your EC2 instance is a Spot instance.

Examples

Show EC2 Spot instances

aws.ec2.spotInstance: "true"

Show EC2 instances that are not Spot instances

aws.ec2.spotInstance: "false"

aws.ec2.subnetIdaws.ec2.subnetId

Use a text value ##### to find EC2 instances by the ID of the subnet in which the interface resides.

Example

Find EC2 instances with this subnet ID

aws.ec2.subnetId: subnet-bc02c0d4

aws.ec2.vpcIdaws.ec2.vpcId

Use a text value ##### to find EC2 instances by the ID of the VPC in which the interface resides.

Example

Find EC2 instances with this VPC ID

aws.ec2.vpcId: vpc-1e37cd76

aws.tags.keyaws.tags.key

Use a text value ##### to find EC2 instances with a certain AWS tag key/name (case insensitive).

Examples

Find EC2 instances with key "devops"

aws.tags(key: devops)

Find EC2 instances with key starting "dev"

aws.tags(key: dev*)

Find EC2 instances with key ending "ops"

aws.tags(key: *ops)

aws.tags.valueaws.tags.value

Use a text value ##### to find EC2 instances with a certain AWS tag value (case insensitive).

Examples

Find EC2 instances with tag value "dailybuild"

aws.tags(value: dailybuild)

Find EC2 instances with tag value starting "daily"

aws.tags(value: daily*)

Find EC2 instances with tag value ending "build"

aws.tags(value: *build)

 

Microsoft Azure

Use these tokens when searching Microsoft Azure assets on the Assets list.

azure.tags.nameazure.tags.name

Use a text value ##### to find Azure instances with a certain tag name (case insensitive).

Examples

Find Azure instances with name "devops"

azure.tags(name: devops)

Find Azure instances with name starting "dev"

azure:tags(name: dev*)

Find Azure instances with name ending "ops"

azure.tags(name: *ops)

azure.tags.valueazure.tags.value

Use a text value ##### to find Azure instances with a certain tag value (case insensitive).

Examples

Find Azure instances with tag value "dailybuild"

azure.tags(value: dailybuild)

Find Azure instances with tag value starting "daily"

azure.tags(value: daily*)

Find Azure instances with tag value ending "build"

azure.tags(value: *build)

azure.vm.imageOfferazure.vm.imageOffer

Use a text value ##### to define the image offer name (i.e. UbuntuServer or WindowsServer) for images deployed from the Azure image gallery.

Examples

Find Azure instances related to name

azure.vm.imageOffer: UbuntuServer

Find Azure instances that match exact value

azure.vm.imageOffer: `UbuntuServer`

azure.vm.imagePublisherazure.vm.imagePublisher

Use a text value ##### to define the name of the Azure virtual machine image publisher (i.e. Canonical or MicrosoftWindowsServer).

Examples

Find Azure instances related to name

azure.vm.imagePublisher: Canonical

Find Azure instances that match exact value

azure.vm.imagePublisher: `Canonical`

azure.vm.imageVersionazure.vm.imageVersion

Use a text value ##### to define the version of the Azure virtual machine image sku you're interested in.

Example

Find Azure instances with this sku version

azure.vm.imageVersion: 16.04.201708030

azure.vm.locationazure.vm.location

Use a text value ##### to define the region you're interested in.

Example

Find Azure instances in this location

azure.vm.location: westus

azure.vm.macAddressazure.vm.macAddress

Use a text value ##### to define the MAC address you're interested in.

Example

Find Azure instances with this MAC address

azure.vm.macAddress: '000D3A36DDED'

azure.vm.nameazure.vm.name

Use a text value ##### to find the Azure virtual machine name you're looking for.

Examples

Find Azure instances related to name

azure.vm.name: avset2

Find Azure instances that match exact value

azure.vm.name: `avset2`

azure.vm.platformazure.vm.platform

Use a text value ##### to define the operating system platform (Linux or Windows) of the Azure virtual machine.

Example

Find Azure instances on Windows platform

azure.vm.platform: Windows

azure.vm.privateIpAddressazure.vm.privateIpAddress

Use a text value ##### to define a private IPv4 address or range of IPs you're interested in.

Examples

Find Azure instances with this private IP

azure.vm.privateIpAddress: 10.1.2.5

Find Azure instances within this IP range

azure.vm.privateIpAddress: [10.1.2.5 ... 10.1.2.33]

azure.vm.publicIpAddressazure.vm.publicIpAddress

Use a text value ##### to define a public IPv4 address or range of IPs you're interested in.

Examples

Find Azure instances with this public IP

azure.vm.publicIpAddress: 13.126.125.189

Find Azure instances within this IP range

azure.vm.publicIpAddress: [13.126.125.180 ... 13.126.125.255]

azure.vm.virtualNetworkazure.vm.virtualNetwork

Use a text value ##### to define the operating system platform (Linux or Windows) of the Azure virtual machine.

Examples

Find Azure instances related to virtual network

azure.vm.virtualNetwork: cli-vnet

Find Azure instances that match exact value of virtual network

azure.vm.virtualNetwork: `cli-vnet`

azure.vm.resourceGroupNameazure.vm.resourceGroupName

Use a text value ##### to define the name of the resource group you're interested in.

Examples

Find Azure instances related to name

azure.vm.resourceGroupName: my-eastus-rg

Find Azure instances that match exact value

azure.vm.resourceGroupName: `my-eastus-rg`

azure.vm.sizeazure.vm.size

Use a text value ##### to help you find Azure VM instances with a certain virtual machine size.

Example

Find Azure instances with this size

azure.vm.size: Standard_D1

azure.vm.stateazure.vm.state

Select the name of the instance state (DEALLOCATED, DEALLOCATING, DELETED, RUNNING, STARTING, STOPPED, STOPPING) you're interested in. Select from names in the drop-down menu.

Example

Find running Azure instances

azure.vm.state: RUNNING

azure.vm.subnetazure.vm.subnet

Use a text value ##### to define the Azure virtual machine subnet you're interested in.

Example

Find Azure instances with this subnet

azure.vm.subnet: 10.1.2.0

azure.vm.subscriptionIdazure.vm.subscriptionId

Use a text value ##### to define the subscription ID of the Azure virtual machine subscription.

Example

Find Azure instances with this subscription ID

azure.vm.subscriptionId: fbb9ea64-abda-452e-adfa-83442409

azure.vm.vmIdazure.vm.vmId

Use a text value ##### to define the Azure virtual machine ID you're looking for.

Example

Find Azure instances with this ID

azure.vm.vmId: 13f56399-bd52-4150-9748-7190aae1ff21

azure.vm.hasAgentazure.vm.hasAgent

Use the values true | false to define whether the Azure virtual machine you're looking for has a cloud agent installed on it.

Example

Find Azure instances with agents

azure.vm.hasAgent: "true"

 

Google Cloud Platform

Use these tokens when searching Google Cloud Platform assets on the Assets list.

gcp.tagsgcp.tags

Use a text value ##### to find GCP instances with a certain tag key and value. Both are case insensitive.

Example

Find GCP instances with a tag key "abc" and value "xyz"

gcp.tags: (key:abc and value:xyz)

gcp.compute.hostnamegcp.compute.hostname

Use a text value ##### to define the hostname you're looking for.

Examples

Find GCP instances related to name

gcp.compute.hostname: instance-5.c.qvsa-dev.internal

Find GCP instances that match exact value

gcp.compute.hostname: `instance-5.c.qvsa-dev.internal`

gcp.compute.imageIdgcp.compute.imageId

Use a text value ##### to define the Google Compute image ID you're looking for.

Examples

Find GCP instances related to the Image ID

gcp.compute.imageId: projects/centos-cloud

Find GCP instances that match exact value

gcp.compute.imageId: `projects/centos-cloud/global/images/centos-6-v20191014`

gcp.compute.instanceIdgcp.compute.instanceId

Use a text value ##### to define the Google Compute instance ID you're looking for.

Example

Find GCP instances with this ID

gcp.compute.instanceId: 4392196237934605253

gcp.compute.macAddressgcp.compute.macAddress

Use a text value ##### to define the MAC address you're interested in.

Example

Find GCP instances with this MAC address

gcp.compute.macAddress: '000D3A36DDED'

gcp.compute.machineTypegcp.compute.machineType

Use a text value ##### to define the machine type of the virtual machine instance you're interested in.

Examples

Find GCP instances related to name

gcp.compute.machineType: n1-standard-1

Find GCP instances that match exact value

gcp.compute.machineType: `n1-standard-1`

gcp.compute.networkgcp.compute.network

Use a text value ##### to find GCP instances by the VPC network the instance belongs to.

Example

Find GCP instances with this network

gcp.compute.network: 000D3A36DDED

gcp.compute.privateIpAddressgcp.compute.privateIpAddress

Use a text value ##### to define a private IPv4 address or range of IPs you're interested in.

Examples

Find GCP instances with this private IP

gcp.compute.privateIpAddress: 10.240.0.7

Find GCP instances with this private IP range

gcp.compute.privateIpAddress: [10.240.0.7 ... 10.240.0.30]

gcp.compute.projectIdgcp.compute.projectId

Use a text value ##### to define the project ID assigned to the GCP Console project the instance belongs to.

Examples

Find GCP instances related to ID

gcp.compute.projectId: qvsa-dev

Find GCP instances that match exact value

gcp.compute.projectId: `qvsa-dev`

gcp.compute.projectNumbergcp.compute.projectNumber

Use an integer value ##### to define the project number assigned to the GCP Console project the instance belongs to.

Examples

Find GCP instances related to this number

gcp.compute.projectNumber: 1035365309337

Find GCP instances that match exact value

gcp.compute.projectNumber: `1035365309337`

gcp.compute.publicIpAddressgcp.compute.publicIpAddress

Use a text value ##### to define a public IPv4 address or range of IPs you're interested in.

Examples

Find GCP instances with this public IP

gcp.compute.publicIpAddress: 104.196.57.216

Find GCP instances within this IP range

gcp.compute.publicIpAddress: [104.196.57.216 ... 104.196.57.218]

gcp.compute.stategcp.compute.state

Type your drop-dowSelect the name of the instance state (PENDING, RUNNING, STOPPED, TERMINATED, STOPPING, SHUTTING_DOWN, DEALLOCATED) you're interested in. Select from names in the drop-down menu.

Example

Find running GCP instances

gcp.compute.state: RUNNING

gcp.compute.zonegcp.compute.zone

Use a text value ##### to define the zone of the GCP instance you're looking for

Examples

Find GCP instances related to name

gcp.compute.zone: us-east1-d

Find GCP instances that match exact value

gcp.compute.zone: `us-east1-d`

gcp.compute.hasAgentgcp.compute.hasAgent

Use the values true | false to define whether the GCP instances you're looking for has a cloud agent installed on it.

Example

Find GCP instances with agents

gcp.compute.hasAgent: "true"

 

Oracle Cloud Infrastructure

Use these tokens when searching Oracle Cloud Infrastructure (OCI) assets on the Assets list.

oci.compute.availabilityDomainoci.compute.availabilityDomain

Use a text value ##### to search all assets with the specified available domain.

Example

Show all assets with the available domain Lhkx:US-ASHBURN-AD-1

oci.compute.availabilityDomain:"Lhkx:US-ASHBURN-AD-1"

oci.compute.canonicalRegionNameoci.compute.canonicalRegionName

Use a text value ##### to search all assets having the specified canonical region name.

Example

Show all assets with the canonical region name us-ashburn-1

oci.compute.canonicalRegionName:"us-ashburn-1"

oci.compute.compartmentIdoci.compute.compartmentId

Use a text value ##### to search all assets with the specified OCI compartment ID.

Example

Show assets with this OCI compartment ID

oci.compute.compartmentId:"ocid1.compartment.oc1..123452sjze35z6bkhvwjtzzgcp534zj4o75tgsizg3q36wl447jvfg6dq"

oci.compute.compartmentNameoci.compute.compartmentName

Use a text value ##### to search all assets with the specified OCI compartment name.

Example

Show assets with this OCI compartment name

oci.compute.compartmentName:"ocid1.compartment.abc"

oci.compute.displayNameoci.compute.displayName

Use a text value ##### to search all assets with the specified display name.

Example

Show assets with display name oracle 8.

oci.compute.displayName:"oracle 8"

oci.compute.faultDomainoci.compute.faultDomain

Use a text value ##### to search all assets with the specified fault domain.

Example

Show all assets with fault domain FAULT-DOMAIN-1

oci.compute.faultDomain:"FAULT-DOMAIN-1"

oci.compute.hasAgentoci.compute.hasAgent

Use the values true | false to list all assets that have cloud agents. Choose True to list all assets having cloud agents and choose False to list all assets that do not have cloud agents.

Example

Show all assets with having cloud agent installed

oci.compute.hasAgent:"true"

oci.compute.hostNameoci.compute.hostName

Use a text value ##### to search all assets with the specified host name.

Example

Show all findings with the host name oracle-8

oci.compute.hostName:"oracle-8"

oci.compute.imageIdoci.compute.imageId

Use a text value ##### to search all assets with the specified image ID.

Example

Show all assets with the  ocid1.image.oc1.iad.aaaaaaaaffp3cnkpfxibzrdkfnxbitkgxk7al33rrhpzhfnrhfv7ml2xdpyq image ID

oci.compute.imageId:"ocid1.image.oc1.iad.aaaaaaaaffp3cnkpfxibzrdkfnxbitkgxk7al33rrhpzhfnrhfv7ml2xdpyq"

oci.compute.isQualysScanneroci.compute.isQualysScanner

Use the values true | false to list all assets that are Qualys Scanner. Choose True to list all assets that are Qualys Scanner and choose False to list all assets that are not Qualys Scanner.

Example

Show all assets that are Qualys Scanner.

oci.compute.isQualysScanner:"true"

oci.compute.ociIdoci.compute.ociId

Use a text value ##### to search all assets with the specified OCI ID.

Example

Show assets with this OCI ID

oci.compute.ociId:"ocid1.compartment.oc1..1234567lbhcx2ajiagh57wrurvqs2ubd4ttaimgy22cxh3r6brpmmugq"

oci.compute.regionoci.compute.region

Use a text value ##### to search all assets in the specified region.

Example

Show all assets with the region us-east-1

oci.compute.region:"us-east-1"

oci.compute.regionKeyoci.compute.regionKey

Use a text value ##### to search all assets with the specified region key.

Example

Show all assets with the region key SYD

oci.compute.regionKey:"SYD"

oci.compute.regionRealmoci.compute.regionRealm

Use a text value ##### to search all groups with the specified region realm.

Example

Show all assets with the region realm OC1

oci.compute.regionRealm:"OC1"

oci.compute.shapeoci.compute.shape

Use a text value ##### to search all assets with the specified shape.

Example

Show all assets with the shape x5-2.36.512

oci.compute.shape:"x5-2.36.512"

oci.compute.stateoci.compute.state

Use a text value ##### to search all assets with specific compute state.

Example

Show all assets with the compute state Starting

oci.compute.state:STARTING

oci.compute.tenantIdoci.compute.tenantId

Use a text value ##### to search all assets with specific tenant ID.

Example

Show all assets with the specific tenant ID

oci.compute.tenantId:"ocid1.tenancy.oc1..aaaaaaaax2gwhq3hszjqhte5pgzijgyge6gvlsrqar6kxn7itwhk7keokamq"

oci.compute.tenantNameoci.compute.tenantName

Use a text value ##### to search all assets with specific tenant name.

Example

Show all assets with the specific tenant name

oci.compute.tenantName:"oraclecengg1"

oci.compute.timeCreatedoci.compute.timeCreated

Use a text value ##### to search all assets created at the specified time.

Example

Show findings with last check in within a specific date range.

oci.compute.timeCreated:[2020-01-01 ... 2020-01-10]

Show findings with last check in starting 2019-11-01, ending 1 month ago.

oci.compute.timeCreated:[2019-11-01 ... now-1M]

Show findings with last check in starting 2 weeks ago, ending 1 second ago.

oci.tags.keyoci.tags.key

Use a text value ##### to search all assets with the specified tag key.

Example

Show all assets with the tag key CreatedBy

oci.tags(key:CreatedBy)

oci.tags.namespaceoci.tags.namespace

Use a text value ##### to search all assets with the specified namespace.

Example

Show all assets with the namespace Oracle-Tags

oci.tags(namespace:"Oracle-Tags")

oci.tags.typeoci.tags.type

Use a text value ##### to search all assets with specific tag type.

Example

Show all assets with the specific tag type

oci.tags(type:DEFINED)

oci.tags.valueoci.tags.value

Use a text value ##### to search all assets with the specified tag value.

Example

Show all assets with the tag value 2021-02-09

oci.tags(value:"2021-02-09")

oci.vnic.macAddroci.vnic.macAddr

Use a text value ##### to search all assets with the specified MAC address.

Example

Show all assets with the MAC address 02:00:17:06:bd:b3

oci.vnic(macAddr:"02:00:17:06:bd:b3")

oci.vnic.nicIndexoci.vnic.nicIndex

Use a text value ##### to search all assets with the specified index.

Example

Show all assets with the index 1

oci.vnic(nicIndex:1)

oci.vnic.privateIpoci.vnic.privateIp

Use a text value ##### to search all assets with the specified private IP.

Example

Show all assets with this private IP

oci.vnic(privateIp:10.0.0.222)

oci.vnic.publicIpoci.vnic.publicIp

Use a text value ##### to search all assets with the specified public IP.

Example

Show all assets with this public IP

oci.vnic(publicIp:10.0.0.222)

oci.vnic.subnetCidrBlockoci.vnic.subnetCidrBlock

Use a text value ##### to search all assets with the specified block.

Example

Show all assets with the block 10.0.0.0/24

oci.vnic(subnetCidrBlock:10.0.0.0/24)

oci.vnic.subnetIdoci.vnic.subnetId

Use a text value ##### to find OCI instances by the ID of the subnet in which the interface resides.

Example

Find OCI instances with this subnet ID

oci.vnic(subnetId: "subnet-bc02c0d4")

oci.vnic.subnetNameoci.vnic.subnetName

Use a text value ##### to find OCI instances by the name of the subnet in which the interface resides.

Example

Find OCI instances with this subnet name

oci.vnic(subnetName: "subnet-abc")

oci.vnic.vcnIdoci.vnic.vcnId

Use a text value ##### to search all assets with the specified VCN ID.

Example

Show all assets with this VCN ID

oci.vnic(vcnId:"ocid1.vnic.oc1.iad.abuwcljt6cdjcuwhkce37madk4p6bd6ocjknilpwzai5rsyjejteiodyp22q")

oci.vnic.vcnNameoci.vnic.vcnName

Use a text value ##### to search all assets with the specified vcn name.

Example

Show all assets with this vcn name

oci.vnic(vcnName:"abc")

oci.vnic.virtualRouterIpoci.vnic.virtualRouterIp

Use a text value ##### to search all assets with the specified router IP.

Example

Show all assets with the router IP 10.0.0.1

oci.vnic(virtualRouterIp:10.0.0.1)

oci.vnic.vlanTagoci.vnic.vlanTag

Use a text value ##### to search all assets with the specified vlan tag.

Example

Show all assets with the vlan tag 1

oci.vnic(vlanTag:1)

oci.vnic.vnicIdoci.vnic.vnicId

Use a text value ##### to search all assets with the specified VNIC ID.

Example

Show all assets with the VNIC ID ocid1.vnic.oc1.iad.abuwcljt6cdjcuwhkce37madk4p6bd6ocjknilpwzai5rsyjejteiodyp22q

oci.vnic(vnicId:"ocid1.vnic.oc1.iad.abuwcljt6cdjcuwhkce37madk4p6bd6ocjknilpwzai5rsyjejteiodyp22q")

 

IBM Cloud

Use these tokens when searching IBM Cloud assets on the Assets list.

ibm.tags.nameibm.tags.name

Use a text value ##### to find IBM instances with a certain tag name (case insensitive).

Examples

Find IBM instances with name "devops"

ibm.tags(name: devops)

Find IBM instances with name starting "dev"

ibm:tags(name: dev*)

Find IBM instances with name ending "ops"

ibm.tags(name: *ops)

ibm.tags.valueibm.tags.value

Use a text value ##### to find IBM instances with a certain tag value (case insensitive).

Examples

Find IBM instances with tag value "dailybuild"

ibm.tags(value: dailybuild)

Find IBM instances with tag value starting "daily"

ibm.tags(value: daily*)

Find IBM instances with tag value ending "build"

ibm.tags(value: *build)

ibm.virtualServer.datacenterIdibm.virtualServer.datacenterId

Use a text value ##### to find IBM instances with datacenter ID .

Example

Find IBM instances with this datacenter ID

ibm.virtualServer.datacenterId: 1854895

ibm.virtualServer.deviceNameibm.virtualServer.deviceName

Use a text value ##### to find IBM instances with virtual server device name.

Examples

Find IBM instances related to name

ibm.virtualServer.deviceName: "virtualserver01.Qualys-Inc.cloud"

Find IBM instances that match exact value

ibm.virtualServer.deviceName: `virtualserver01.Qualys-Inc.cloud`

ibm.virtualServer.domainibm.virtualServer.domain

Use a text value ##### to search all assets with the specified virtual server domain.

Example

Show all assets with virtual server domain Qualys-Inc.cloud

ibm.virtualServer.domain:"Qualys-Inc.cloud"

ibm.virtualServer.idibm.virtualServer.id

Use a text value ##### to search all assets with the specified virtual server ID.

Example

Show all assets with the  8998892 virtual server ID

ibm.virtualServer.id:8998892

ibm.virtualServer.locationibm.virtualServer.location

Use a text value ##### to define the region you're interested in.

Example

Find IBM instances in this location

ibm.virtualServer.location: "westus"

ibm.virtualServer.privateIpAddressibm.virtualServer.privateIpAddress

Use a text value ##### to define a private IPv4 address or range of IPs you're interested in.

Examples

Find IBM instances with this private IP

ibm.virtualServer.privateIpAddress: 10.240.0.7

Find IBM instances with this private IP range

ibm.virtualServer.privateIpAddress: [10.240.0.7 ... 10.240.0.30]

ibm.virtualServer.privateVlanibm.virtualServer.privateVlan

Use a text value ##### to define a private Vlan you're interested in.

Example

Find the IBM instance with this private Vlan address

ibm.virtualServer.privateVlan: 3455

ibm.virtualServer.publicIpAddressibm.virtualServer.publicIpAddress

Use a text value ##### to define a public IPv4 address or range of IPs you're interested in.

Examples

Find IBM instances with this public IP

ibm.virtualServer.publicIpAddress: 10.240.0.7

Find IBM instances with this public IP range

ibm.virtualServer.publicIpAddress: [10.240.0.7 ... 10.240.0.30]

ibm.virtualServer.publicVlanibm.virtualServer.publicVlan

Use a text value ##### to define a public Vlan you're interested in.

Example

Find the IBM instance with this public Vlan address

ibm.virtualServer.publicVlan: 3455

ibm.virtualServer.stateibm.virtualServer.state

Use a text value ##### to search all assets with specific virtual server state.

Example

Show all assets with the virtual server state Starting

ibm.virtualServer.state:STARTING

 

Supported Boolean Operators

The Qualys Query Language (QQL) supports the following logical or Boolean query operators. Use these operators in your queries to narrow down or broaden your search.

andand

Narrow down your search by using the 'and' operator in your Boolean query. The result contains all the token values that you provide in your query.

Example

asset.status: Enrolled and asset.assetID: 122855563

The asset having the ID 122855563 and with status as Enrolled is returned in the result.

notnot

Narrow down your search by using the 'not' operator in your Boolean query. The result contains all the other values except the one that you specify after 'not' in your query.

Example

not tags.name: Windows

Assets with the Windows tag are excluded from search results.

oror

Broaden your search by using the 'or' operator in your Boolean query. The result contains any of the token values that you provide in your query.

Example

tags.name:Cloud Agent or tags.name:Windows

The assets that have the Cloud Agent tag or the Windows tag are returned in the result.

 

Passive Sensor only

hardware.typingConfidencehardware.typingConfidence

Use a text value ##### to define the hardware typing confidence you're looking for, i.e. HIGH, MEDIUM, LOW, UNIDENTIFIED.

Example

Show this hardware typing confidence

hardware.typingConfidence:HIGH

passiveSensor.idpassiveSensor.id

Use an integer value ##### to help you find assets sensed by a certain sensor ID.

Example

Show this sensor ID

passiveSensor.id:"003687557369:1654660042:3809075:704:1654660042:3809075:704"

passiveSensor.locationpassiveSensor.location

Use a text value ##### to help you find assets based on specific sensor location.

Examples

Show assets with sensor location (appliance location label) as SanJose1

passiveSensor.location:"SanJose1"

passiveSensor.namepassiveSensor.name

Use a text value ##### to help you find assets based on specific sensor name.

Examples

Show assets with sensor name as ITCorp-appliance

passiveSensor.name:"ITCorp-appliance"

passiveSensor.lastupdatedpassiveSensor.lastupdated

Use a date range or specific date to define when passive sensors were last updated.

Examples

Show passive sensors last updated within certain dates

passiveSensor.lastUpdated:[2019-01-01 ... 2019-01-15]

Show passive sensors last updated starting 2019-01-15, ending 1 month ago

passiveSensor.lastUpdated:[2019-01-15 ... now-1M]

Show passive sensors last updated starting 2 weeks ago, ending 1 second ago

passiveSensor.lastUpdated:[now-2w ... now-1s]

Show passive sensors last updated on a specific date

passiveSensor.lastUpdated:`2019-03-18`

 

openPorts.lastFoundopenPorts.lastFound

Use a date range or specific date to define when open ports were last found.

Examples

Show open ports found within certain dates

openPorts.lastFound: [2019-01-01 ... 2019-01-15]

Show open ports found starting 2019-01-15, ending 3 months ago

openPorts.lastFound: [2019-01-15 ... now-3M]

Show open ports found starting 2 weeks ago, ending 1 second ago

openPorts.lastFound: [now-2w ... now-1s]

Show open ports found on a specific date

openPorts.lastFound:'2019-03-18'

openPort.lastUpdatedopenPort.lastUpdated

Use a date range or specific date to define when ports on assets were last updated (i.e. when re-scanned by a scanner appliance, or when host data uploaded to the cloud platform by an agent).

Examples

Show ports updated within certain dates

openPort.lastUpdated: [2019-01-01 ... 2019-01-15]

Show ports updated starting 2019-01-15, ending 3 months ago

openPort.lastUpdated: [2019-01-15 ... now-3M]

Show ports updated starting 2 weeks ago, ending 1 second ago

openPort.lastUpdated: [now-2w ... now-1s]

Show ports updated on a specific date

openPort.lastUpdated:'2019-03-18'

operatingSystem.typingConfidenceoperatingSystem.typingConfidence

Use a text value ##### to define the OS typing confidence you're interested in, i.e. HIGH, MEDIUM, LOW, UNIDENTIFIED.

Example

Show this OS typing confidence

operatingSystem.typingConfidence:MEDIUM

traffic.timestamptraffic.timestamp

Use a date range or specific date to find assets as per traffic timestamp.

Examples

Show assets with traffic timestamp 2019-03-18

traffic.timestamp:'2019-03-18'

Show assets with traffic timestamp within certain dates

traffic.timestamp:[2019-01-01 ... 2019-01-15]

Show assets with traffic timestamp starting 2019-01-15, ending 1 month ago

traffic.timestamp:[2019-01-15 ... now-1M]

Show assets with traffic timestamp starting 2 weeks ago, ending 1 second ago

traffic.timestamp:[now-2w ... now-1s]

traffic.protocoltraffic.protocol

Use a text value ##### to find assets with traffic over specific protocol.

Example

Show assets with traffic over TCP

traffic.protocol:tcp

traffic.porttraffic.port

Use a integer value ##### to find assets with traffic over specific port.

Example

Show assets with traffic over port 80

traffic.port:80

traffic.familytraffic.family

Use a text value ##### to find assets with traffic of a specific family.

Example

Show assets with peer to peer traffic

traffic.family:Peer to Peer

traffic.applicationtraffic.application

Use a text value ##### to find assets with traffic from a specific application.

Example

Show assets with traffic from BitTorrent

traffic.application:BitTorrent

traffic.servicetraffic.service

Use a text value ##### to find assets with traffic from a specific service.

Example

Show assets with traffic from HTTP

traffic.service:http

inventory.scannerIDinventory.scannerID

Use an integer value ##### to find traffic based on scanner ID.

Example

Show traffic with this scanner ID

inventory.scannerID:345678892

inventory.scannerNameinventory.scannerName

Use values within quotes or backticks to help you find traffic based on the scanner name.

Examples

Show any traffic that contain parts of name

inventory.scannerName:"acme-ps-001"

Show any traffic that match exact value "acme-ps-001"

inventory.scannerName:`acme-ps-001`

inventory.scannerLocationinventory.scannerLocation

Use a text value ##### to help you find traffic based on scanner location.

Example

Show traffic with scanner location as Pune 10th floor States

inventory.scannerLocation: Pune 10th floor

client.typeclient.type

Find traffic based on client type (Managed, Unmanaged, Internal, External). Select from the client types in the drop-down menu.

Example

Find traffic of client type Managed

client.type: Managed

client.assetIDclient.assetID

Use an integer value ##### to help you find traffic based on client asset ID.

Example

Show traffic with this client asset ID

client.assetID:122855563

client.nameclient.name

Use values within quotes or backticks to help you find traffic based on client name.

Examples

Show any traffic that contain parts of name

client.name:"ACMENVT7"

Show any traffic that match exact value "ACMENVT7"

client.name:`ACMENVT7`

client.lastLoggedOnUserclient.lastLoggedOnUser

Use a text value ##### to help you find traffic based on last logged into by a user of interest.

Examples

Show traffic with last logon by user jdoe

client.lastLoggedOnUser:jdoe

client.tags.nameclient.tags.name

Use values within quotes or backticks to help you find the traffic based on tag name.

Examples

Show any traffic that contain "rouge" and "BYOD" in name

client.tags.name: "rouge, BYOD"

Show any traffic that contain "rouge" or "BYOD" in name (another method)

client.tags.name: "rouge" OR client.tags.name: BYOD"

Show any traffic that match exact value "rouge, BYOD"

client.tags.name: `rouge, BYOD`

client.hardware.categoryclient.hardware.category

Use values within quotes or backticks to help you find the traffic based on client hardware category.

Examples

Show any traffic that match exact value

client.hardware.category:Computer/Server

client.hardwareclient.hardware

Use values within quotes or backticks to help you find the traffic based on client hardware name.

Examples

Show any traffic that contain parts of name

client.hardware:"Dell Latitude e7470"

Show any traffic that match exact value

client.hardware:`Dell Latitude e7470`

client.operatingSystem.categoryclient.operatingSystem.category

Use text value ##### to help you find the traffic based on client operating system category name.

Example

Show any traffic that match exact value

client.operatingSystem.category:Windows/Client

client.operatingSystemclient.operatingSystem

Use values within quotes or backticks to help you find the traffic based on client operating system name.

Examples

Show any traffic that contain components of OS name

client.operatingSystem:"Windows 7 Enterprise (6.1 SP2) 64Bit"

Show any traffic that match exact value

client.operatingSystem:`Windows 7 Enterprise (6.1 SP2) 64Bit`

client.interfaces.macAddressclient.interfaces.macAddress

Use values within quotes to help you find traffic based on MAC address.

Example

Show the traffic with this MAC address

client.interfaces.macAddress:"00:0D:3A:27:15:BA"

client.interfaces.addressclient.interfaces.address

Use a text value ##### to find traffic based on an IP address.

Examples

Show traffic for this IP address

client.interfaces.address:10.20.0.5

server.typeserver.type

Find traffic for a server type (Managed, Unmanaged, Internal, External). Select from the asset types in the drop-down menu.

Example

Find traffic for server type Internal

server.type: Internal

server.assetIDserver.assetID

Use an integer value ##### to help you find traffic based on server asset ID.

Example

Show traffic for this asset ID

server.assetID:122855563

server.nameserver.name

Use values within quotes or backticks to help you find the traffic with server name.

Examples

Show any traffic that contain parts of name

server.name:"ACMENVT7"

Show any traffic that match exact value "ACMENVT7"

server.name:`ACMENVT7`

server.lastLoggedOnUserserver.lastLoggedOnUser

Use a text value ##### to help you find traffic based on last logged into by a user of interest.

Examples

Show traffic with last logon by user jdoe

server.lastLoggedOnUser:jdoe

server.tags.nameserver.tags.name

Use values within quotes or backticks to help you find the traffic based on tag name.

Examples

Show any traffic that contain "rouge" and "BYOD" in name

server.tags.name: "rouge, BYOD"

Show any traffic that contain "rouge" or "BYOD" in name (another method)

server.tags.name: "rouge" OR server.tags.name: BYOD"

Show any traffic that match exact value "rouge, BYOD"

server.tags.name: `rouge, BYOD`

server.hardware.categoryserver.hardware.category

Use values within quotes or backticks to help you find the traffic based on server hardware category.

Examples

Show any traffic that match exact value

server.hardware.category:Computer/Server

server.hardwareserver.hardware

Use values within quotes or backticks to help you find the traffic based on server hardware name.

Examples

Show any traffic that contain parts of name

server.hardware:"Dell Latitude e7470"

Show any traffic that match exact value

server.hardware:`Dell Latitude e7470`

server.operatingSystem.categoryserver.operatingSystem.category

Use text value ##### to help you find the traffic based on server operating system category name.

Example

Show any traffic that match exact value

server.operatingSystem.category:Windows/Client

server.operatingSystemserver.operatingSystem

Use values within quotes or backticks to help you find the traffic based on server operating system name.

Examples

Show any traffic that contain components of OS name

server.operatingSystem:"Windows 7 Enterprise (6.1 SP2) 64Bit"

Show any traffic that match exact value

server.operatingSystem:`Windows 7 Enterprise (6.1 SP2) 64Bit`

server.interfaces.macAddressserver.interfaces.macAddress

Use values within quotes to help you find traffic based on MAC address.

Example

Show the traffic with this MAC address

server.interfaces.macAddress:"00:0D:3A:27:15:BA"

server.interfaces.addressserver.interfaces.address

Use a text value ##### to find traffic based on an IP address.

Examples

Show traffic for this IP address

server.interfaces.address:10.20.0.5

traffic.serverPorttraffic.serverPort

Use an integer value ##### to help you find traffic with server port.

Example

Show traffic with server port 80

traffic.serverPort:80

traffic.stc.volumetraffic.stc.volume

Use an integer value ##### to help you find traffic with Server-to-Client traffic volume (B).

Examples

Show Server-to-Client traffic greater than 1 MB volume

traffic.stc.volume > 1000000

Show Server-to-Client traffic less than 1 GB volume

traffic.stc.volume < 1000000000

Show Server-to-Client traffic with 1 GB volume

traffic.stc.volume : 1000000000

traffic.cts.volumetraffic.cts.volume

Use an integer value ##### to help you find traffic with Client-to-Server traffic volume (B).

Examples

Show Client-to-Server traffic greater than 1 MB volume

traffic.cts.volume > 1000000

Show Client-to-Server traffic less than 1 GB volume

traffic.cts.volume < 1000000000

Show Client-to-Server traffic with 1 GB volume

traffic.cts.volume : 1000000000

traffic.total.volumetraffic.total.volume

Use an integer value ##### to help you find traffic with total traffic volume (B).

Examples

Show total traffic greater than 1 MB volume

traffic.total.volume > 1000000

Show total traffic less than 1 GB volume

traffic.total.volume < 1000000000

Show total traffic with 1 GB volume

traffic.total.volume : 1000000000

traffic.reportingStartTimetraffic.reportingStartTime

Use a specific date to find traffic with traffic reporting interval start time.

Example

Show traffic with reporting start time

traffic.reportingStartTime > '2020-07-01'

traffic.reportingEndTimetraffic.reportingEndTime

Use a specific date to find traffic with traffic reporting interval end time.

Example

Show traffic with reporting end time

traffic.reportingEndTime < '2020-07-01'

Alibaba

Use these tokens when searching Alibaba assets.

alibaba.instance.accountIdalibaba.instance.accountId

Use a text value to define the instance id of the Alibaba cloud account.

Examples

Find Alibaba instances with the following account ID

alibaba.instance.accountId: 123456789012

Find Alibaba instances with account ID starting "12345"

alibaba.instance.accountId: 12345*

alibaba.instance.dnsServeralibaba.instance.dnsServer

Use an integer value to define the Domain Name System (DNS) configurations of the instance.

Example

Find Alibaba instances of the following DNS

alibaba.instance.dnsServer: 100.xxx.x.xxx

alibaba.instance.hasAgentalibaba.instance.hasAgent

Use the boolean value, true | false to define whether the Alibaba instance has a cloud agent installed on it.

Example

Find Alibaba instances with agents

alibaba.instance.hasAgent: true

alibaba.instance.hostNamealibaba.instance.hostName

Use a text value to find Alibaba hostname.

Example

Find Alibaba instances related to name

alibaba.instance.hostName: abc.qualys.com

alibaba.instance.imageIdalibaba.instance.imageId

Use a text value to find the Id of the image used during the instance creation process.

Example

Find instances related to image id

alibaba.instance.imageId: ubuntu_14_0405_64_20G_alibase_20170824.vhd

alibaba.instance.instanceIdalibaba.instance.instanceId

Use a text value to define the Alibaba instance id.

Example

Find Alibaba instances with this instance ID

alibaba.instance.instanceId: i-a2dxxxxsxxxxxhdfax

alibaba.instance.instanceTypealibaba.instance.instanceType

Use a text value to define the instance type.

Example

Find Alibaba instances with this instance type

alibaba.instance.instanceType: ecs.t5-lc1m1.small

alibaba.instance.interfaceIdalibaba.instance.interfaceId

Use a text value to define the identifier of the NIC.

Example

Find Alibaba instances of the following interface id

alibaba.instance.interfaceId: a2dxxxxaixxxtux572

alibaba.instance.instanceStatealibaba.instance.instanceState

Use a text value to define the state of the Alibaba instance. Some of the examples of the state of the instance are: MOVING, RUNNING, STARTED, STOPPED, STOPPING, and TERMINATED.

Example

Find Alibaba instances for the following state

alibaba.instance.instanceState: RUNNING

alibaba.instance.macAddressalibaba.instance.macAddress

Use a text value to define the MAC address.

Example

Find Alibaba instances with this MAC address

alibaba.instance.macAddress: 00:16:3e:0f:XX:XX

alibaba.instance.networkTypealibaba.instance.networkType

Use the network type values to find the Alibaba cloud instances. The network type can be vpc or classic.

Example

Find Alibaba instances with this network type

alibaba.instance.networkType: vpc

alibaba.instance.privateIpAddressalibaba.instance.privateIpAddress

Use an integer value to define a private IPv4 address or range of IPs.

Example

Find Alibaba instances with the following private IP address

alibaba.instance.privateIpAddress: 192.168.XX.XX

alibaba.instance.publicIpAddressalibaba.instance.publicIpAddress

Use an integer value to define a public IPv4 address or range of IPs.

Example

Find Alibaba instances with the following public IP address

alibaba.instance.publicIpAddress: 149.xx.xx.xx

alibaba.instance.region.codealibaba.instance.region.code

Use a text value to find the alibaba cloud instances that belong to the region with specific code. Some of the examples of codes are ap-northeast-1,  ap-south-1, nanjing, cn-chengdu, and eu-central-1.

Example

Find Alibaba instances for the following region code

alibaba.instance.region.code: cn-chengdu

alibaba.instance.region.namealibaba.instance.region.name

Use a text value to define the region name. Australia (Sydney), Beijing, China, Japan (Tokyo), India (Mumbai), and Philippines (Manila).

Example

Find Alibaba instances for the following region

alibaba.instance.region.name: US (Silicon Valley)

alibaba.instance.serialNumberalibaba.instance.serialNumber

Use a text value to define the serial number of the instance.

Example

Find Alibaba instances of the following serial number

alibaba.instance.serialNumber: 12trexxxxr-3xx-xxx-rtg4-xxxx6t45

alibaba.instance.vpcCidrBlockalibaba.instance.vpcCidrBlock

Use a text value to define the serial number of the instance.

Example

Find Alibaba instances of the following CIDR block

alibaba.instance.vpcCidrBlock: 172.xx.x.x/16

alibaba.instance.vpcIdalibaba.instance.vpcId

Use a text value to search all the Alibaba instances with the specified VPC ID.

Example

Show Alibaba instances with this VPC ID

alibaba.instance.vpcId: vpc-a2d6pxxxxvvdadd5yikj

alibaba.instance.vswitchIdalibaba.instance.vswitchId

Use a text value to search all the Alibaba instances with the specified vswitchId.

Example

Show Alibaba instances with of the following switch ID

alibaba.instance.vswitchId: vsw-a2dxxxoxxxxsqx1mxxxdd

alibaba.instance.vswitchCidrBlockalibaba.instance.vswitchCidrBlock

Use an integer value to define the CIDR block of the switch to which the Alibaba instance is connected.

Example

Find Alibaba instances of the following CIDR block of the switch

alibaba.instance.vswitchCidrBlock: 192.168.XX.XX/24

alibaba.instance.zoneIdalibaba.instance.zoneId

Use a text value to define the zone id.

Examples

Find Alibaba instances of the following zone id

alibaba.instance.zoneId: cn-chengdu-a

 

Certificates

Use these tokens when searching for Certificate details

asset:(nameasset:(name

Provide the value to find certificates for the specified asset name.

Example

Show certificates for the asset with the following asset name

asset:(name: investor.qualys.com)

asset:(interfaces.hostnameasset:(interfaces.hostname

Provide the value to find certificates for the specified interface hostname.

Example

Show certificates for the asset with the following interface hostname

asset:(interfaces.hostname: xpsp2-jp-26-111)

asset:(interfaces.addressasset:(interfaces.address

Provide the value to find certificates for the specified interface address.

Example

Show certificates for the asset with the following interface address

asset:(interfaces.address: 10.20.30.40)

asset:(netbiosNameasset:(netbiosName

Provide the value to find the certificate details for the specified host NetBios name.

Example

Show certificate details for the specified host NetBios name.

asset:(netbiosName: server1)

asset:(operatingSystemasset:(operatingSystem

Use quotes or backticks within values to find the certificates for the specified operating system.

Examples

Show any findings with this OS name

asset:(operatingSystem: Windows 2012)

Show any findings that contain components of OS name

asset:(operatingSystem: "Windows 2012")

Show any findings that match exact value "Windows 2012"

asset:(operatingSystem: `Windows 2012`)

asset:(tags.nameasset:(tags.name

Show certificates for the specified tag name.

Example

Show certificates on assets that have this asset tag

asset:(tags.name: prod-dmz)

certificate:(approvedcertificate:(approved

Use the values true | false to find certificates from approved CAs.

Example

Show certificates that have approval status true from approved CAs

certificate:(approved: true)

certificate:(dncertificate:(dn

Find certificates that have the specified subject identifier in the certificate subject distinguished name (DN).

Examples

Show certificates that have this subject identifier in the distinguished name.

certificate:(dn: ST=California)

certificate:(certhashcertificate:(certhash

Find certificates for the specified certificate fingerprint.

Example

Show certificates that have this hash value

certificate:(certhash: 20e1541486f2cd405559d8483a3663f2a77c3cf93c72f4f915259f084f814221)

certificate:(issuer.countrycertificate:(issuer.country

Find certificates that have the specified country mentioned in the issuer distinguished name.

Example

Show certificates that have this country in issuer DN

certificate:(issuer.country: US)

certificate:(issuer.organizationcertificate:(issuer.organization

Find certificates that have the specified organization mentioned in the issuer distinguished name.

Example

Show certificates that have this organization in issuer DN

certificate:(issuer.organization: Symantec Corporation)

certificate:(issuer.namecertificate:(issuer.name

Find certificates with the specified name of the issuing certificate authority.

Example

Show the certificates having this issuing authority name

certificate:(issuer.name: Symantec Class 3 EV SSL CA - G3)

certificate:(issuer.organizationUnitcertificate:(issuer.organizationUnit

Find certificates that have the organization unit mentioned in the issuer distinguished name.

Example

Show certificates that have this organization unit in issuer DN

certificate:(issuer.organizationUnit: Symantec Trust Network)

certificate:(issuerCategorycertificate:(issuerCategory

Find certificate for the specified category of certificate.

Example

Show DigiCert SHA2 Extended Validation Server CA certificates

certificate:(issuerCategory: DigiCert SHA2 Extended Validation Server CA)

certificate:(keySizecertificate:(keySize

Find certificates for the specified key length of a certificate.

Example

Show certificates that have 2048-bit keys

certificate:(keySize: 2048)

certificate:(subject.countrycertificate:(subject.country

Find certificates for specified country mentioned in the subject distinguished name.

Example

Show certificates that have this country in subject DN

certificate:(subject.country: US)

certificate:(subject.organizationcertificate:(subject.organization

Find certificates for the organization mentioned in the subject distinguished name.

Example

Show certificates that have this organization in subject DN

certificate:(subject.organization: Qualys, Inc.)

certificate:(subject.namecertificate:(subject.name

Find certificates with the specified subject name.

Example

Show certificates with this name

certificate:(subject.name: www.qualys.com)

certificate:(subject.localitycertificate:(subject.locality

Find certificates with the specified locality mentioned in the subject distinguished name.

Example

Show certificates that have this locality in subject DN

certificate:(subject.locality: Redwood City)

certificate:(subject.statecertificate:(subject.state

Find certificates with the specified state mentioned in the subject distinguished name.

Example

Show certificates that have this state in subject DN

certificate:(subject.state: California)

certificate:(subjectAlternativeNames.dnsNamecertificate:(subjectAlternativeNames.dnsName

Find certificates with the specified DNS Name in Certificate Subject Alternate Name (SAN).

Example

Show certificates that have the specified DNS Name in Certificate SAN

certificate:(subjectAlternativeNames.dnsName: www.qualys.com)

certificate:(subjectAlternativeNames.ipAddresscertificate:(subjectAlternativeNames.ipAddress

Find certificates that have the specified IP address in Certificate SAN.

Example

Show certificates that have the specified the IP address in Certificate SAN

certificate:(subjectAlternativeNames.ipAddress: 10.113.197.210)

certificate:(validFromcertificate:(validFrom

Find certificats for the specified validation date. You can specify the range or specific date.

Examples

Show certificates that are valid within certain dates

certificate:(validFrom: [2018-06-15 ... 2018-06-30])

Show certificates that are valid on a specific date

certificate:(validFrom: '2017-12-14')

certificate:(validTocertificate:(validTo

Find certificates that are valid up to the specified date. You can specify the range or specific date.

Examples

Show certificates that expire before 2022-01-20

certificate:(validTo < "2022-01-20")

Show certificates that expire after 2020

certificate:(validTo > "2020")

Show certificates that expire before March 2020 (yyyy-mm)

certificate:(validTo < "2020-03")

Show certificates that expire between today and 2020-12-01

certificate:(validTo: "[now..2020-12-01]")

certificate:(validitycertificate:(validity

Find certificats that are valid based on the validity period you specified. For example, you can find certificates that are valid for 100 days, certificates that are valied for an year, and so on.

Note: For the Rule query builder of the Responses tab qualifiers like d, m, y are currently not supported. Please specify the value in number of days only.

Examples

Show all certificates whose validity is greater than 200 days

certificate:(validity > 200)

Show all certificates whose validity is less than 200 days

certificate:(validity < 200d)

Show all certificates whose validity is greater than 3 months. One month is considered as 30 days.

certificate:(validity > 3m)

Show all certificates whose validity is greater than 1 year. Here one year is considered as 365 days.

certificate:(validity > 1y)

certificate:(serialNumbercertificate:(serialNumber

Find certificates with the specified serial number.

Example

Show the certificate that has this serial number

certificate:(serialNumber: "01ab8a210a7cf9955665c47fca758459ca78")

certificate:(expiryGroupcertificate:(expiryGroup

Find the certificates from one of the groups you specified. The categories are Expired, In 30 Days, In 60 Days, In 90 Days.

Examples

Show certificates which expired in last 20 days

certificate:(expiryGroup: "In 30 Days")

Show all expired certificates in your subscription

certificate:(expiryGroup: "Expired")

certificate:(isRenewablecertificate:(isRenewable

Find the certificates that are renewable with Qualys. The supported values are true and false. Certificates can be renewed with Qualys if they are issued by a DigiCert CA and are expiring in next 90 days or are already expired.

Example

Show certificates that are renewable with Qualys

certificate:(isRenewable: true)

certificate:(selfSignedcertificate:(selfSigned

Find the certificates that are self signed. Supported values are true and false.

Example

Show certificates that are self-signed

certificate:(selfSigned: true)

instance:(cipherSuites.valueinstance:(cipherSuites.value

Find the certificates with the specified cipher suit enabled in the SSL/TLS instance.

Example

Show certificates that have this cipher suit enabled in the SSL/TLS instance

instance:(cipherSuites.value: DES-CBC3-SHA)

instance:(fqdninstance:(fqdn

Find the certificates with the specified host FQDN.

Example

Show certificates on assets that have this host FQDN

instance:(fqdn: server1.qualys.com)

instance:(gradeinstance:(grade

Find certificates with the specified Certificate Grade for an instance on the host.

Example

Show certificates that have this Certificate Grade for an instance on the host

instance:(grade: B)

instance:(portinstance:(port

Find certificates with the specified listening port open.

Example

Show certificates on assets that have this listening port open

instance:(port: 443)

instance:(serviceinstance:(service

Find the certificates with the specified service.

Example

Show certificates on assets that have this service

instance:(service: SMTP)

instance:(sourcesinstance:(sources

Find the certificates for assets that are scanned with the specified source. The supported values are Cloud Agent, EASM, or IP Scanner

Examples

Show certificates that are scanned through Cloud Agent

instance:(sources: Cloud Agent)

Show certificates that are scanned through EASM

instance:(sources: EASM)

instance:(sslProtocolsinstance:(sslProtocols

Find the certificates for assets with the specified SSL/TLS protocol enabled.

Example

Show certificates on assets that have this SSL/TLS protocol

instance:(sslProtocols: TLSv1.2)

instance:(vulns.severityinstance:(vulns.severity

Find the certificates for assets with the specified vulnerability severity.

Example

Show certificates on assets that have this vulnerability severity

instance:(vulns.severity: 3)

instance:(vulns.titleinstance:(vulns.title

Find the certificates for assets with the specified vulnerability title.

Example

Show certificates on assets with vulnerabilities that have POODLE in the vulnerability title

instance:(vulns.title: POODLE)

instance:(vulns.qidinstance:(vulns.qid

Use an integer value ##### to specify the vulnerability QID.

Example

Show assets that have this vulnerability QID

instance:(vulns.qid: 38603)

asset:(activatedForModulesasset:(activatedForModules

Find the certificates for assets that are activated for the specified modules. For example, VM, WAS, FIM, and so on.

Examples

Show certificates for assets activated for VM

asset:(activatedForModules: "VM")

asset:(businessApp.nameasset:(businessApp.name

Find the certificates for assets with the specified business application name.

Examples

Show any findings that contain parts of name

businessApp:(name:"HR")

Show any findings that match exact value "HR Intranet"

businessApp:(name:`HR Intranet`)

asset:(businessApp.businessCriticalityasset:(businessApp.businessCriticality

Find the certificates for assets with the specified business application business criticality.

Examples

Show any findings that contain parts of name

asset:(businessApp.businessCriticality: "1 - most")

Show any findings that match exact value "1 - most critical"

asset:(businessApp.businessCriticality: `1 - most critical`)

asset:(businessApp.supportGroupasset:(businessApp.supportGroup

Find certificates for business applications with support group.

Example

Show certificates with business application support group as Security

asset:(businessApp.supportGroup: Security)

asset:(operatingSystem.category1asset:(operatingSystem.category1

Find certificates for the specified operating system 1 category. Some of the examples of supported values are Embedded, Filesystem Software, Firmware, Linux, Mac, and so on.

Examples

Show any findings with this OS category

asset:(operatingSystem.category1: `Linux`)

asset:(operatingSystem.category2asset:(operatingSystem.category2

Find certificates for the specified operating system 2 category. The supported values are Client, Embedded, Server, and Hypervisor Type-1 (Bare Metal).

Examples

Show any findings with this OS category

asset:(operatingSystem.category2: `Client`)

asset:(hardware.category1asset:(hardware.category1

Find the certificates for assets with the specified hardware category 1. Some of the supported values are Audio and Visual Devices, Building Automation Devices, Communication Devices, Computers, and so on.

Example

If you are searching for assets that are laser printers, then category1 is Printers and category2 is Laser.

Show any findings that match exact value

asset:(hardware.category1:`Computers`)

asset:(hardware.category2asset:(hardware.category2

Find the certificates for assets with the specified hardware category 2. Some of the supported values are 3D Printers, Access Servers, Audio Amplifier, IP Phones, I/O Module, and so on.

Example

If you are searching for assets that are laser printers, then category1 is Printers and category2 is Laser.

Show any findings that match exact value

asset:(hardware.category2:`I/O Module`)

asset:(providerasset:(provider

Find the certificates for assets with the specified provider. The supported values are ALIBABA, AWS, Azure, GCP, IBM, and OCI.

Examples

Show certificates for assets synced from Amazon AWS

asset:(provider: `AWS`)

asset:(inventory.sourceasset:(inventory.source

Find the certificates for assets with the specified inventory source. Some of the supported values are EASM, Cloud Agent, IBM, ICS OCA, Azure, and BMC Helix and so on.

Examples

Show certificates for assets with the following inventory source

asset:(inventory.source: `EASM`)

asset:(inventory.createdasset:(inventory.created

Find the certificates for assets with the specified inventory created date.

Examples

Show asset inventory created within certain dates

asset:(inventory.created: [2019-01-01 ... 2019-01-15])

Show asset inventory created starting 2024-01-15, ending 1 month ago

asset:(inventory.created:[2024-01-15 ... now-1M])

Show asset inventory created starting 2 weeks ago, ending 1 second ago

asset:(Inventory.created: [now-2w ... now-1s])

Show asset inventory created on a specific date

asset:(inventory.created: '2024-03-18')

asset:(inventory.lastUpdatedasset:(inventory.lastUpdated

Find the certificates for assets with the specified inventory last updated date.

Examples

Show asset inventory last updated within certain dates

asset:(inventory.lastUpdated: [2024-01-01 ... 2024-01-15])

Show asset inventory last updated starting 2024-01-15, ending 1 month ago

asset:(inventory.lastUpdated: [2024-01-15 ... now-1M])

Show asset inventory starting 2 weeks ago, ending 1 second ago

asset:(inventory.lastUpdated: [now-2w ... now-1s])

Show asset inventory last updated on a specific date

asset:(inventory.lastUpdated: '2024-03-18')