1.4 How to: Create Application Link (Server)
new version
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.
Afterwards open the menu "Application links" and create a new link for "http://www.yasoon.com"
Enter the following mandatory values in the creation dialog:
| Application Name | Yasoon Outlook Integration |
|---|---|
| Application Type | Generic Application |
Save your application
Now edit your newly created application and switch to "Incoming authentification".
Enter the following values:
| Consumer Key | yasoonjira |
|---|---|
| Consumer Name | Jira 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 |
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.
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.