Skip to main content

Initial setup for Jira Reader

Before you build pipelines, complete authentication setup for Jira (OAuth or API token) and, optionally, create a Striim connection profile to store and reuse your Jira connection settings during app creation.

Configuring OAuth for the Jira Reader

Verify that you have access to an Atlassian developer account. The following procedure configures a Jira app to use refresh/access token pairs.

  1. Log in to an Atlassian developer account and open the Developer Console.

  2. Select an existing app or create a new app.

  3. Open Authorization and add OAuth 2.0 (3LO).

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

  5. Save changes, then open Permissions and add the APIs/scopes the app will use (include offline_access to obtain a refresh token).

Generate an authorization code, then exchange it for tokens:

  1. Use the Authorization URL Generator to include required scopes (add offline_access), then open the URL in a browser.

  2. After consent, copy the code value appended to your redirect URL.

  3. Exchange the code for tokens:

    curl --location --request POST 'https://auth.atlassian.com/oauth/token' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --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'

  4. Use the resulting access and refresh tokens when configuring the Jira Reader with OAuth.

Creating an API token for the Jira Reader

As an alternative to OAuth, you can authenticate with a user name and Atlassian API token.

  1. Log in to your Atlassian account and open the Security tab.

  2. Click Create API token, provide a label, and create the token.

  3. Copy the token to a secure location. Atlassian will not display it again.

Configuring a Striim connection profile (optional)

Create a reusable connection profile so you don’t re-enter credentials in each app.

  1. In Striim, go to Connections and click New connection.

  2. Select Jira (source) and enter your authentication details (OAuth: Client ID, Client Secret, Refresh Token; or API token: Username and API Token). Provide the Jira Endpoint URL.

  3. Save the profile. When building with a wizard or Flow Designer, select this profile instead of entering properties manually.