Versions Compared

Key

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


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



Column




Section


Column
width50%

1.2 For JIRA 7

Open JIRA and open the applications area.


Column





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




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



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
bordertrue

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