INDEX
Setup a new connection to Jira
You can connect to Jira either by using OAuth (default) or basic-auth. Keep in mind that basic-auth is not supported on jira-cloud.
For both Basic Auth and OAuth connection there are more options which you can access when clicking on the checkbox "Advanced Settings".
This will show additional fields which you can modify:
| Name | Description |
|---|---|
| Options | Enable / disable TLS certificate check. If you have Jira setup with a self-signed certificate, you may have to disable the check here to be able to connect. |
| Custom Timeout | Connection timeout in seconds for HTTP requests to the ALM tool. Must be a value between 5 and 60. The default is 5 seconds. |
Basic Auth
- Click on "Switch to Basic Auth" on the top right
- Fill in the username and password of a Jira-user. Keep in mind that this user will be used to create sprints, issues etc in Jira from the piplanning app. So make sure that this user has the appropriate permissions.
OAuth
Fill out the basic connection details. To start the OAuth-dance click "Connect to Jira"
Name Description Connection name Name for the connection. That is just for the user to give a friendly name. Instance URL Url to your Jira. Use http or https as schema.
In the OAuth popup, follow the steps mentioned in the video or use instructions from step-by-step guide Setup OAuth for authentication with Jira.
The user with which you are logged in to Jira while setting up the OAuth connection will be used to to do all the sync-work between Jira and the piplanning-app. Make sure that this user has appropriate permissions.
Hint: The keys used in the OAuth connection are the same overall Jira connections created by the same piplanning-app company. Those keys are generated at first usage.