Skip to main content

​
Add the Jira Connector

​
Authenticate to Jira

After you add the connector, you need to set the required properties. URL: Enter the URL for your Jira endpoint (for example, https://YourSiteName.atlassian.net). supports authenticating to in several ways. Select your authentication method below to proceed to the relevant section that contains the authentication details.

​
OAuth

​
Personal Access Token

To connect with a personal access token, specify the following properties:
  • Auth Scheme: Select PAT.
  • PAT: Enter your personal access token (PAT). You can create a PAT either via from the Atlassian Settings menu or by using a REST API. From the Atlassian application:
    1. Select your profile photo at the top right of the screen.
    2. From the drop-down list, select Settings > Profile.
    3. In the left pane, select Personal Access Tokens.
    4. Click Create token. Then, give the new token a name.
    5. (Optional) Set your token to expire automatically after a certain number of days. (Atlassian displays a reminder message five days before the token actually expires, which gives you time to create a new token.)
      According to the Atlassian Developer guide, the PAT persists for five years by default.
    6. Click Create. After the token is created, make sure to copy and save it because you cannot view or retrieve it later.
    From a REST API: To create a PAT by using the REST API, see “Creating PATS using REST API” in the Atlassian Using Personal Access Tokens documentation.

​
API Token

To connect with an API token, specify the following properties:
  • Auth Scheme: Select Token.
  • User: Enter the username that you use to authenticate to your account.
  • API Token: Enter your API token. To generate an API token in Atlassian:
    1. Log in to your Atlassian account.
    2. Select Security > Create and manage API tokens > Create API token.

​
Basic

​
Crowd

To connect with single sign-on (SSO) via Atlassian Crowd, specify the following properties:
  • Auth Scheme: Select Token.
  • User: Enter the username that you use to authenticate to your account.
  • Password: Enter the password that you use to authenticate to your account.
  • SSO Login URL: Enter the login URL that is used by your SSO provider.
  • SSO Exchange UrI: Enter the URL that is used to exchange the Security Assertion Markup Language (SAML) token for Jira cookies. This URL can be in either of the following formats:
    • https://AuthorityofJiraInstance/plugins/servlet/samlconsumer
    • https://AuthorityofJiraInstance/plugins/servlet/samlsso
  • SSO App Name: Enter the name of the application in which SSO is enabled.
  • SSO App Password: Enter the password of the application in which SSO is enabled.

​
Okta

  • SSO Exchange UrI: Enter the URL that is used to exchange the Security Assertion Markup Language (SAML) token for Jira cookies. This URL can be in either of the following formats:
    • https://AuthorityofJiraInstance/plugins/servlet/samlconsumer
    • https://AuthorityofJiraInstance/plugins/servlet/samlsso

​
LDAP

​
Complete Your Connection

To complete your connection:
  1. Define advanced connection settings on the Advanced tab. (In most cases, though, you should not need these settings.)
  2. Connect to to connect to your account.
  3. Click Create & Test to create your connection.

​
More Information