Having read-only access to the interface of your technology allows Expel to dig deeper when performing incident investigations. Our device health team uses this access to investigate potential health issues with your tech.
Step 1: Generate API Credentials
To integrate the technology with Expel, we need to create secure credentials to the API. Depending on the permissions allowed in Step 1, Expel may be able to generate API credentials. If you're unsure, reach out to your Expel Customer Success Engineer, or email firstname.lastname@example.org.
Netskope REST APIs use an auth token to make authorized calls to the API. Expel uses Netskope REST APIs to access resources via URI paths.
- In the Netskope UI, navigate to Settings > Tools > Rest API v2.
- On the REST API v2 page, click New Token.
- Enter Expel for token name, choose a token expiration time that fits in your company's policy, and then click Add Endpoint to select the API endpoints to use with the token.
- Specify READ privileges for API endpoint api/v2/events/data/alert.
- When finished, click Save.
- A confirmation box opens showing whether the token creation was a success. If so, click Copy Token to save it for later use. Note: The only opportunity to copy the token is immediately after you create it.
- When finished, click OK.
Step 2: Configure the technology in Workbench
Now that we have all the correct access configured and noted the credentials, we can integrate Netskope with Expel Workbench.
Register device in Expel Workbench
- In a new browser tab, log into https://workbench.expel.io.
- On the console page, navigate to Settings and click Security Devices.
- At the top right of the page, select Add Security Device.
- Search for and select your technology Netskope.
- Complete all fields using the credentials and information you collected in Step 1.
- For Name type the hostname of the device.
- For Location type the geographic location of the appliance.
- For URL type your Netskope URL.
- For API key type the API generated in Step 1.
- Click Save.
After a few minutes, refresh the Security Devices page and you see your device status reporting as Healthy, or if there is an issue, you see details of what the issue may be.
To check if alerts are coming through, navigate to Alerts on the console page. Click the icon in the upper right to switch to grid view, then check the list for device alerts.