The procedure that will be described below requires you to connect to Jira at some step. If you are going to create webhooks webhooks will be created automatically, the Jira user account you will use must have the following permissions:
In Jira, go to ⚙ > Products > Application links (under Integrations):
On the subsequent page, enter the URL of your Zephyr Enterprise instance followed by /flex:
- If you use Zephyr Enterprise Cloud –
- If you use Zephyr Enterprise Server –
Click Create new link.
Click Continue in the subsequent confirmation dialog:
Now you need to configure the link properties:
- Enter some name into the Application Name box, for example, Zephyr Ent.
- Enter the same value into other text boxes in the dialog.
- Scroll the dialog box down and select the Create incoming link check box.
It’s important to select this check box.
In the next dialog, you need to specify the key.
- In the Consumer Key text box, enter the key name, for instance, Zephyr Ent.
You will need the Consumer Key value later. Write it down or remember.
- Enter some value into the Consumer Name box.
- Enter the contents of the public key .pem file you generated earlier into the Public Key text box.
To do this, open the key file in any text editor, copy the file contents and paste it in the Public Key box.
When copying, skip the first and last lines of the file (they have the BEGIN PUBLIC KEY and END PUBLIC KEY phrases).
Also, make sure you don’t enter leading or trailing characters like spaces or line breaks by accident. A good practice is to clear the text box before pasting the key contents to it.
The new application link will appear in the list of links in Jira:
Tip: To check if you specified the app URL correctly, click “Go to remote” for the created link. This should open the Zephyr Login form.
Log in to your Zephyr Enterprise instance as a user with administrator permissions.
Go to Administration > Jira Integration (under System Setup).
Click + above the Jira instance list:
In the subsequent dialog, specify the following values:
- Auth Mode -Select OAuth (1.0a). To connect to Jira Cloud, you should use this mode.
- Name – Any descriptive name for the connection. It will be used in the Zephyr UI.
- Jira URL – The URL of your Jira instance like
- Consumer Key Name – The key name.
It should be the same as the Consumer Key value you entered in Jira.
- Consumer Private Key – Specify the contents of the private key you generated earlier. Use the .pcks8 file: open it in any text editor, copy the key contents and paste them to the Consumer Private Key box.
When copying, skip the first and last lines of the file (they have the BEGIN PUBLIC KEY and END PUBLIC KEY phrases). Also, make sure you don’t enter leading or trailing characters like spaces or line breaks by accident. A good practice is to clear the text box before pasting the key contents to it.
Click Confirm to continue.
Zephyr will display the following message box. Click Confirm to continue:
Zephyr will show the following dialog box:
If you specified the public and private keys correctly, you will see some valid authorization URL. Otherwise, this value will contain the error message.
In the dialog:
a. Click the URL specified in Step 1:
b. This will send a request for the authentication code to Jira. The latter will ask for your approval to allow Zephyr access to your Jira project. Click Allow to continue:
c. Jira will show another page with the verification code (the value in quotes):
Copy this code to the clipboard and then switch to Zephyr and paste it into the Step 2 box:
Zephyr will run some diagnostics and will report the results:
Click Done. You will see the newly created connection in the list of connections:
Switch the Create defects in Jira toggle on to allow creating issues directly in Jira. If the toggle is on, clicking Next in Zephyr’s File New Defect dialog opens Jira’s Create issue dialog in a new tab.