Jira

Jira is a project management and issue tracking tool used for software development, task management, and agile project management.

Authentication Types

Jira (Cloud) supports 3 authentication methods:

• OAuth - Create your own Atlassian OAuth app with custom scopes. Every user connects with their Atlassian account.

  • Pros: Full control, per-user tracking, production-ready
  • Cons: ~2 min setup

• Instant OAuth - Use Webrix's pre-configured Jira app for the fastest setup.

  • Pros: Fastest setup, no configuration needed
  • Cons: Limited scopes, not recommended for production

• API Key - Use your Atlassian email and API token for authentication.

  • Pros: Easy setup
  • Cons: Single credential for all users

General Settings

Before using the connector, you need to configure:

• Jira Organization Domain - Your Jira instance domain (e.g., yourcompany.atlassian.net)

Setting up OAuth

1. Go to https://developer.atlassian.com/console/myapps/

2. Click Create → OAuth 2.0 integration

3. Enter a name for your app and click Create

4. In the left sidebar, go to Permissions

5. Click Add next to Jira API and configure the scopes you need

6. In the left sidebar, go to Authorization

7. Click Add next to OAuth 2.0 (3LO)

8. Copy the Redirect URL from Webrix and paste it as the Callback URL

9. Click Save changes

10. In the left sidebar, go to Settings

11. Copy the Client ID and Secret

12. In Webrix, paste the Client ID and Client Secret

13. Select the same scopes you configured in Atlassian

14. Enter your Jira Organization Domain in General Settings

15. Click Save Changes

Generating an API Key

1. Go to https://id.atlassian.com/manage-profile/security/api-tokens

2. Click Create API token

3. Give your token a descriptive label

4. Click Create

5. Copy the token immediately

6. In Webrix, enter the API key in the format: [email protected]:your-api-token