Skip to main content
 

Tip

This article was accurate at the time of writing, but changes happen. If you find the instructions are outdated, leave a description in the comment field below and let us know!

Step 1: Generate API Credentials

Netskope REST APIs use an auth token to make authorized calls to the API. Expel uses Netskope REST APIs to access resources through URI paths.

Note

Before you begin, reach out to Netskope to enable REST API v2.

  1. In the Netskope UI, navigate to Settings > Tools > Rest API v2.

  2. On the REST API v2 page, click New Token.

  3. Type Expel for token name, select 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.

  4. Specify READ privileges for API endpoint api/v2/events/data/alert.

  5. A confirmation 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.

  6. Confirm that the area at the top of the screen referencing REST API Status shows that it is enabled.

    mceclip0.png

Step 2: Configure the technology in Workbench

  1. In a new browser tab, log into https://workbench.expel.io/settings/security-devices?setupIntegration=netskope.

  2. Complete all fields using the credentials and information you collected in Step 1.

    mceclip1.png
    • For Name type the host name 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.