Versions Compared

Old Version 7

changes.mady.by.user Carina Siefert

Saved on

compared with

New Version Current

changes.mady.by.user Simone Schmidt

Saved on

Key

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


This guide only applies if
Info
titlePlease note
new 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.



Warning

This guide is outdated and does not work anymore!

If the automatic configuration ("Add Application Link") is not successful. Please contact us as well if this is the case for you, as we try to improve the automatic version constantly.The following is a complete walkthrough, if you are only looking to set up the application link, skip to "Application Link"., please contact us: https://yasoon.atlassian.net/servicedesk/customer/portal/3!



Section

Access JIRA for Outlook Admin Area

Column
width50%

After the installation of the add-on, you'll need to reload the page to see the new navigation links. Inside the JIRA add-on administration, you'll find the entry "Outlook App" in the navigation bar.


After installation you'll get asked for a yasoon Company Account. You can either directly create one for your company or login with an existing one. The yasoon account is mandatory and makes it easy to distribute the setup files and manage future updates.

After the registration you can see a brief overview about your JIRA for Outlook add-on. It'll show your Account Status, the public certificate for your application link, as well as the download link for the setup file.


Column


...


Section

Application Link

Column
width50%

Application Link

The whole communication between yasoon and Jira is SSL encrypted so you need to add the certificate in yasoon as well as in Jira. In preperation for the settings below, you'll need to have an public/private key pair.

  • Recommended: Use the auto-generated certificate
    As soon as you registered the JIRA instance with yasoon, we automatically generate a new certificate for you. This certificate is added when clicking "Add Application Link" button. The private one is already registered at our yasoon administration panel.

  • Create a key manually
    If the generation of the application link fails, or you want to do this manually, please visit the following page: Generate Certificate. If you need to generate an own certificate due to corporate restrictions, please contact us.


Column



...

Section


Column
width50%

Afterwards open the menu "Application links" and create a new link for "http://www.yasoon.com"


In the Creation dialog just enter Enter the following mandatory values in the creation dialog:

Application NameYasoon Outlook Integration
Application TypeGeneric Application

Save your application


Column


...

Section


Column
width50%

Now edit your newly created application and switch to "Incoming authentification".


Enter the following values:

Consumer Keyyasoonjira
Consumer NameJira for Outlook
Description:Anything that helps your users to identify which system it is
Public Key:The public certificate, including the "-- BEGIN --" part (see chapter security certificates above)
Consumer Callback URL:http://oauth.yasoon/v1/com.yasoon.jira/auth



Column



...


Section


Column
width50%

After saving all changes, the private key needs to be entered in the yasoon admin panel. Please visit it via the link in the JIRA addon. Select your JIRA instance and paste the private key. Afterwards, you can start using JIRA for Outlook.


Column

...



...


FAQ

  • Are there any data exposed externally?

...