How to set up the Dropbox Dash connector for Jira
The information in this article applies to admins on Dropbox Dash teams.
The Dropbox Dash connector for Jira allows users to search for and receive answers about their content on Dash. Users can get answers to their queries directly from Dash or access their content on Jira, redirected from Dash results with a simple click. By setting up the Dropbox Dash connector for Jira, administrators enable sync of an organization’s Jira contents with Dash.
Service account requirements
The Dropbox Dash connector for Jira relies on a Jira administrator authenticating and authorizing a company-level connector between a company’s Jira platform and Dropbox Dash. As a better security practice, and to avoid disruption between the Jira platform and Dash integration (for instance in the event of an admin leaving the company), it’s strongly recommended to create a non-human admin service account in Jira specifically used to integrate with Dash.
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.
How to create a new admin service account in Jira for the Dropbox Dash integration
Note: Before creating a Jira account for the service account to be used with Dash, ensure that a corresponding email address exists for user svc-dropboxdash-jira (e.g. svc-dropboxdash-jira@company_domain_name.com), which can be used to log in and receive emails to accept and complete the Dropbox account flow.
- Log in to Jira as an admin.
- Click the
(settings) icon in the upper right to open the Jira administration menu.
4. Click Directory.
5. Click Users.
6. Click the Invite users button.
Note: The service account's access and control scope should be limited to Jira. If you have multiple products with Jira, you'll need to set the Product roles for those that aren't Jira specific to None.
8. In the Product roles dropdown menu for Jira, click the checkboxes for User, Product admin, and User access admin.
- User: This privilege allows access to the service account's information, such as email.
- Product Admin: This privilege grants administrative capabilities over the service account.
- User Access Admin: This privilege enables the service account to manage permissions, specifying which accounts can access each piece of content.
- Org Admin: This privilege allows the service account to fetch the content itself.
9. Click the Invite users button.
- You’ll be returned to the Atlassian admin page for Users and should see svc-dropboxdash-jira as an invited user.
10. Open the email account for user svc-dropboxdash-jira and locate the invitation to Jira.
11. Click the Accept Invite button.
12. In the pop-up window, type svc-dropboxdash-jira in the Full name field.
13. Type a new password in the Password field.
- Note the password somewhere safe, such as your password management vault.
14. Click the Continue button.
How to connect Jira to Dropbox Dash using the service account
- Log in to dropbox.com with your admin credentials.
- Click Admin console in the left sidebar.
3. Click Dash in the left sidebar.
4. Click Apps.
5. Click the More apps tab.
7. Click Continue.
- In the pop-up menu, you’ll be prompted to authenticate with Jira.
8. Type the email address for the svc-dropboxdash-jira service account.
9. Click the Continue button.
10. Type the password for the svc-dropboxdash-jira service account.
11. Click the Log in button.
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.
12. Click Accept.
- You’ll see a confirmation pop-up that Jira was connected.
13. Click the Your apps tab.
14. You should now see Jira added as a connector.
