Dropbox

Dropbox is a cloud storage service that allows users to store files online and access them from any device with an internet connection. For detailed information, please refer to the Dropbox’s official documentation.

Integration Method: API

Tables: Detection Finding (2004), User Inventory (5003), File Hosting Activity (6006), Authentication (3002)

This integration supports the following events.

This integration supports the following versions.

Prerequisites

• The user should have Dropbox Business plan to get Members and Team events.

• The app which we create for OAuth credential should have team_data.member, members.read, events.read permissions to get Members and Team events.

• The user should have access to the DataBee console.

Configuration Overview

1. Create an App in the App console with the required permissions.

2. Add the Dropbox data feed in the DataBee console with the below parameters.

   DataBee Parameter	Dropbox Parameter
   Client Key	App key
   Client Secret	App secret
   Authorization Code	Access code

Dropbox Configuration

Register an app in Dropbox app console

To get access to Dropbox API first we need to create an App. To create an app, follow the steps below.

1. Access the Dropbox app console. On the log in page enter your Dropbox log in credentials.
    
   

2. Click on Create app.
    
   

3. Select the configuration below while creating the app.

   • Choose an API:  Scoped access New

   • Choose the type of access you need:  Full Dropbox

   • Name your app: enter the Unique name of your app.

4. Click on Create app.
    

Add permissions to app

We require enough permissions to get Members and Team event data. To add permissions to app, follow the below steps.

1. Once app is created, click on Permissions tab shown below.
    
   

2. Select the below required permissions and click on Submit button.

   • team_data.member

   • members.read

   • events.read
      
     
      

Get App key and App secret

1. Click on Settings tab.
    
   

2. Store the App key and click Show to reveal the App secret. Save both for later use during DataBee configuration and when generating the Authorization code.
    
   
    
   

Generate Access Code

1. Access the Dropbox OAuth Authorize Page. Replace <client_id> with the App key obtained in the previous step, then click Continue.
    

2. Click on Allow.
    
   

3. After clicking on allow we will get the Access code that we need to add during DataBee configuration.
    

DataBee Configuration

1. Login to the DataBee UI, navigate to Data > Data Feeds and click the Add New Data Feed button.
    

2. Search for the Dropbox and click it as shown below
    

3. Click on the API Ingest option for collection method.
    

4. Enter feed contact information and click Next.
    

5. In the configuration page, confirm the following:

   • Authorization Method: OAuth2

   • API Base URL: this is the base URL that DataBee will interact with.

   • Client Key: paste the App key obtained in the Dropbox app console.

   • Client Secret: paste the App secret obtained in the Dropbox app console.

   • Authorization Code: paste the Access Code which we have generated previously.

   • Token URL: this is the token URL which will be used to generate tokens.

   • Event Types: preselected for all the event types that integration pulls.

   

6. Click Submit.

Troubleshooting Tips

• If you are facing an invalid grant or code has already been used error this might be possibly due to Access code having been used multiple times. In that case generate a new authorization code and reconfigure the DataBee feed. Ensure the client key, client secret are pasted correctly.

• If you are facing 400 response codes with error Your app is not permitted to access this endpoint this might be possibly due to missing permissions. Ensure that all the required permissions to the app are granted correctly as per the above-mentioned steps.