Overview

Torii integrates with your Jira account and syncs the following attributes:

1. List of users and their roles
2. Usage
3. License type

You can constantly be updated with application information from our Integrations Page >> Integration Capabilities button  >> Integration Capabilities table.

Prerequisites

• At least one user must expose their email address ('emailAddress' field). If all user's email addresses are hidden, the integration will fail. 
• To get usage, the user 'Who created the token' requires to have access to Jira.

Work Management.

Note: Integration with "Jira Server" (the self-hosted solution) is not supported.

Usage

Torii monitors Jira usage data daily.

1. We monitor all events for existing Jira issues listed in the Jira ticket activity log.
   Comments - Created/ edited/ deleted comments
2. History - Monitors issue's activities like attachments, dates, assign to, etc.
3. Work log - Created/ edited/ deleted work logs

If a Jira user completed at least one of the following actions on a given day:

• Created/ edited/ deleted comments
• Attached, assigned, changed an item
• Worked on the work log

The user will be considered an "Active user."

Once connected, Torii will show usage from the last 30 days

Note: Users who have set their email address to be hidden can not be synced from Jira.

License type

A Jira site usually contains multiple products:

• Jira Core, Jira Software, Jira Service Desk and more.
• Each user's product access will be shown as a license for the user.
• Note that "Jira Core" is included in other products.

Connect your Jira Cloud integration

Step 1: Log in to your Atlassian account. Make sure you have the following global permission:

1. Browse users and groups.

2. Administer Jira.

Step 2: Create an API token from your Atlassian account:

1. Go to https://id.atlassian.com/manage/api-tokens.
2. Click Create API token.
3. From the dialog that appears, enter "Torii" as the Label for your token and click Create.
4. Click Copy to clipboard and save the API token. Note that it isn't possible to view the token after closing the creation dialog; if necessary, create a new token.

Step 3: Get the Jira site URL. It should look like: https://your-domain.atlassian.net

Step 4: Go to the Torii Integrations page and click on the Jira Cloud tile in order to connect.

Step 5: Provide your Atlassian account email address, API Token and Jira site URL.

Q&A

Q: Will the 'Delete JIRA Cloud User' action in a workflow always delete a JIRA user?
A: No. If the user has opened a JIRA ticket in the past (and thus is a 'Reporter' in JIRA), Torii cannot delete them per JIRA's API limitations.

Get additional information in:

• Atlassian and Jira Cloud Integrations: A deeper look
• Open a Jira Ticket From Torii
• Delegate an Offboarding Task With Jira

Q: I am trying to connect the Jira integration, but getting an 'Invalid credentials' error. What should I do?

A: Please try the following steps:

1. Make sure the email who connected the integration is a global administrator
2. Give 'global permissions' to the connecting user's Jira group
3. Reassign admin Jira group for the connecting user