Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info
titlenew version
We have a new version of Outlook Email for Jira!
This is the documentation for the old add-in. If you are looking for info about the new one, please click click here.


The Outlook app uses oAuth 1.0a to connect to your JIRA instance. You need to create a new application link, so Outlook can connect to it. Please follow the instructions carefully - any misspelling could prevent JIRA for Outlook from working correctly.

...

Section

1.Open Admin Area


Column
width50%

1.For JIRA 6

Open JIRA and open the add-on administrationapplications area.

Column

Image Removed

Section
Column
width50%

1.2 For JIRA 7

Open JIRA and open the applications area.

Column
Image Removed
Info

With the latest UI Update, the correct path is Jira Settings → Products → Application Links



Column

Image Added





...


Section

2. New Appication Link


Column
width50%

2.1 Create

Afterwards open the menu "Application Links" and create a new link for "https://office365.yasoon.com"


Column


...

Section


Column
width50%

2.2 Confirm Popup

There will be a popup, telling you that no response was received. This is no error. The communication with JIRA will be exclusively done from Outlook, our server will at no time connect to JIRA directly. Just click "Continue" to skip to the next step.


Column

Image RemovedImage Added




Section


Column
width50%

2.3. Maintain Header Data

In the Creation dialog just enter the following mandatory values:

Application Name: JIRA for Outlook

Application Type: Generic Application

Continue again to save the application link


Column

Image RemovedImage Added



Section


Column
width50%

2.4. Maintain Incoming Authentication

There is a bug in JIRA and you cannot directly maintain incoming authentication data. So please save the link first and then edit your newly created application and switch to "Incoming Authentication".


Column



Section


Column
width50%

Enter the following values:

Info
Please follow these values carefully. Every misspelling may cause errors later on when using the Outlook add-on. Better spend a minute now to double-check if everything is correct. Thank you!


FieldValue
Consumer Keyyasoonjira
Consumer NameJIRA for Outlook
Description<This text is visible to the users. Set a text that helps users to identify this JIRA system>
Public Key<Insert the certificate shown on the configuration page (
see screenshot at the bottom
Addons → Outlook App → General Overview). Please also include "---BEGIN... ---END CERTIFICATE>
Consumer Callback Urlhttp://oauth.yasoon/v1/com.yasoon.jira/auth




Section


Column
width50%

2.5. Save

Save all your changes. JIRA is ready to provide the data to the Outlook client.

 


SSL Certificate

The whole communication between Outlook and JIRA is SSL encrypted so you need to add the certificate in the JIRA application link. There are two possibilities to get the certificate:

  • Recommended: Use the auto-generated certificate
    As soon as you registered the JIRA instance with yasoon, we automatically generate a new certificate for you. The private one is already registered at our yasoon administration panel, the public key is certificate is shown on the Admin page of your JIRA addon (see image below)

  • Create your own
    If you need a custom SSL certificate, due to corporate requirements, please contact us for more information.


Column

Image Removed

 

...

Image Added