Skip to main content

Jira Reader initial setup

Configuring Authentication for the Jira Reader

Before using OAuth to authenticate to Jira, verify that you have access to an Atlassian developer account. The following procedure configures an existing or new Jira app to use refresh/access token pairs.

  1. Log in to an Atlassian developer account.

  2. Select Developer Console from the profile drop-down.

    The Developer Console displays a list of apps.

  3. Select an app from the list or create a new app.

    The app configuration page appears.

  4. Select Authorization.

  5. Click Add in OAuth 2.0 (3LO).

  6. In the Callback URL field, type a URL.

    When you configure the Jira Reader in Striim, the value of the redirect_uri parameter must match this URL.

  7. Click Save changes.

  8. Click Permissions.

    A list of APIs appears.

  9. Click Add next to the API the app uses.

The following procedure forms an authorization URL in order to generate an authorization code. Verify that a Jira app exists and that the app is configured for OAuth 2.0.

  1. Log in to an Atlassian developer account.

  2. Select Developer Console from the profile drop-down.

    The Developer Console displays a list of apps.

  3. Select an app from the list or create a new app.

    The app configuration page appears.

  4. Select Authorization.

    The Authorization URL Generator section displays several authorization URLs.

  5. Add the offline_access scope to the authorization URL the app uses and copy the authorization URL to the clipboard.

    The authorization URL includes a &scope= section followed by a list of scopes delimited by the colon : character, URL-encoded to %3A.

  6. In a browser, navigate to the authorization URL.

    The browser navigates to the configured redirect URL, appending the authorization code to the end of the URL. The authorization code is the alphanumeric string following the &code= section.

  7. In a terminal window, issue the following command to exchange the authorization code for an access token and a refresh token. Replace the values in <> brackets with the relevant information.

    curl --location --request POST 'https://auth.atlassian.com/oauth/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cookie: JSESSIONID=BB776213B8229CD38609E15A2D3D09F8' \
--data-urlencode 'grant_type=authorization_code' \
--data-urlencode 'client_id=<client_id>' \
--data-urlencode 'client_secret=<client_secret>' \
--data-urlencode 'code=<authorization_code>' \
--data-urlencode 'redirect_uri=https://localhost:3000'

    The Client ID and Client Secret for the app are available from the Settings menu.

    The curl command returns a JSON access token.

Configure the Striim Jira Reader with the JSON access token when the OAuth authentication method is in use.

The following procedure creates an API token as an alternate authentication method.

  1. Log in to an Atlassian account.

  2. Click Security.

    The Security tab appears.

  3. Click Create API token.

    The API token creation dialog appears.

  4. Type a label for the token and click Create.

    The API token appears.

  5. Click Copy to clipboard, then paste the API token to a secure location.

    The token cannot be displayed after closing this dialog.