This article provides instructions for connecting Atlassian to your Akooda account. This connection essentially provides Akooda with access to Jira tickets (including Jira Service Management) and Confluence folders/documents that are public to your entire organization.
For more information about how Akooda helps your organization evolve and the inherent privacy and security protections in place, see Akooda Integration Principles.
Before We Begin
Before connecting your organization’s Atlassian account, check that:
You’re an Admin in Akooda.
You’re an Organization or Site admin for your Atlassian account.
Your organization domain is verified (as instructed in Atlassian’s Verify a domain to manage accounts guide).
If you don’t have the right permissions as mentioned above, please send this guide to the right individual in your organization (usually this is IT or Info Security personnel). If you require further assistance getting the right permissions, please don’t hesitate to contact our support team at [email protected].
How to Connect
Step 1: Ensure Custom Priorities Order
Akooda’s significance score relies on the priority field values and ordering provided per JIRA scheme. In case your organization implements custom field values (as mentioned in Atlassian’s Defining priority field values article), please follow the steps below to make sure they have the right ordering.
Head over to “Administration > Issues > Priorities” and make sure the order is correct.
Head over to “Administration > Issues > Priorities Schemes” and make sure scheme allocation is and all priorities are indeed in use (otherwise “skipped” priorities tier will be considered in score).
NOTE: Whenever you update custom priority name or ordering, please update the Akooda team to issue a processing job of old interactions, otherwise your significance score might be out of sync.
Step 2: Link the Atlassian Account with Akooda
Sign into Akooda (app.akooda.co) with your admin user.
Navigate to the “Apps” page under the Account Settings (app.akooda.co/settings/apps)
Click on the “Connect” button for any Atlassian products (Jira, Confluence or JSM), which will open an app installation page.
Sign in to your organization’s workspace with your admin Atlassian account, which will open an Atlassian instance selection page.
Select the Atlassian instance for which you want to connect to Akooda.
Click “Accept” to provide consent for Akooda to view the information needed to connect Atlassian (as referenced in Atlassian’s Permission Scopes guide)
NOTE: The permissions granted include viewing user profiles and groups, reading and searching JIRA projects and issues, Confluence spaces’ content and searching throughout it. These permissions are required for Akooda to be able to analyze the users’ public interactions. Private Confluence documents with access restrictions, are not supported at the moment. If you require processing of such documents, please contact your account manage to discuss your options.
Following Akooda’s “Least-privilege Models” policy. The requested permissions do not include any write permissions.
Next Up
Processing your organization's data post initial integration may take up to 24 hours. Once done, you will be able to see tagged Atlassian interaction data in your Akooda account.
If you run into any problems, we’re here to help. Reach out to [email protected] to get assistance for your organization.
Any Feedback?
Was this page helpful? Provide feedback on this article and ways we can improve to [email protected].