Overview
This guide provides instructions for integrating Netskope's Next Gen Secure Web Gateway (SWG) with the Right-hand HRM platform. After completing this integration, Netskope data will be accessible via the Right-hand HRM platform tab in your Right-hand Cybersecurity console. This data can be used for real-time coaching and understanding your Human Risk.
Important Update: Netskope Connector in Error State
When you visit the HRM Settings page, you may notice that the Netskope connector has entered an error state.
This is due to recent updates we’ve made to the Netskope connector implementation, which now requires an updated permission for the API key to ingest past logs.
Required API Permission (Updated):
New endpoint: /api/v2/events/data/alert
(This replaces the previously used endpoint:
/api/v2/events/dataexport/events/alert)
What You Need to Do:
To resolve the issue, you’ll need to update the API key permissions. We recommend generating a new API key and completing the setup by following the steps in our Netskope Integration Guide.
Prerequisites
Before setting up the integration in your Right-hand Cybersecurity console, you'll need to:
Create a Netskope API token
Obtain your Netskope tenant name
Creating Your API Token
To generate a Netskope API token:
Sign in to your Netskope console
Navigate to Settings > Tools > REST API v2
Click the pencil icon beneath REST API Status
Enable the token by toggling the status switch to ON, then click Save
Click New Token to create a new API token
Complete the following fields in the Create REST API Token dialog:
Token Name: Enter a descriptive name (e.g., RightHand-V2-Token)
Expire In: Select your preferred token validity period (hours, days, weeks, or months)
Add Endpoint: Select the
/api/v2/events/data/alertendpoint
Click Save
Click Copy Token and store it securely for later use
Obtaining Your Netskope Tenant Hostname (URL)
You'll need to copy your tenant URL from your Netskope portal. The URL typically follows this format:
<account name>.goskope.<rest of the url>
Note down this complete URL as you'll need it when configuring the integration.
EXAMPLE:
For the account snippet below the url to be copied is alliances.eu.goskope.com.
Setting Up the Integration
New Integration Setup
To configure the integration in your Right-hand Cybersecurity console:
Log in to your Right-hand Cybersecurity console
Navigate to Right-hand HRM platform > Settings > Security Vendor Integrations
Find Netskope in the list and click Configure
Enter your previously saved Tenant Hostname(URL) and API Token
Click Authorize