Page Comparison

About

You use OAuth authentication when connecting to Jira Cloud or Jira Server / Data Center. For Jira Cloud, this is the only supported authentication type.

...

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:

...

 Open the command line prompt and run the following commands. They will generate the keys in the needed format:

openssl genrsa -out jira_privatekey.pem  1024
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8
openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem

To configure the connection, we will need the private key in the PCKS8 format and the public key in the PEM format.

...

1. In Jira, go to ⚙ > Products > Application links (under Integrations):

   

2. On the subsequent page, enter the URL of your Zephyr Enterprise instance followed by /flex:
   - If you use Zephyr Enterprise Cloud –
   https://{your-subdomain}.yourzephyr.com/flex
   - If you use Zephyr Enterprise Server –
   http(s)://{your-host-URL-or-IP}:{port}/flex
   

   Image RemovedImage Added

   
   Click Create new link.
   

3. Click Continue in the subsequent confirmation dialog:

   

4. 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.

   Image RemovedImage Added

   Click Continue.
   

5. 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.

   

   Click Continue.
   

6. The new application link will appear in the list of links in Jira:

   Image RemovedImage Added

   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.

...

1. Log in to your Zephyr Enterprise instance as a user with administrator permissions.

2. Go to Administration > Jira Integration (under System Setup).

3. Click + above the Jira instance list:

   Image RemovedImage Added

4. 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 https://{my-org}.atlassian.nеt.
   - 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.
   

5. Zephyr will display the following message box. Click Confirm to continue:

   

6. 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:

   

   Click Save.
   

7. Zephyr will run some diagnostics and will report the results:

   

   
   Click Done. You will see the newly created connection in the list of connections:
   

   Image RemovedImage Added

...