Dropbox

Initial creation of Dropbox connector in Dashboard

• Navigate to Administration -> Data Sources -> Dropbox

  
• Then go to Credentials tab and click New credentials

• Create credentials name and copy the Redirect URL - it will be needed later. App Key and App Secret fields will be filled later once we Register a Dropbox App.

  

Registering a Dropbox App

• Login to Dropbox

• Go to Dropbox App Console and click Create app

• On the App Creation page enter below information and click Create app button

  • Choose an API: Most applications will use "Dropbox API"

    
  • Choose Access Type: Select "Full Dropbox" for complete access.

    
  • Name Your App and click Create app: Enter a name that will be visible to users.

    
• Go to the Settings tab and find app key and secret above the OAuth 2 section

  

  
• We need to set proper permissions for Dropbox app. Below you can find a list of required permissions:

  • For scanning

    • Files and Folders > files.metadata.read, files.content.read

    • Collaboration > sharing.read

    • Team Data > team_data.member

    • Members > members.read, groups.read

  • For remediations

    • Collaboration > sharing.write

    • Files and Folders > files.content.write

  • For tagging

    • Files and Folders > files.content.write, files.metadata.write

• Go to the Permissions tab of the newly created App and set the following:

  • Account Info: account_info.read

    
  • Files and Folders: files.metadata.write, files.metadata.read, files.content.write, files.content.read

    
  • Collaboration: sharing.read, sharing.write

    
  • Team: team_info.read

    
  • Team Data: team_data.member, team_data.content.write, team_data.content.read, files.team_metadata.write, files.team_metadata.read, files.permanent_delete

    

    
  • Members: members.read, groups.read

    
• Once permissions are set click Save button located on the black snackbar at the bottom of the window.

• Go back to Settings tab and scroll to Redirect URI section. Put here copied link from Dashboard and click Add

  
• Then copy App key from Dropbox App settings page and put it into App key field in Dashboard Create connection form. Similar action should be made for App secret.

Finishing creation of Dropbox connector in Dashboard

• Once done click Authorize with Dropbox button as below:

  
• Then you'll be redirected to 1st page to trust your application - click Continue

  
• Then you'll see a list of permissions app will be granted - click Allow

  
• Once done you'll be redirected back to Dashboard page with success message as below:

  
• Connection has been configured successfully