Connecting to Jira

Jira is a suite of tools developed by Atlassian for issue tracking, project management, and release planning. It is widely used by software development and IT teams to manage agile workflows, track bugs, and monitor project progress.

To integrate Jira with IBM watsonx Orchestrate, you must establish a secure connection that enables communication between the two systems. See Managing connections for more details.

Important: By default, Single sign-on (SSO) is disabled for your app. To enable it, refer to Configuring single sign-on for applications.

Connecting to Jira using OAuth2

To connect watsonx Orchestrate to Jira using OAuth2:

  1. From the main menu, select Manage > Connections.

  2. Search for Jira.

  3. Locate the connection ID with the following format: jira_oauth2_auth_code_ibm_184bdbd3

  4. Click edit next to the matched connection ID.

  5. Choose the environment where the connection is used:

    • Draft: for development or testing
    • Live: for production use

  6. Select OAuth2 Authorization Code as the Authentication Type.

  7. Provide the following respective values:

    Key Description
    Server URL Base URL of the Jira server
    Token URL Endpoint to exchange the authorization code for an access token
    Authorization URL URL where users are redirected to log in and authorize access
    Client ID Unique ID for your application
    Client Secret A secret key used to authenticate your app with Jira
    Scope Defines what access is being requested

    To get these values, see the Jira API documentation.

  8. Choose the appropriate credential type.

  9. Click Save to complete the setup.

Note: The icon A Supports appears indicates that the connection was successfully established.

Connecting to Jira using Basic authentication

Note: For agents deployed before October 2025, continue using existing connection types for Jira integration. For agents created after October 2025, OAuth2 is the only supported authentication method for Jira.

  1. Open the main menu and select Manage > Connections.
  2. Search for Jira.
  3. Locate the connection ID with the following format: jira_basic_ibm_184bdbd3
  4. Click edit next to the matched connection ID.
  5. Choose the environment where the connection is used:
    • Draft: for development or testing
    • Live: for production use
  6. Choose Basic Auth as the authentication type.
  7. Choose the appropriate credential type.
  8. Click Save to complete the setup.

Connecting using Key Value Pair

Note: For agents deployed before October 2025, continue using existing connection types for Jira integration. For agents created after October 2025, OAuth2 is the only supported authentication method for Jira.

  1. Open the main menu and select Manage > Connections.

  2. Search for Jira.

  3. Locate the connection ID with the following format: jira_key_value_ibm_184bdbd3

  4. Click edit next to the matched connection ID.

  5. Choose the environment where the connection is used:

    • Draft: for development or testing
    • Live: for production use

  6. Select Key Value Pair as the authentication type.

  7. Provide the following Key and specify the Value corresponding to the key:

    • base_url: The base URL of your Jira instance

    To get these values, see the Jira API documentation.

  8. Choose the appropriate credential type.

    Note: Only the team credentials are supported when an app is connected using the Key Value Pair authentication type.

  9. Click Save to complete the setup.