Dropbox Integration Setup

Getting Started

BalkanID recommends creating a separate service account for the purposes of this integration, instead of using personal or employee named accounts.

Requirements:

• Client ID

• Client Secret

• Initial Access Code

Steps to obtain credentials

1. Once you have a dropbox enterprise account, you’ll need to create a scoped application. Visit https://www.dropbox.com/developers/apps and create a new app.

   
2. Choose options according to the images below:

   
3. Select the following individual scopes:

   
4. Select the following team scopes.

   
5. We have configured our dropbox app.

6. We will need to populate the client_id, client_secret and initial_auth fields, for client_id and client_secret we’ll need to visit the dropbox app console at https://www.dropbox.com/developers/apps.

   
7. Now for the initial_auth value, we’ll need to visit an auth URL. https://www.dropbox.com/oauth2/authorize?client_id=`client_id`&token_access_type=offline&response_type=code.

   
8. In the above url copy the url and add your client id value and visit the url, you’ll be asked for consent and be shown the permission scopes. at the end you’ll receive an auth token which you’ll add to the initial_auth value.

Note: You’re supposed to leave refresh_tokenfield empty while configuring the BalkanID tenant as the script will populate it on its own.

Configure Dropbox within your BalkanID tenant

1. Login to the BalkanID application and switch to the tenant you would like to add your integration to.

2. Head to Integrations > Third Party Applications and click Add Integration, select Dropbox. Set up the Primary Application owner and the Description, if any.

   
3. Dropbox would have been added to the list of applications. Click on the Configure and Integrate button beside the integration name, and configure the fields with the values that were noted prior. It should look like this:

   
4. Once you filled in the information, click Save changes. Your integration is now configured and you will see the status of the integration displayed alongside other integrations on the Integrations page. Integrations are synced daily. When data is available, the integration Status column will read Connected and the integration Message will read Data available.