Dropbox

How to configure Dropbox connection to scan it.

• 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.

  

• 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 setproper 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.

• 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