1. Expel Support Center
  2. Connect your technology
  3. SaaS integrations

Box setup for Workbench

  • Updated

This article explains how to connect your Box to Workbench.

In this article

Step 1: Enable API access for Workbench

To integrate the technology with Workbench, we need an enterprise admin on hand with access to Developer Console and Admin Console to build and authorize a Custom App. If you're unsure, reach out to your customer success engineer or email devicehealth@expel.io.

Having read-only access to the interface of your technology allows Expel to dig deeper during incident investigations. Our device health team uses this access to investigate potential health issues with your tech.

Note

Expel secures all login information our SOC analysts need about your devices in a MFA password product. Access to this login information is protected using our internal MFA processes. To learn more about the IP addresses all Expel traffic comes from, go here.

  1. Sign in to your Developer Console.

  2. Select Create New App.

  3. Select Server Authentication (Client Credentials Grant).

  4. Name your custom app Expel App and click Create App.

  5. Click Fetch Client Secret and make note of Client ID, and Client Secret, as you only see it 1 time.

  6. Select the app access level as App + Enterprise Access.

  7. Select the following application scopes:

    • Read all files and folders stored in Box.

    • Manage enterprise properties.

  8. On the Authorization tab, Review and Submit the app for authorization.

  9. The app status now reads Pending Authorization.

  10. Authorize the app through email or sign in to your Admin Console and click Apps from the top left side of the page.

  11. Under Custom Apps, find the app that was submitted and select Authorize App.

  12. Navigate to Account & Billing from the top left side of the page and take note of your Enterprise ID.

Step 2: Configure the technology in Workbench

Now that we have the correct access configured and noted the credentials, we can integrate your tech with Workbench.

  1. Log into https://workbench.expel.io.

  2. Navigate to Settings > Security Devices.

  3. At the top of the page, click Add New Device.

  4. Search for and select Box.

    Screen Shot 2021-03-17 at 6.56.18 PM.png

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

  5. Click Save.

You can see if the device is healthy on the Security Devices page. It may take a few minutes to see the device listed as healthy.

To check if alerts are coming through, navigate to the Alerts Analysis page. Scroll to the device you want to check and click View alerts. Switch to grid view, then check the list for device alerts. It can take 36 to 72 hours for alerts to appear after setup, as we tune your device.

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!

  • Was this article helpful?

  • 0 out of 0 found this helpful

Related articles