1. Login to your Jira with a user which has Jira admin rights.
   
   
2. Go to: Jira Settings -> Products -> Application Links
   
   
3. Create a new application-link by entering 'https://piplanning.io' in the field on the top of the page. Click "Create new Link".
   
   
   
   
   
4. In the newly opened popup, press "Continue"
   
   
   
   
   
5. Enter the application name 'piplanning.io' in the top field. Make sure you hit the checkbox 'Create incoming link' before clicking Continue.
   
   
   
   
   
6. Enter the Consumer Key (needs to be exact) and Consumer Name 'piplanning.io'.
   
   
7. Copy the Public-Key from the piplanning setuptool (Setup oAuth screen). Click Continue.
   
   
   
   
   
8. On the piplanning setup tool page, click "Authenticate".
   
   
   
   
   
9. Follow the steps displayed in the Jira page.
   
   
   
   
   
10. Close the JIRA window and click "Check & Close" on the piplanning.io setup page.
    
    

Troubleshoot

If you see an error when you click "Authenticate": Open the js-console of your browser and check for additional errors.

If you see an error like: "oauth_problem=signature_invalid":

• Make sure that you your Jira is properly configured in terms of its "base url". If you use a proxy to let the piplanning app access your Jira, oAuth will most likely not work. The base url configured in Jira (system settings) and in the <JIRA-INSTALL>/conf/server.xml file must exactly match the url you have entered to connect to Jira in the cockpit.
• For more information, checkout the Atlassian help page: https://confluence.atlassian.com/kb/oauth-error-oauth_problem-signature_invalid-720406720.html