Contents x
    Jira Connection
    • 2 Minutes to read
    • Print
    • Dark
      Light
    • PDF
    Contents

    Jira Connection

    • 2 Minutes to read
    • Print
    • Dark
      Light
    • PDF
    Article Summary

    This guide will walk you through the steps for setting up the Jira connector

    Prerequisite

    • A Jira (Atlassian) account with relevant permissions
    • A cloud app login credentials/ An API token/ server app login username (email) and password

    image.png

    Grant relevant permissions to the user

    In Jira the permissions of the API token will be identical to the permissions of the user that generated the Token.

    Please make sure that the user that is going to generate the API token has the following permissions on all of the relevant projects or project schema:

    • Browse projects*

    Additional information on Jira permissions can be found in this Jira Artcile Managing project permissions.

    Cloud app login with Jira

    1. You will need your account domain name. Your account domain is located in the URL before the atlassian.net ending. e.g. https://{domain name }.atlassian.net
    2. You will need the base URL set in your system settings:
      Base URL is taken from your Jira (Atlassian) Admin Settings in this location:Administation Settings > System > General Configuration> Edit Settings > Base URL
      The default base URL: http(s)://my-domain-name.atlassian.net
    3. Log in to your cloud app with your log in credentials as you log in to id.atlassian.com

    image.png

    Create an API token in Jira

    Create an API token from your Atlassian account:

    1. Log in to https://id.atlassian.com/manage/api-tokens .

    2. Click Create API token.

    3. From the dialog that appears, enter "Rivery" as a Label for your token and click Create.

    4. Click Copy to clipboard, then paste the token to your notepad, or elsewhere to save.

    5. If you are logging to Jira with an email, your username is the email you are loggin in with.

    Note

    Once you exist the API screen you can't retrieve the Token and you will need to create a new token if you lost it.

    image.png

    Connect to you server app

    In case you run your Jira app on a local machine with Jira Software you will need the server app connection type. In the connection you will need:

    1. Your login credentials to the server app (username and password).
    2. You will need the base URL set in your system settings:
      Base URL is taken from your Jira (Atlassian) Admin Settings in this location:Administation Settings > System > General Configuration> Edit Settings > Base URL
      The default base URL: http(s)://my-domain-name.atlassian.net

    image.png

    Creating A Jira Connection

    1. In your Rivery Account , go to Connections

    2. Press on +Create New Connection

    3. Choose Jira

    4. Fill a suitable name under Connection Name and insert the connection details:

      1. Domain Name - Your account domain name. Your account domain is located in the URL before the atlassian.net ending. e.g. https://{domain name }.atlassian.net

      2. Username - The email used to log in to your Jira account

      3. API Token- The token generated in the previous step

    5. Click Save and create the connection

    Was this article helpful?
    What's Next