Netskope Help

Enable Box Event Stream

Box has introduced a new feature called Box Event Stream also known as Box Fast Push Notification. There are a couple of benefits of using Even Stream:

  • Improved performance for ongoing policy processing: By moving from polling to event notifications, and with the details provided by Box Event Stream notifications, Netskope can process events much faster than with the traditional polling mechanism.

  • Reduced volume of API calls: Netskope significantly initiates a smaller number of API calls to your Box account. Moving to Event Stream reduces the contention among apps competing for the same API quota (e.g. scripted infrastructure running under a common admin account).

Customers can leverage the Box Event Stream capability by authorizing the Netskope Event Stream app in the Box admin console. To do so, follow the steps below:

  1. Log in to your Box account using the admin account and go to the Admin Console.

  2. Ensure that the Netskope Introspection app is installed as described in Authorize Netskope Introspection App on Box Enterprise.

  3. If you are granting access to API Data Protection as a co-admin, select a co-admin user from the list of users and enable the permissions for the co-admin as mentioned in steps 4-6. If you are granting access to API Data Protection as an admin, skip steps 4-6 and proceed to step 7.

    Note

    Only an enterprise admin user has the right to enable permissions for a co-admin user.

  4. Navigate to Users and Groups BoxUserIcon.png > Managed Users in the top menu bar. Click a co-admin user from the list.

  5. In the Edit User Access permissions section, select the permissions to grant the co-admin, and then select the Co-Admin checkbox to grant additional administrative privileges. Under Reports and Settings, enable the following permissions:

    • View settings and apps for your company: Enable this permission to allow the co-admin to grant Netskope to access your Box account.

    • Edit settings and apps for your company: Enable this permission to allow the co-admin to install and authorize the JWT and Event Stream app.

    BoxUserAccess.png
  6. Click Save.

    If you are authorizing as co-admin, log in as co-admin and proceed to the next steps.

  7. Navigate to Admin Console > Apps > Custom Apps and click Authorize New App. Under Client ID, enter the API key of the Netskope Event Stream application. There are four API keys. Based on the management plane (MP) location of your tenant, enter the appropriate key:

    • If your Netskope tenant is based out of the SV5 MP (<tenant-name>.goskope.com), the API key is:

      rs4wjqnbfd58lwb2kxrd3kktpyeb3wnc
    • If your Netskope tenant is based out of the SJC1 MP (<tenant-name>.goskope.com), the API key is:

      o7t65264vygg5wflcafepoxfbpxt6rzq
      
    • If your Netskope tenant is based out of the AM2 MP (<tenant-name>.eu.goskope.com), the API key is:

      xai82jadyoko9rgjmbgyznk9krn82srj
    • If your Netskope tenant is based out of the FR4 MP (<tenant-name>.de.goskope.com), the API key is:

      9fp3ciu1ytrcctzyh5bs4gi49m2vfjwf
    • If your Netskope tenant is based out of the MEL2 MP, (<tenant-name>.au.goskope.com), the API key is:

      wcd7s55affmqfoj1mmje2anin0979exe

    Note

    If you are not sure of the MP location of your tenant, contact your sales representative or Netskope support.

  8. Click Next and Authorize.

    Important

    Once you have authorized the Netskope Event Stream application, you should see the application under the Custom Apps tab. If the application is disabled, click the more options (...) icon, click Enable app authorization, then Enable.

  9. On the Custom Apps tab, click Settings.

    The Global App Settings pop-up window opens.

  10. If the Disable unpublished apps by default option is enabled, enter the MP-specific client ID under the exception list and click Save.