Jira integration
Contents
- What can you do with a Dado-Jira integration?
- What data is exchanged between Dado and Jira?
- How to set up the integration
What can you do with a Dado <> Jira integration?
The Dado <> Jira integration allows you to automatically create tickets in Jira projects and service desks.
What data is exchanged between Dado and Jira?
Jira data accessible to Dado
Dado connects to Jira via their API, using the dedicated Jira account you set up for Dado to use (see Step 1 in the set-up instructions below). Therefore the access that Dado has is limited to what this Jira account can access.
Jira offers fine-grained permissions in its own platform (such as project roles, set on each project/service desk) which you can use to further configure the access and actions this Jira account can perform.
Dado data accessible to Jira
The only data from Dado that would be visible to Jira are the user data fields you set up to be added to the tickets Dado creates. You have full control of this via the Create Ticket automation settings.
Permissions and Scopes requested by Dado
We request the OAuth Scopes listed below. Please allow the app all of these Permissions and Scopes, otherwise, the functionality of the integration will be compromised.
- View: jira-work
- This enables Dado to find the projects/service desks you've granted access to, as well as issue types and fields within them; and see the full contents of tickets that already exist in those projects/service desks.
- Update: jira-work
- This enables Dado to create tickets, update tickets and delete tickets in the projects/service desks you've granted access to.
- Dado is not set up to delete tickets. You can further restrict ticket deletion via assigning Dado's dedicated Jira account to a project role that does not have delete permissions.
How to set up the Jira Integration
Time required: 15 minutes
Pre-requisites: a Jira account with permission to create users and grant access to projects/service desks
Step 1: Create a dedicated Jira user account for Dado
We recommend you authenticate with a dedicated Jira user account, which is only used for the purpose of Dado. This way you can grant permissions on a granular level to this one account, so that Dado can only see what it needs to see.
Request your IT Team sets up a new Jira user account, with access to the projects/service desks where you'll want to create tickets.
- This Jira user will only need permissions to create tickets (not update or monitor tickets), and only in the projects/service desks where you want Dado to create tickets.
- If you already have a dedicated Google Workspace/Microsoft account, it's best to set up the Jira user with that account's email address.
Step 2. Give the Jira Integration User access to the relevant projects/service desks
- Now go to Jira, and add the Jira Integration User to the relevant projects and service desks
- This user needs permissions to create tickets in each project and service desk, where you want Dado to automatically create tickets.
If you can't remember the email address of your Jira Integration user, context help@dadohr.com and we'll look it up for you.
Step 3. Set up the integration in Dado
- Log in to Jira as your Jira Integration User
- Log into Dado as an Admin user, and navigate to Settings > Integrations
- Select Jira and click "Setup Integration".
- You’ll be taken to Jira. If you're logged in to multiple workspaces, choose the correct one before proceeding.
- You will be asked to allow Dado to connect to your Jira workspace, as in the screenshot below. Dado needs these permission rights to send messages and tasks to your company's employees. Press Accept to proceed.
- You will then be sent back to Dado and see a message confirming you've successfully set up the integration. You can now log out of this Dado account, and log back in as yourself.
- You can now set up Jira Automations, to automatically create tickets in projects and service desks – see instructions here
