Creating a Box Connector

Managing API client access to Box

The Certero connector for Box uses Box’s APIs to connect and retrieve data.  The Box APIs use industry standard OAuth 2.0 protocols for authentication and authorization.

For more information on what OAuth is and how this flow works between an endpoint server and Box, please see the following link:

OAuth 2.0 Auth - Box Developer Documentation

To setup a connection between Certero and Box, the customer will first need to ensure they have created an application in the Box Developer Console.

Note: The Box connector inventory will only connect and work correctly when it is run against a paid Box account. Running the inventory fails when you run it against a free account.

Creating an app within the Box Developer Console

A Box app is required to allow Certero to access data.  If the customer has multiple Box accounts the following process will need to be completed for each account.

1. Sign in to Box.

2. Click “ Dev console ” in the menu on the left-hand side of the screen:

3. Click the “ Create new app ” button:

4. Click the “ Custom app ” button:

5. In the dialog box that appears, select User authentication (OAuth 2.0) , enter a name for the app and click the “ Create app ” button:

6. Under the Configuration tab (which should now appear), note the “ Client ID ” and “ Client secret ” as these will be needed to configure the connector. The secret can be seen by clicking Copy:

7. Set the OAuth 2.0 redirect URI (just below the Client secret) to https://cc.certero.com/cmp/AuthorizeBoxConnector

8. Below that set the Application scopes to turn off all content actions and enable management of groups, users and enterprise properties, then click “ Save changes ”:

Create a new Box connector

Enable the feature for the Endpoint Server

1. In Certero > Administration > Endpoint Servers , right click on the endpoint server the Box that will run the Box connector and choose properties.

2. Click on the Features button.

3. Ensure that the Box connector is ticked:

4. Click the Save button.

Create a Box connector

1. In Certero > Connectors > Box click the New button.

2. Give the connector a name and, if required, a description.

3. Enter the Client ID and Client secret for the app generated previously.

4. Click the Authorize button.

5. A browser window will appear asking you to login. Enter your Box username and password, then click the Authorize button.

6. Click the “ Grant access to Box ” button.

7. A token will be displayed. Copy this into the Token field in the connector setup dialog:

8. Set the schedule for the connector.

9. Click Save .