Managing API client access to Dropbox for Business

The Certero connector for Dropbox for Business uses Dropbox’s APIs to connect and retrieve data from Dropbox.  The Dropbox 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 Dropbox, please see the following link:

Dropbox OAuth2 Overview

To setup a connection between Certero and Dropbox, the customer will first need to ensure they have created an application in the Dropbox admin centre to allow the Certero for Cloud Dropbox connector to access data.

Optional:  Create a free trial Dropbox for business account

1. Use this site to generate a random email address. E-mails sent to the generated e-mail address automatically open at the bottom of the page. Required to respond to the Dropbox verification e-mail.

2. Set up a free trial of Dropbox for business here using the generated email as the login.

3. With the new account set up add some team members and groups.

4. Click on the Dropbox Icon:

5. Click on the Admin Console menu option.
You will now be able to access the Members and Groups menu options:

6. Add some members and then add them to groups.

Creating an app within the Dropbox Developer Console

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

1. Sign in to Dropbox developer console ( Developers - Dropbox ).

2. Click “ App console ” top right of the screen or “Create app” centre of the screen

3. Click the “ Create app ” button:

4. Select the following:

1. Choose an API – Scoped access New

2. Choose the type of access you need - Full Dropbox– Access to all files and folders in a user's Dropbox.

3. Name your app – Enter a name for the app. i.e. ‘Certero’

5. Click the “ Create app ” button:

On the ‘Settings’ tab of the application configuration page enter the following link https://cc.certero.com/cmp/AuthorizeDropboxConnector in the redirect URIs and click ‘Add’, next select ‘Disallow’ from the drop-down for ‘Allow public clients (Implicit Grant & PKCE)’, then select ‘No expiration’ from the drop-down for ‘Access token expiration’

Select the ‘Permissions’ and check the following boxes:

•  

  • Account Info: account_info.read

  • Team: team_info.read, team_data.member, members.read, groups.read, events.read

Click ‘Submit’ at the bottom of the page.

Create a new Certero Dropbox Connector

Enable the feature for the Endpoint Server.

1. In Certero > Administration > Endpoint Servers , right click on the endpoint server the Dropbox connector will be ran against and choose properties.

2. Click on the Features option.

3. Enable the Dropbox Connector row.

4. Click on Save:

Create a connector for Dropbox for Business.

1. In Certero > Connectors > Dropbox Connectors , click the ‘ New ’ button.

2. Copy the App Key from the ‘app settings’ page within the Dropbox admin console to the Client ID field.

3. Copy the App Secret from the ‘app settings’ page within the Dropbox admin console to the Client Secret field.

4. Click the Authorize button:

5. Click on Continue:

6. Click on Allow.

A Token is displayed:

7. Copy the Token value from the confirmation page to the Token in the connector dialog:

8. Click on Save.