Jira Data Center
Overview
Pre-built tooling
Pre-built integrations
No pre-built integration yet (time to contribute: <48h)
Access requirements
Pre-Requisites | Status | Comment |
---|---|---|
Paid dev account | ⚠️ Conditional | Jira Data Center requires a license. You can start a free trial for development. |
Paid test account | ⚠️ Conditional | Same as above. |
Partnership | ✅ Not required | |
App review | ✅ Not required | |
Security audit | ✅ Not required |
Setup guide
Set up Jira Data Center
- Ensure you have a running Jira Data Center instance. If not, you can:
- Make sure you have administrator privileges on your Jira Data Center instance.
Create an incoming link
- Log in to your Jira Data Center instance as an administrator.
- Navigate to Administration > Applications > Application links.
- Select Create link.
- Select External application and then choose Incoming as the direction.
- Fill in the details as described in the sections below.
Provide application details
In the application details section:
- Enter a descriptive name for your application.
- For the Redirect URL, enter
https://api.nango.dev/oauth/callback
.
Note: This is the URL where users will be redirected after authorizing your application.
Configure application permissions
Select the appropriate permission scopes for your integration:
- READ: View projects and issues the user can view, including related items like dashboards, filters, attachments, or comments.
- WRITE: Create, update, and delete projects and issues the user can change, including related items.
- ADMIN: Perform most administrative functions on the entire Jira instance.
- SYSTEM_ADMIN: Perform all administrative functions on the entire Jira instance.
Note: Choose only the scopes your application needs. Higher-level scopes automatically include lower-level ones (e.g., WRITE includes READ).
Obtain OAuth credentials
-
After creating the incoming link, you’ll receive your OAuth credentials:
- Client ID: The identifier for your application
- Client Secret: The secret key for your application
-
Store these credentials securely as you’ll need them to configure your integration in Nango.
Configure your integration in Nango
When setting up your Jira Data Center integration in Nango:
- Use your Client ID and Client Secret from the previous step
- For the authorization URL, use:
https://[your-jira-instance]/rest/oauth2/latest/authorize
- For the token URL, use:
https://[your-jira-instance]/rest/oauth2/latest/token
- Replace
[your-jira-instance]
with your actual Jira Data Center instance URL
Test the OAuth flow
- After configuring your integration in Nango, test the OAuth flow to ensure it works correctly.
- The authorization flow will redirect users to Jira where they can approve access to their account.
- After approval, users will be redirected back to your application with an authorization code.
- This code will be exchanged for access and refresh tokens.
Next
Follow the Quickstart.
Useful links
- How to create an incoming Application Link
- OAuth related docs
- List of OAuth scopes
- Jira Data Center API docs
Common Scopes
The list of scopes supported by the Jira Data Center API can be found in the Provider API scopes documentation