Skip to main content

Netskope Help

Netskope Tenants

To leverage the primary modules to work with Netskope, you need to create a Netskope tenant in CE. Configured Netskope tenants are displayed on the Netskope Tenants page, and Admins can edit and delete configured tenants.

You need your Netskope tenant API token(s) to complete this procedure.

Obtain your v1 RESTful API token by following the steps in REST API v1 Overview CE uses v1 tokens for updating file hashes in Threat Exchange.

Important

A v1 token is required for adding a Netskope tenant in CE, but will not be used if an equivalent v2 endpoint is available.

Create a new v2 RESTful API token by following the steps in REST API v2 Overview. For v2 tokens, specific scopes need to be enabled. For more information, see REST API Scopes.

When you have your token(s), copy them and then add a tenant to CE.

Click play to watch a demo:

 
Add a Netskope Tenant
  1. Go to Settings and click Netskope Tenants. A list of configured Netskope tenants are displayed. There are Edit and Delete icons for each tenant in the Action column.

    image55.png
  2. Click Add Tenant.

  3. Enter parameters for these fields:

    Field

    Description

    Name

    Netskope tenant configuration name.

    Tenant Name

    Netskope tenant name.

    V1 API Token

    API token to authenticate the tenant.

    V2 API Token

    API token to authenticate the tenant.

    Alerts Filter

    Filters the incoming alerts.

    Initial Range

    Number of days to pull the data for initial run.

    System Proxy

    The system proxy configured in the Netskope tenant Settings.

    CE-Log-Shipper-Tenant.png
  4. When finished, click Save.

Dataexport Error Codes

Error Codes

User-Action Required

Description

403

Yes

Check the API V2 token is associated with the valid endpoint & its not expired.Retry will solve the problem only after solving the token issue by following these guidelines

409

No

Concurrency conflict and the request cannot be processed at this point of time.

DataExport API V2 endpoints do not support downloading the same event type concurrently with the same iterator index, and the Client is expected to validate that the logic to pull the events is single-threaded.

429

No

Too many requests for the same tenant accessing the same endpoint.

The Client is expected to honor the rate limit to avoid 429 error and as part of the response header, it carries the reset time in the header ratelimit-reset. The Client is expected to sleep/wait ( ratelimit-reset ) to avoid 429.

The current rate limit is 4 req / second/endpoint.

5XX

Yes

Netskope is having a temporary server issue for some reason:

  • DataBase Query timeout

  • Server overloaded

  • Internal DNS issues

Upon receiving a 5xx error from Netskope Server , the User is recommended to do a back off of 5 seconds wait time before the next call.

v1 REST API Scopes

Endpoint

Privilege

Log Shipper (CLS)

Ticket Orchestrator (CTO)

Threat Exchange (CTE)

User Risk Exchange (URE)

App Risk Exchange (ARE)

Notes

Token Generated and Not Expired

(all)

x

Required for sharing file hashes

v2 REST API Scopes

Note

Starting with CE 4.2.0, you are required to use the dataexport endpoint permission for the alerts and events you have configured in Cloud Exchange when setting up Netskope Tenants.

Endpoint

Privilege

Log Shipper (CLS)

Ticket Orchestrator (CTO)

Threat Exchange (CTE)

User Risk Exchange (URE)

App Risk Exchange (ARE)

Notes

/api/v2/events/data/alert

Read

/api/v2/events/data/application

Read

/api/v2/events/data/audit

Read

/api/v2/events/data/infrastructure

Read

/api/v2/events/data/network

Read

/api/v2/events/data/page

Read

/api/v2/events/dataexport/events/alert

Read

x

x

x

x

x

Required to validate API token

/api/v2/events/dataexport/events/application

Read

x

x

/api/v2/events/dataexport/events/audit

Read

x

/api/v2/events/dataexport/events/connection

Read

/api/v2/events/dataexport/events/incident

Read

x

/api/v2/events/dataexport/events/infrastructure

Read

x

/api/v2/events/dataexport/events/network

Read

x

/api/v2/events/dataexport/events/page

Read

x

/api/v2/events/dataexport/alerts/uba

Read

x

x

/api/v2/events/dataexport/alerts/securityassessment

Read

x

x

/api/v2/events/dataexport/alerts/quarantine

Read

x

x

x

/api/v2/events/dataexport/alerts/remediation

Read

x

x

/api/v2/events/dataexport/alerts/policy

Read

x

x

/api/v2/events/dataexport/alerts/malware

Read

x

x

x

/api/v2/events/dataexport/alerts/malsite

Read

x

x

x

/api/v2/events/dataexport/alerts/compromisedcredential

Read

x

x

/api/v2/events/dataexport/alerts/ctep (or ips)

Read

x

x

/api/v2/events/dataexport/alerts/dlp

Read

x

x

/api/v2/events/dataexport/alerts/watchlist

Read

x

x

/api/v2/policy/urllist/file

Read + Write

/api/v2/policy/urllist

Read + Write

x

/api/v2/policy/urllist/deploy

Read + Write

x

/api/v2/incidents/uba/getuci

Read + Write

x

/api/v2/ubadatasvc/user/uci

Read + Write

x

/api/v2/services/cci/app

Read

x

/api/v2/services/cci/domain

Read

x

/api/v2/services/cci/tags

Read

x

x: Required API scopes for the corresponding CE module.

v1 REST API Scopes

Endpoint

Privilege

Log Shipper (CLS)

Ticket Orchestrator (CTO)

Threat Exchange (CTE)

User Risk Exchange (URE)

App Risk Exchange (ARE)

Notes

Token Generated and Not Expired

(all)

x

Required for sharing file hashes

v2 REST API Scopes

Endpoint

Privilege

Log Shipper (CLS)

Ticket Orchestrator (CTO)

Threat Exchange (CTE)

User Risk Exchange (URE)

App Risk Exchange (ARE)

Notes

/api/v2/events/data/alert

Read

/api/v2/events/data/application

Read

/api/v2/events/data/audit

Read

/api/v2/events/data/infrastructure

Read

/api/v2/events/data/network

Read

/api/v2/events/data/page

Read

/api/v2/events/dataexport/events/alert

Read

x

x

x

x

x

Required to validate API token

/api/v2/events/dataexport/events/application

Read

x

x

/api/v2/events/dataexport/events/audit

Read

x

/api/v2/events/dataexport/events/connection

Read

/api/v2/events/dataexport/events/incident

Read

x

/api/v2/events/dataexport/events/infrastructure

Read

x

/api/v2/events/dataexport/events/network

Read

x

/api/v2/events/dataexport/events/page

Read

x

/api/v2/events/dataexport/alerts/uba

Read

x

x

/api/v2/events/dataexport/alerts/securityassessment

Read

x

x

/api/v2/events/dataexport/alerts/quarantine

Read

x

x

x

/api/v2/events/dataexport/alerts/remediation

Read

x

x

/api/v2/events/dataexport/alerts/policy

Read

x

x

/api/v2/events/dataexport/alerts/malware

Read

x

x

x

/api/v2/events/dataexport/alerts/malsite

Read

x

x

x

/api/v2/events/dataexport/alerts/compromisedcredential

Read

x

x

/api/v2/events/dataexport/alerts/ctep (or ips)

Read

/api/v2/events/dataexport/alerts/dlp

Read

x

x

/api/v2/events/dataexport/alerts/watchlist

Read

x

x

/api/v2/policy/urllist/file

Read + Write

/api/v2/policy/urllist

Read + Write

x

/api/v2/policy/urllist/deploy

Read + Write

x

/api/v2/incidents/uba/getuci

Read + Write

x

/api/v2/ubadatasvc/user/uci

Read + Write

x

/api/v2/services/cci/app

Read

x

/api/v2/services/cci/domain

Read

x

/api/v2/services/cci/tags

Read

x

x: Required API scopes for the corresponding CE module.

v1 REST API Scopes

Endpoint

Privilege

Log Shipper (CLS)

Ticket Orchestrator (CTO)

Threat Exchange (CTE)

User Risk Exchange (URE)

App Risk Exchange (ARE)

Notes

Token Generated and Not Expired

(all)

y

y

x+y (*)

y

y

* Required for sharing file hashes

v2 REST API Scopes

Endpoint

Privilege

Log Shipper (CLS)

Ticket Orchestrator (CTO)

Threat Exchange (CTE)

User Risk Exchange (URE)

App Risk Exchange (ARE)

Notes

/api/v2/events/data/alert

Read

y

y

y

y

y

/api/v2/events/data/application

Read

y

/api/v2/events/data/audit

Read

y

/api/v2/events/data/infrastructure

Read

y

/api/v2/events/data/network

Read

y

/api/v2/events/data/page

Read

y

/api/v2/events/dataexport/events/alert

Read

x

x

x

x

x

/api/v2/events/dataexport/events/application

Read

x

x

/api/v2/events/dataexport/events/audit

Read

x

/api/v2/events/dataexport/events/connection

Read

/api/v2/events/dataexport/events/incident

Read

/api/v2/events/dataexport/events/infrastructure

Read

x

/api/v2/events/dataexport/events/network

Read

x

/api/v2/events/dataexport/events/page

Read

x

/api/v2/events/dataexport/alerts/uba

Read

/api/v2/events/dataexport/alerts/securityassessment

Read

/api/v2/events/dataexport/alerts/quarantine

Read

/api/v2/events/dataexport/alerts/remediation

Read

/api/v2/events/dataexport/alerts/policy

Read

/api/v2/events/dataexport/alerts/malware

Read

/api/v2/events/dataexport/alerts/malsite

Read

/api/v2/events/dataexport/alerts/compromisedcredential

Read

/api/v2/events/dataexport/alerts/ctep (or ips)

Read

/api/v2/events/dataexport/alerts/dlp

Read

/api/v2/events/dataexport/alerts/watchlist

Read

/api/v2/policy/urllist/file

Read + Write

/api/v2/policy/urllist

Read + Write

x + y

/api/v2/policy/urllist/deploy

Read + Write

x + y

/api/v2/incidents/uba/getuci

Read + Write

x + y

/api/v2/ubadatasvc/user/uci

Read + Write

x + y

/api/v2/services/cci/app

Read

x + y

/api/v2/services/cci/domain

Read

x + y

/api/v2/services/cci/tags

Read

x + y

x: Required API scopes for the corresponding CE module if modern /events/dataexport endpoints will be used (recommended).

y: Required API scopes for the corresponding CE module if legacy /events/data endpoints will be used (deprecated starting in 4.1.0).

x+y: Required API scopes for the corresponding CE module (when using either /events/dataexport or /events/data endpoints).

v1 REST API Scopes

Endpoint

Privilege

Log Shipper (CLS)

Ticket Orchestrator (CTO)

Threat Exchange (CTE)

User Risk Exchange (URE)

App Risk Exchange (ARE)

Notes

Token Generated and Not Expired

(all)

y

Required for sharing file hashes

v2 REST API Scopes

Endpoint

Privilege

Log Shipper (CLS)

Ticket Orchestrator (CTO)

Threat Exchange (CTE)

Cloud Risk Exchange (CRE)

Notes

/api/v2/events/data/alert

Read

y

y

y

y

/api/v2/events/data/application

Read

y

/api/v2/events/data/audit

Read

y

/api/v2/events/data/infrastructure

Read

y

/api/v2/events/data/network

Read

y

/api/v2/events/data/page

Read

y

/api/v2/events/dataexport/events/alert

Read

/api/v2/events/dataexport/events/application

Read

/api/v2/events/dataexport/events/audit

Read

/api/v2/events/dataexport/events/connection

Read

/api/v2/events/dataexport/events/incident

Read

/api/v2/events/dataexport/events/infrastructure

Read

/api/v2/events/dataexport/events/network

Read

/api/v2/events/dataexport/events/page

Read

/api/v2/events/dataexport/alerts/uba

Read

/api/v2/events/dataexport/alerts/securityassessment

Read

/api/v2/events/dataexport/alerts/quarantine

Read

/api/v2/events/dataexport/alerts/remediation

Read

/api/v2/events/dataexport/alerts/policy

Read

/api/v2/events/dataexport/alerts/malware

Read

/api/v2/events/dataexport/alerts/malsite

Read

/api/v2/events/dataexport/alerts/compromisedcredential

Read

/api/v2/events/dataexport/alerts/ctep (or ips)

Read

/api/v2/events/dataexport/alerts/dlp

Read

/api/v2/events/dataexport/alerts/watchlist

Read

/api/v2/policy/urllist/file

Read + Write

/api/v2/policy/urllist

Read + Write

y

/api/v2/policy/urllist/deploy

Read + Write

y

/api/v2/incidents/uba/getuci

Read + Write

y

/api/v2/ubadatasvc/user/uci

Read + Write

y

/api/v2/services/cci/app

Read

/api/v2/services/cci/domain

Read

/api/v2/services/cci/tags

Read

y: Required API scopes for the corresponding CE module.