By reading this help doc, you can learn how to configure Jira Master on Lark and build a connection with Jira Software Cloud, so that your team can directly view, create and manage Jira projects on Lark.

I. Intro

1. About Jira Software Cloud

Jira Software Cloud is a project and issue tracking tool developed by Atlassian. It is widely used in software issue tracking and agile project management. It is a version of Jira, where enterprises store and manage relevant data in the cloud.

2. About Jira Master

Jira Master is a practical tool developed by Lark. It allows you to receive development updates instantly on Lark, making it easier to follow and manage development, as well as facilitating communication.

II. Steps

Note: The configuration process must be operated on desktop.

Note: Company administrators must configure the app before users use it, or else users will receive an error message.

Configure Jira Master (company administrators)

After installing Jira Master, the company administrator can find it in Workplace > App Management > Installed apps via the Lark Admin.

Open the details page in Jira Master and click Go to app admin console to configure.

Connect to Jira

Open the Jira Master Admin to set up the connection between Jira Master and an enterprise Jira address. The connection is required before you can use Jira Master properly.

Set up the connection between company Jira address and Jira Master URL

•Go to the Admin and select Connect to Jira on the left.

•Enter the Jira URL used at your company in Jira URL. The format is usually https://xxx.atlassian.net, and it should not contain any subpath.

•Confirm that the address is correct and click Reset Configuration.

Configure the application link

•Go to company Jira's admin.

•Copy the Jira Master URL to Jira's application links configuration page by following the instructions displayed in the example image.

Note: Navigation path to the configuration page in Jira might be different in different Jira versions. You can find more information in the following section "How to configure application links in Jira".

•Click Continue in the Jira interface.

•Click Next on the Jira Master Admin page.

Fill the link applications form in Jira

•Go to the Jira page and copy Application Name from the Jira Master Admin as in the example, then paste it to the corresponding place on the Jira webpage.

•Set Generic App under Application Type, then select Continue.

•Click Continue and then return to the Jira Master Admin and click Next.

Input the security data of the app in Jira

•Copy the Consumer Key, Consumer Name and Public Key from the Jira Master Admin to their corresponding locations in the company Jira configuration interface as shown in the example image.

•After clicking Continue, you will see a message on the Jira configuration page indicating that the configuration is being processed. By then, the link configuration of the company Jira is completed.

•Click Next in the Jira Master Admin.

Complete the configuration

•Click Save Connection.

•Click Allow on the page as shown below to complete the configuration process.

How to configure application links in Jira

Below is an introduction of how to use Jira to access the application link configuration page:

1.Open the company Jira webpage and click the Settings button in the upper right corner. Select Jira settings - Products.

2.In the sidebar select Integrations - Application links.

3.Enter the URL provided by the Jira Master Admin and click Create New Link.

How to obtain URL to configure webhooks

Click Configure Notifications in the navigation bar of Jira Master Admin. The URL in Webhook URL is what you need to add when you configure Webhooks in your Jira.

III. FAQs

Q: What are the common reasons why Jira Master configuration fails?

A:

•The address of Jira is incorrect. The correct way to fill in is: https://jira.company.com; the common mistaken way to fill in is: https://jira.company.com/secure/Dashboard.jspa

•The public key on the Jira side was not deleted synchronously during the reconfiguration. The configuration of Jira Master is actually the configuration of public and private keys. To reconfigure, you need to delete the matched public and private keys simultaneously on Jira Master and Jira server.

•Make sure your Jira server time is synchronized with Network Time Protocol (NTP).