1.4 How to: Create Application Link (Server)

1.4 How to: Create Application Link (Server)

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.

 

 

This guide is outdated and does not work anymore!

If the automatic configuration ("Add Application Link") is not successful, please contact us: https://yasoon.atlassian.net/servicedesk/customer/portal/3!

 

 

Access JIRA for Outlook Admin Area

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.


 

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.



JIRA Configuration

Yasoon uses oAuth 1.0a to connect to your Jira instance. You explicitly need to create a new oAuth provider so yasoon can connect to it.

Open Jira and open the add-on administration.


 


 

 


 

 


 

FAQ

  • Are there any data exposed externally?

No, the yasoon clients (local Outlook) pull the data directly from Jira. No external server or services are used

  • Is it working if Jira is behing a Firewall and needs VPN?

Yes, as long as the Client is inside your corporate network, everything works fine.