Jira Server

Jira Server (Data Center) is a self-hosted version of Jira for project management and issue tracking.

Authentication Types

Jira Server supports 2 authentication methods:

• OAuth - Create your own Atlassian OAuth app (for Jira Server connected to Atlassian Cloud).

  • Pros: Full control, per-user tracking, production-ready
  • Cons: Requires OAuth configuration

• API Key - Use a personal access token for authentication.

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

General Settings

Before using the connector, you need to configure:

• Jira Organization Domain - Your Jira Server instance URL (e.g., https://jira.yourcompany.com)

Setting up OAuth

For Jira Server instances connected to Atlassian Cloud:

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. Add the Redirect URL from Webrix

9. In the left sidebar, go to Settings

10. Copy the Client ID and Secret

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

12. Enter your Jira Organization Domain in General Settings

13. Click Save Changes

Generating an API Key (Personal Access Token)

For Jira Server/Data Center (version 8.14+):

1. Log in to your Jira Server instance

2. Click on your profile icon in the top right

3. Go to Profile

4. In the left sidebar, click Personal Access Tokens

5. Click Create token

6. Enter a Token name and optionally set an expiry date

7. Click Create

8. Copy the token immediately (it won't be shown again)

9. Paste the token into Webrix

10. Enter your Jira Organization Domain in General Settings

Note: For older Jira Server versions without PAT support, you may need to use basic authentication with your username and password.