How to set up the Dropbox Dash Connector for Atlassian Confluence

Overview

The Dropbox Dash connector for Atlassian Confluence lets you to search for and receive answers about their content on Dash. You can get answers to your queries directly from Dash or access your content on Confluence, redirected from Dash results with a simple click. By setting up the Dropbox Dash connector for Confluence, administrators enable sync of an organization’s Confluence content with Dash.

Service account requirements

The Dropbox Dash connector for Atlassian Confluence relies on a Confluence administrator authenticating and authorizing a company-level connector between a company’s Confluence platform and Dropbox Dash. As a better security practice and to avoid disruption between the Confluence platform and Dash integration (for example, in the event of an admin leaving the company), it’s strongly recommended that you create a non-human admin service account in Confluence specifically used to integrate with Dash.

Overview of set up:

Step 1: Create a new admin service account in Confluence.

Step 2: Connect Confluence to Dropbox Dash using the service account.

1. Log in to Confluence with your admin credentials.
2. Click the gear icon in the upper right to open the Confluence administration menu.
3. Click User management in the left sidebar.
4. Click Directory.
5. Click Users.
6. Click the Invite users button.
7. Type the email address for the service account user in the Invite by email address… field.

8. In the Product roles dropdown menu for Confluence, check User to remove that role.
9. Check Product admin.  
10. Click the Invite users button.
    • You’ll be returned to the Atlassian admin page for Users and should see “svc-dropboxdash-atlassian-confluence” as an invited user.
11. Open the email account for the user “svc-dropboxdash-atlassian-confluence” and locate the invitation to Confluence.
12. Click the Accept Invite button.
13. In the pop-up window, type “svc-dropboxdash-atlassian-confluence” in the Full name field.
14. Type a new password in the Password field.
    • Note the password somewhere safe, such as your password management vault.
15. Click the Continue button.
16. You'll be asked to select a role that best describes your team's work. Select an option appropriate from the dropdown menu and click Finish.

How to connect Confluence to Dropbox Dash using the service account

1. Log in to dropbox.com with your admin credentials.
2. Click Admin console in the left sidebar.
3. Click Dash in the left sidebar.
4. Click Apps.
5. Click the More apps tab.
6. Click +Add to the right of the Confluence connector.
7. Click Continue.
   • In the pop-up menu, you’ll be prompted to authenticate with Atlassian.
8. Type the email address for the “svc-dropboxdash-atlassian-confluence” service account.
9. Click the Continue button.

11. Type the password for the “svc-dropboxdash-atlassian-confluence” service account.
12. Click the Log in button.

13. You’ll be presented with a list of permissions required by Dash. Click Accept.
    • You’ll see a confirmation pop-up that Confluence was connected.
14. Click the Your apps tab.
    • You should now see Confluence added as a connector.