Lists

Supported in:

This document describes a set of tools that can help you manage custom lists.

Search custom list

Description

Search for a specified string within the records of a custom list. If no values are provided, the search returns all custom list records.

Parameters

Parameter Type Default value Is mandatory Description
String to search String N/A No Specify the string to search for within the records in a custom list.
Categories String N/A No Specify the custom list category to search within.

Example

In this example, the system checks whether .com is included in any records in a custom list with the category "Blocked Domains".

Action configurations

Parameter Value
Entities All entities
String to search .com
Categories Blocked Domains

Action results

  • Script result
    Script result name Value options Example
    Match_Records True/False true
  • JSON result 
    [{
"entityIdentifier": "sample.com", "category": "Blocked Domains", "forDBMigration": false, "environments": ["*"], "id": 1, "creationTimeUnixTimeInMs": 1674846992575, "modificationTimeUnixTimeInMs": 1674846992575
}]

Search for a specified string in an environment custom list

Description

Search a specified string within the records of the current case environment's custom list. If no values are provided, the search returns all custom lists records.

Parameters

Parameter Type Default value Is mandatory Description
String to search String N/A No Specify string to search within the records in a custom list.
Categories String N/A No Specify the custom list category to search within.

Example

In this example, the system checks whether 1.1.1.1 is included in any records in a custom list with the category "vuln_scanner".

Action configurations

Parameter Value
Entities All entities
String to search 1.1.1.1
Categories vuln_scanner

Action results

  • Script result
    Script result name Value options Example
    Match_Records True/False true
  • JSON result 
    [
  {
    "entityIdentifier": "1.1.1.1",
    "category": "vuln_scanner",
    "environments": [
      "Default Environment"
    ],
    "id": 5,
    "name": "test",
    "creationTimeUnixTimeInMs": 1673953571935,
    "modificationTimeUnixTimeInMs": 1673953571935
  }
]

Is string in custom list

Description

Checks if a string is in a custom list.

Parameters

Parameter Type Default value Is mandatory Description
ListItem String N/A Yes Specify string to add to a custom list.
Category String Allowlist Yes Specify the custom list category or name.

Example

In this example, the system checks whether the IP address 0.0.0.0 exists in a list category named bad_ips_list.

Action configurations

Parameter Value
Entities All entities
IdentifierList 0.0.0.0
Categories bad_ips_list

Action results

  • Script result
Script result name Value options Example
NumOf FoundResults True/False true
  • JSON result 
    {
"Entity" : "0.0.0.0",
"EntityResult" : "true"
}

Add string to custom list

Description

Adds a string to a custom list.

Parameters

Parameter Type Default value Is mandatory Description
ListItem String N/A Yes Specify string to add to a custom list.
Category String Allowlist Yes Specify the custom list category/name.

Example

In this example, an IP address of 0.0.0.1 is added to a custom list category named bad_ips_list.

Action configurations

Parameter Value
Entities All entities
Listitem 0.0.0.1
Categories bad_ips_list

Action results

  • Script result
    Script result name Value options Example
    NumOf FoundResults True/False true
  • JSON result 
    {
"Entity" : "0.0.0.0",
"EntityResult" : "true"
}

Remove string from custom list

Description

Removes a string from a custom list.

Parameters

Parameter Type Default value Is mandatory Description
Category String Allowlist Yes Specify the custom list category/name.
ListItem String N/A Yes Specify string to remove from a custom list.

Example

In this example, an IP address 0.0.0.1 is removed from a custom list category named bad_ips_list.

Action configurations

Parameter Value
Entities All entities
IdentifierList 0.0.0.1
Categories bad_ips_list

Action results

  • Script result
    Script result name Value options Example
    NumOfFoundResults True/False true
  • JSON result 
    {
"Entity" : "0.0.0.0",
"EntityResult" : "true"
}

Need more help? Get answers from Community members and Google SecOps professionals.