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: 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.

  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.

    Screen Shot 2021-03-17 at 1.01.00 PM.png
  5. Click Fetch Client Secret and make note of Client ID, and Client Secret, as you only see it 1 time.

    Screen Shot 2021-03-17 at 5.07.44 PM.png
  6. Select the app access level as App + Enterprise Access.

    Screen Shot 2021-03-17 at 1.02.13 PM.png
  7. Select the following application scopes:

    • Read all files and folders stored in Box.

    • Manage enterprise properties.

      Screen Shot 2021-03-17 at 1.02.40 PM.png
  8. On the Authorization tab, Review and Submit the app for authorization.

    Screen Shot 2021-03-17 at 1.08.32 PM.png
  9. The app status now reads Pending Authorization.

    Screen Shot 2021-03-17 at 1.09.07 PM.png
  10. Authorize the app through email or sign in to your Admin Console and click Apps from the top left side of the page.

    Screen Shot 2021-03-17 at 2.19.06 PM.png
  11. Under Custom Apps, find the app that was submitted and select Authorize App.

    Screen Shot 2021-03-17 at 5.55.42 PM.png
  12. Navigate to Account & Billing from the top left side of the page and take note of your Enterprise ID.

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

Step 2: Configure the technology in 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.