OAuth providers
Atlassian
Set up Atlassian OAuth for Jira and Confluence integration
Overview
Section titled “Overview”Connect your users to Atlassian for Jira issue tracking, Confluence wiki access, and team collaboration.
| Property | Value |
|---|---|
| Provider ID | atlassian |
| Category | Developer Tools |
| PKCE | Supported |
| Token refresh | Automatic |
| Redirect URI | Shown in Developer Portal |
Step 1: Create an Atlassian OAuth App
Section titled “Step 1: Create an Atlassian OAuth App”Go to the Atlassian Developer Console
Navigate to developer.atlassian.com/console/myapps and sign in.
Create a new OAuth 2.0 integration
Click Create then OAuth 2.0 integration. Enter the application name.
Add the callback URL
Under Authorization, add the Redirect URI from the Developer Portal to the Callback URL field.
Configure permissions
Under Permissions, add the required scopes for your Atlassian products (Jira, Confluence).
Get credentials
Go to Settings to find your Client ID and Secret.
Step 2: Add to Alter Vault
Section titled “Step 2: Add to Alter Vault”Open the Developer Portal
Go to portal.alterauth.com and navigate to the application.
Add Atlassian provider
Go to OAuth Providers > Add Provider > Atlassian.
Enter credentials
- Client ID: Paste your Atlassian Client ID
- Client Secret: Paste your Atlassian Client Secret
Select scopes
Choose the scopes the application needs.
Save
Click Save. The provider is now active.
Available Scopes
Section titled “Available Scopes”Identity
Section titled “Identity”| Scope | Description |
|---|---|
read:me | Read the current user’s profile and discover accessible cloud instances (required for all API calls) |
offline_access | Access resources on behalf of the user when they are not present |
| Scope | Description |
|---|---|
read:jira-work | Read Jira project and issue data |
write:jira-work | Create and edit Jira issues and projects |
read:jira-user | Read Jira user information |
Confluence
Section titled “Confluence”| Scope | Description |
|---|---|
read:confluence-content.all | Read Confluence pages and blog posts |
write:confluence-content | Create and update Confluence pages |
read:confluence-space.summary | Read Confluence space summaries |
- You must configure specific API scopes under Permissions in the Atlassian Developer Console for each product (Jira, Confluence).
- The
read:mescope is required for all Atlassian API calls to discover accessible cloud instances. - See the Atlassian OAuth documentation for more details.