!!Dropbox
\\
__Dropbox Integration Overview__: Dropbox REST API based integration. ([Documentation Link|https://www.dropbox.com/developers/documentation/http/documentation])\\
\\
__!!! 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 Dropbox Developer Portal: [Dropbox My apps Link|https://www.dropbox.com/developers/apps?_tk=pilot_lp&_ad=topbar4&_camp=myapps]\\
 \\
 Click on the __Create App__ button:\\
•	Choose the appropriate API.\\
•	Choose the type of access:\\
- Full Dropbox (access to the entire Dropbox)\\
- App Folder (access only to an app-specific folder)\\
•	Name your app and click Create App.\\
•	Once the app is created, you’ll be redirected to the app settings page.\\
•	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] the __Redirect URL__ must be added in the following format:
{{{
https://www.your.crushftp.com/SSO_OIDC/
}}}
 \\
[attachments|dropbox_api_registration.png]\\
\\
 Grant __Permissions__ for __Your Dropbox API__ Key. Click Submit to save your changes.\\
[attachmentsApp permis|dropbox_permissions.png]\\
\\
[Dropbox Integration/personal_account_permissions.png]\\
\\
__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 Integration/business_acount_team_permissions.png]\\
\\ 
Now that the API is enabled, and your credentials are setup, and your redirect domain is configured, you can use the credentials in CrushFTP to get your Dropbox auth token and get access.\\
In the User Manager, add a new remote VFS item type and set the protocol to be "Dropbox".\\
Take your Dropbox App key and App secret and combine them together with a tilde as separator:\\
\\
{{{
ap_key: ew7XXXXXXXXXXo6o
ap_secret: by78XXXXXXXvW4h
}}}
results in:
{{{
ew7XXXXXXXXXXo6o~by78XXXXXXXvW4h
}}}
\\
That entire string will serve as your __Username__ for Dropbox://.\\
Paste it into the Username field, then click __Get Access Token__ to complete the configuration.\\
[attachments|dropbox_vfs_before_setup.png]\\
\\
Grant access to CrushFTP in the newly displayed form.\\
[attachments|dropbox_allow_app.png]\\
\\
For __Dropbox Business Accounts (!!!)__:\\
__ Dropbox Business User Email: __Enter the team member’s email address associated with the __Dropbox Business__ account. Team folders will be accessed on behalf of this user.\\
\\
The password should be filled in, and you can proceed to test the connection:\\
[attachments|dropbox_vfs_registration_finish.png]\\