Webmail is equipped with direct support for Dropbox, which allows your users to save file attachments to their Dropbox accounts, and to insert direct links to Dropbox files in outgoing messages. To provide this feature to your Webmail users, you must set up your Webmail as a Dropbox app on the Dropbox Platform. This is a simple process, requiring you only to sign in to a Dropbox account, create a unique name for an app with Full Dropbox access, specify the Redirect URI to Webmail, and change one default setting. Then, you will copy and paste the Dropbox App Key and App Secret from there to the options on this screen in MDaemon. After that your users will be able to link their Dropbox accounts to Webmail when they next sign in to Webmail. For step-by-step instructions on how to create your Dropbox app and link it to Webmail, see: Creating and Linking Your Dropbox App below.
When you create your Dropbox app it will initially have "Development" status. This allows up to 500 of your Webmail users to link their Dropbox accounts to the app. According to Dropbox, however, "once your app links 50 Dropbox users, you will have two weeks to apply for and receive Production status approval before your app's ability to link additional Dropbox users will be frozen, regardless of how many users between 0 and 500 your app has linked." This means that until you receive production approval, Dropbox integration will continue to work but no additional users will be able to link their accounts. Obtaining production approval is a straightforward process to ensure that your app complies with Dropbox's guidelines and terms of service. For more information, see the Production Approval section of the Dropbox Platform developer guide.
Once your Webmail app is created and configured properly, each Webmail user will be given the option to connect their account to their Dropbox account when they sign in to Webmail. The user is required to log in to Dropbox and grant permission for the app to access the Dropbox account. Then the user will be redirected back to Webmail using a URI that was passed to Dropbox during the authentication process. For security that URI must match one of the Redirect URIs (see below) you specified on your app's info page at Dropbox.com. Finally, Webmail and Dropbox will exchange an access code and access token, which will allow Webmail to connect to the user's Dropbox account so that the user can save attachments there. The exchanged access token expires every seven days, meaning that periodically the user must reauthorize the account to use Dropbox. Users can also manually disconnect their account from Dropbox, or reauthorize it when necessary, from the Cloud Apps options screen within Webmail.
Dropbox Integration
Enable Dropbox Integration
Once you have created your Dropbox app and linked it to Webmail, click this checkbox to allow your Webmail users to link to their Dropbox accounts. If you wish to enable or disable Dropbox on a per user basis, you can do so by adding "DropboxAccessEnabled=Yes (or No)" to the User.ini.
Dropbox app key and app secret
The App key and App secret are located on your app's info page at Dropbox.com. Enter them here to link Webmail to your Dropbox app.
Redirect URI
You must specify a Redirect URI on your app's info page at Dropbox.com. MDaemon automatically displays a URI here that you should be able to use there. You can, however, add multiple Redirect URIs. Therefore you could add a URI for each of your domains and even one for localhost, which might be used if signing in to Webmail from the machine on which the server is running.
For example:
https://mail.company.test/WorldClient.dll?View=OAuth&AuthRequest=Dropbox
https://example.com/WorldClient.dll?View=OAuth&AuthRequest=Dropbox
https://localhost/WorldClient.dll?View=OAuth&AuthRequest=Dropbox
Dropbox requires your Redirect URIs to be secure, therefore HTTPS must be enabled for Webmail.
Edit text of privacy policy
Click this button to edit the text file containing your Webmail App's privacy policy. Because Dropbox requires that an approved privacy policy be periodically presented to your users, a "Privacy Policy" link to the contents of this file is provided on the Connect to Dropbox page displayed to your users. That link opens a small window containing the text and a Download button that users can click to download the file. Use HTML code in the file if you wish to format the text or want it to contain any links.
Creating and Linking Your Dropbox App
Step-by-step instructions for creating your Dropbox app and linking it to Webmail.
