Get safe scripts

Retrieve a list of items from the script safe list.

Service endpoint

/globallists/v2/script/whitelist/bulk?page=m&page_size=n

Optional query string parameters

—

Example

https://protectapi.cylance.com/globallists/v2/script/whitelist/bulk?page=2&page_size=50

Method

HTTP/1.1 GET

Request headers
  • Accept: application/json
  • Authorization: Bearer JWT Token returned by Auth API with the globallist:READ scope encoded

Request

Append the following optional query string parameters:

  • page: The page number to request, defaults to 1
  • page_size: The number of scripts to retrieve per page, defaults to 10

Response

Please see the Response status codes for more information.

Body:
JSON 
{
    "page_number": 1,
    "page_size": 10,
    "total_pages": 2,
    "total_number_of_items": 20,
    "page_items": [{
        "sha256": "5A56B16953451FFA1C79F2397DB92475E440D430E4B6FB6E188E5E9DBFC9DDE4",
        "file_path" : "/FileFolder1/FileFolder2",
        "description" : "I am adding this whitelist because this script file is safe and should not be blocked."
    }]

}

Where:

Field Name Description

page_number

The current page number.

page_size

The page size (maximum is 200).

total_pages

The total amount of pages.

total_number_of_items

The total amount of items.

page_items
The list of zones belonging to the requested page, each displaying the following information:
  • SHA256: The script file that matches the hash will be allowed to execute regardless of the other script controls that have been configured for the tenant.
  • filePath: The file path that is used to describe the hash.
  • description: The description or reason of the safe list entry.

Request json schema

None