Connect Qevlar to Netskope to investigate alerts with cloud-traffic context across SaaS, IaaS, and web. This page lists the API permissions Qevlar requires and how to grant them.
Overview
Qevlar authenticates to Netskope with a REST API v2 token sent as a bearer token — no user sign-in per request. Access is governed by the endpoint privileges granted to the token. The connector is read-only.
| API | Purpose | Auth |
|---|---|---|
| Netskope REST API v2 | Read alert, network, and page events | API token |
The API base is your Netskope tenant URL.
Connection details
Enter these values when configuring the connector in Qevlar:
| Field | Where to find it | Required |
|---|---|---|
| Tenant URL | Your Netskope tenant URL, e.g. https://<tenant>.goskope.com | Yes |
| API Token | Settings → Tools → REST API v2 → New Token | Yes |
Required permissions
Create a REST API v2 token with read access to the events data-search endpoints. Read on /api/v2/events/datasearch/alert is required, to retrieve Netskope alerts. Read on /api/v2/events/datasearch/network and /page is recommended, for richer network and page event context. No write privileges are required.
Setup
- Open REST API v2 tokens. In the Netskope console, go to Settings → Tools → REST API v2.
- Create a token. Add a new token and grant read access to the
/api/v2/events/datasearch/endpoints — at minimumalert(required), plusnetworkandpage(recommended). - Record the token. Copy it immediately — it is shown only once.
- Get the tenant URL. Use your Netskope tenant URL.
- Configure the connector. In Qevlar, add the Netskope connector and enter the connection details above.
Verify the connection
After saving, Qevlar runs a health check that reads one alert event. If it fails, check, in order:
- The token has read access to the events data-search endpoints.
- The token is valid and has not been revoked.
- The Tenant URL is correct.
API reference
| Operation | HTTP | Endpoint |
|---|---|---|
Read events (health check uses alert) | GET | {tenantUrl}/api/v2/events/datasearch/{eventType} |
Auth header: Authorization: Bearer <token>.