Add Jira Collaboration Provider

Updated 1 month ago by Michael Katz

Add Jira as a Harness Collaboration Provider, to enable deployment notifications, approvals, and tracking through Jira. In this topic:

Before You Begin

Limitations

Your Jira REST API account must have permissions to create and edit issues in the relevant Jira projects. The Administer Jira permission includes all relevant permissions (as does the Administrator or Member permission on Jira next-gen).

For details, see Atlassian's documentation on Operation PermissionsIssues, and Managing Project Permissions.

Step 1: Add Collaboration Provider

Start adding a Collaboration Provider to Harness as follows:

  1. Click Setup.
  2. Click Connectors.
  3. Click Collaboration Providers.
  4. Click Add Collaboration Provider. This opens the default Collaboration Provider settings, which you will configure in the following steps.

Step 2: Type

Select Jira. The Jira settings appear.

Step 3: Display Name

In Display Name, enter a unique name to identify this Jira account connection. When you add Jira steps to Workflows or Pipelines, you will select the appropriate Jira account using this name.

Step 4: Base URL

In Base URL, enter the base URL by which your users access your Jira applications. For example: https://mycompany.atlassian.net.

In Jira, the base URL is set to the same URL that Web browsers use to view your Jira instance. For details, see Configuring the Base URL from Atlassian.

Step 5: Username

In Username, enter the username of the Jira account used for the connection.

Step 6: Password/API Token

In Select Encrypted Password/API Token, select or create a new Harness Encrypted Text secret containing the password or API Token to use for the Jira account.

For more information, see API tokens from Atlassian.

Step 7: Usage Scope

Usage scope is inherited from the secret entered in Select Encrypted Password/API Token.

Step 8: Test and Save

  1. Click Test to check your configuration.
  2. When the test is successful, click Submit to save your Jira Collaboration Provider.

Next Steps


How did we do?