The information in this article applies to admins on Dropbox Dash.
There are two methods to authorize the connection between Microsoft 365 products (OneDrive, SharePoint, Teams files) and Dash:
Notes:
2. Authenticate with a service account: Create an admin account for accessing Microsoft OneDrive content to allow authorization between Dash and Microsoft OneDrive.
Follow the instructions below for the method that best works for your organization.
9. Review the steps in What to expect, then click Next.
10. Click Azure portal and log in with your credentials.
At this point, you’ll need to create a new app registration in Microsoft Azure before you can continue with the prompts in Dash.
To create a new app registration in Microsoft Azure:
2. Click Manage in the left sidebar, then click App registrations in the expanded list.
3. Click ① New registration.
5. Under Supported account types, select Accounts in this organizational directory only.
6. Under Redirect URI (optional), click Select a platform, then select Web.
7. Paste the following address into the empty field: https://www.dropbox.com/oauth_connectors/redirect
8. Click Register.
Once you’ve registered Dash in Microsoft Azure, you’ll need to add the appropriate certificates and permissions.
To add a certificate:
2. Create a private key for secure authentication between Microsoft OneDrive and Dash.
----BEGIN PRIVATE KEY---- [Your private key content] ----END PRIVATE KEY----
To add API permissions:
5. Click Add permissions after you’ve made your selections.
6. Click Grant admin consent for [tenant name].
7. Click Yes after reviewing the Grant admin consent confirmation prompt.
8. Return to the Dash overview page in Microsoft Azure.
Finally, you’ll need to enter the Dash IDs from Microsoft Azure to the Dash admin console.
To do this:
2. Click Next.
3. Copy the Application (client) ID and the Directory (tenant) ID from Microsoft Azure, then paste them in the prompt in Dropbox Dash.
4. Click Next.
5. Click Certificates and secrets in the left sidebar in Microsoft Azure.
6. Copy the Thumbprint, then paste it into the Certificate thumbprint field in Dropbox Dash.
7. Enter the private key associated with the certificate you uploaded to Azure.
8. Click Next.
9. Review the requested permissions in the pop-up window, then click Allow.
10. Return to the admin console page on dropbox.com where you’ll find the Ready to Sync prompt.
11. If you’d like to exclude specific drives from syncing to Dropbox Dash, click Select under Exclude content, then follow the steps in the section “How to exclude drives when connecting Microsoft 365 to Dropbox Dash” below. Otherwise, proceed to step 12.
12. Click Start syncing.
Your Microsoft OneDrive content will start syncing immediately. This can take anywhere from a few hours to a few days, depending on how much content is in your account. Dash admins will receive an email when all content has been synced.
Service account requirements
To connect Microsoft OneDrive to Dropbox Dash, a Microsoft Global administrator must authenticate and authorize a company-level integration between Confluence and Dash. For better security and to prevent issues with the Microsoft OneDrive and Dash integration (like if an admin leaves), it's recommended to create a non-human admin service account in Microsoft Entra ID for this integration.
More information along with naming convention recommendations for service accounts can be found in the Service account recommendations for SaaS service integrations with Dropbox Dash document.
Note: For this article, “svc-dropboxdash-microsoft-365” is referenced as the recommended account name for the service account.
Overview of setup:
Step 1: Create a new admin service account.
Step 2: Connect Microsoft OneDrive to Dropbox Dash using the service account.
How to create an admin service account for the Dropbox Dash integration
3. Click Manage on the left sidebar.
4. Click Users in the dropdown menu.
5. Click New user.
6. Click Create new user in the dropdown menu.
7. Enter “svc-dropboxdash-microsoft-365” in the user principal name (UPN) field.
8. Open the dropdown menu under User principal name to select the domain to which the user will be associated.
9. Leave Mail nickname as Derive from user principle name.
10. Enter “svc-dropboxdash-microsoft-365” in the Display name field.
11. Enter a new password in the Password field.
12. Leave Account enabled as checked.
13. Click Next: Properties at the bottom of the page.
14. Enter “svc-dropboxdash-microsoft-365” in the First name field.
15. Click Next: Assignments at the bottom of the page.
16. Click Add role to open the Directory roles pane on the right.
17. Enter “Global” in the search field.
18. Check the Global Administrator role for this service account user.
19. Click Select at the bottom of the page.
20. Click Next: Review + create at the bottom of the page.
21. Verify that the User principal name is “svc-dropboxdash-microsoft-365”.
22. Verify that the assigned role is Global Administrator.
23. Click Create to complete user creation.
Refresh the page to see your new service account.
Once your service account is created, you can connect Microsoft OneDrive to Dropbox Dash.
How to connect Microsoft OneDrive to Dropbox Dash using the service account
To connect Microsoft OneDrive to Dropbox Dash using your service account:
10. Click Next.
11. Click Allow.
12. Enter the email address for the service account created in the previous steps.
13. Click Next.
14. Enter the password for your service account.
15. Click Sign in.
Note: If you require multi-factor authentication (MFA) for accounts in your environment, you may be prompted for additional authentication associated with the service account.
16. Review the permissions requested, then click Accept.
17. Return to the admin console page on dropbox.com where you’ll find the Ready to Sync prompt.
18. If you’d like to exclude specific drives from syncing to Dropbox Dash, click Select under Exclude content, then follow the steps in the section “How to exclude drives when connecting Microsoft 365 to Dropbox Dash”. Otherwise, proceed to step 19.
19. Click Start syncing.
To exclude specific drives from syncing during setup:
To manage excluded drives:
Private keys are used to establish trust between Dropbox Dash and Microsoft. When you upload a public key, Dash uses a private key to sign requests to Microsoft. This way, Microsoft can determine if the private key is paired with the public key you uploaded.
Encrypting a private key prevents it from being used for tasks like encryption or decryption. Therefore, we must use the unencrypted private key to sign requests.
Yes, thanks!
Not really
Let us know how why it didn't help:
Thanks for letting us know!
Thanks for your feedback!
