Dropbox#

Dropbox Integration Overview: Dropbox REST API based integration. (Documentation Link)

---

⚠️ Proxy Configuration: If your server accesses the internet through a proxy, make sure to whitelist the following domains for DropBox Authentication and storage access: api.dropboxapi.com

---

⚠️ Restrictions:
• No Resume Support for Uploads: The Dropbox REST API does not natively support resumable uploads for partially transferred files in a way that is compatible with CrushFTP’s integration capabilities.
• No Support for MDTM (File Modification Time) Changes: The API does not allow direct modification of a file’s metadata, including the file modification time (mdtm). When files are created or updated, the modification time is automatically managed by Dropbox.

---

Generate an API Key using the Dropbox Developer Portal: Dropbox My apps Link

Click on the Create App button:
1.) Choose the appropriate API.
2.) Choose the type of access:
- Full Dropbox (access to the entire Dropbox)
- App Folder (access only to an app-specific folder)
3.) Name your app and click Create App.
4.) Once the app is created, you’ll be redirected to the app settings page.
5.) Under the Settings tab, you’ll find your App key (API key) and App secret.

⚠️ The Redirect URL must be added in the following format:

 https://www.your.crushftp.com/?command=register_dropbox_api

It is important that the URL ends with ?command=register_dropbox_api, as required by the Dropbox integration process.

---

⚠️ Note: For CrushOIDC Plugin the Redirect URL must be added in the following format:

https://www.your.crushftp.com/SSO_OIDC/

It is important that the URL ends with /SSO_OIDC/, as required by the CrushOIDC integration.

---

⚠️ Grant Permissions for Your Dropbox API Key. Click Submit to save your changes.

---

Dropbox Business Account:

Grant the necessary permissions for team folders.
⚠️ Important:

• Only users with the Team Admin role can configure these settings.
  
• The members.read permission is required for Dropbox Business accounts.
  

---

DropBox Remote VFS settings:

Select the DropBox item type and click the Get Access Token button.



⚠️ Important: To obtain the Refresh Token, the CrushFTP WebInterface’s host and port must match the Redirect URL specified in the Dropbox Developer Portal. In our example, it was: https://your.crushftp.domain.com/

Enter the App Key , App Secret. Proceed with the authentication and authorization process.
⚠️ Important: Be sure to sign in with the Dropbox Account that has the necessary permissions, as configured in the Dropbox Developer Portal (mentioned above). This will automatically configure the User name and Password.



Grant access to CrushFTP in the form that appears after authentication. Review the requested permissions and click Allow (or the equivalent button) to authorize CrushFTP to access the necessary resources.



This will automatically configure the User name and Password:


⚠️ Dropbox Business Accounts:
Dropbox Business User Email: Enter the email address of the team member associated with the Dropbox Business account. All Team Folders will be accessed on behalf of this user.