Using Sighting Search Parameters

Release version: Zurich

Updated July 31, 2025

2 minutes to read

Summarize

Summarized using AI

Summary of Using Sighting Search Parameters

ServiceNow's Threat Intelligence Security Center allows you to define complex sighting search parameters for querying log stores. These parameters support logical operators and customizable query syntax, enabling precise enrichment of threat intelligence data through integrations.

Show full answer Show less

Accessing and Managing Sighting Search Parameters

Navigate to Workspaces > Threat Intelligence Security Center > Integrations, then to Enrichment Integrations > Sighting Search.
Select and edit the relevant integration to view its Sighting Search Configurations.
Within a configuration, access the Sighting Search Parameters tab to view, filter, refresh, or modify parameters.
Actions available include editing columns for display customization and filtering by conditions for easier management.

Creating Sighting Search Parameters

To create a new parameter:

From the Sighting Search Parameters tab, click New and complete the form fields:

After each value: Text appended after each observable in the query.
Between each value: Text placed between observables, e.g., logical operators like OR.
Before each value: Text prepended before each observable.
Configuration: Details defining the search parameter logic.
Observable type: Specifies the category of observable (e.g., IP address).
Substitution variable: Defines the variable name replaced by actual observable values during query generation.

Save the parameter to apply it within the integration's sighting search configuration.

Example Usage

For observables such as 172.32.31.41 and 192.168.10.12, configuring parameters with appropriate before, between, and after values can generate a query like:

ipaddress = 172.32.31.41 OR ipaddress = 192.168.10.12

This example illustrates how substitution variables and logical operators combine to form effective sighting search queries.

You can use sighting search parameters that define more complex queries, which include logic and other operators supported by the specified log store.

View Sighting Search Parameters

Role required: sn_sec_tisc.admin

To view the sighting search parameters, perform the following steps:

Navigate to Workspaces > Threat Intelligence Security Center > Integrations.
From the Integrations page, navigate to Enrichment Integrations > Sighting Search.
Look for the integration for which you want to view the Sighting Search Configuration, and click Edit.
Select the Sighting Search Configurations tab.
You can view the list of sighting search configurations.
Click on the required Sighting Search Configuration to view the details of the configuration.
Select the Sighting Search Parameters tab.
You can view the list of sighting search parameters.
Click on the required Sighting Search Parameter to view the details of the parameter.
You can also perform the following actions on the Sighting Search Parameters tab:
1. To refresh the list of sighting search parameters, click icon.
2. To perform a list action on the sighting search parameters, click the icon.
  Edit columns: You can use this action to add or remove existing columns and modify the order according to your requirements.
3. To filter sighting search parameters based on conditions, click the icon.
  The value 1 indicates that one condition is used for the filtering.

Create Sighting Search Parameter

Example for query generation

Configured Query: ${Observable}

Observables Substitutes for Sightings search: Obs1 , Obs2

Query: {Before each Value}Obs1{After each Value}{Between each value}{Before each Value}Obs2{After each Value}



Let observables are: 172.32.31.41 & 192.168.10.12

Query Formed with below configuration will be: “ip_address = 172.32.31.41 OR ip_address = 192.168.10.12”

To create a sighting search parameter, perform the following steps:

Navigate to Workspaces > Threat Intelligence Security Center > Integrations.
From the Integrations page, navigate to Enrichment Integrations > Sighting Search.
Look for the integration for which you want to view the Sighting Search Configuration, and click Edit.
Select the Sighting Search Configurations tab.
You can view the list of sighting search configurations.
Click on the required Sighting Search Configuration to view the details of the configuration.
Select the Sighting Search Parameters tab.
You can view the list of sighting search parameters.
To create a sighting search parameter, click New.

On the form, fill the fields.

Table 1. Create a sighting search parameter
Field	Description
After each value	The sighting search parameter after each observable when the search query is generated.
Between each value	The sighting search parameter between each observable when the search query is generated. For example, OR.
Before each value	The sighting search parameter before each observable when the search query is generated.
Configuration	The configuration details of the search parameter.
Observable type	Defines the type of observable category.
Substitution variable	Specifies the name of the variable that is replaced by an observable value.

Click Save.