Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.alterauth.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Connect your users to Atlassian for Jira issue tracking, Confluence wiki access, and team collaboration.
PropertyValue
Provider IDatlassian
CategoryDeveloper Tools
PKCESupported
Token refreshAutomatic
Redirect URIShown in Developer Portal
This provider covers Jira and Confluence via Atlassian’s unified OAuth 2.0 (3LO). For Bitbucket, use the dedicated Bitbucket provider.

​
Step 1: Create an Atlassian OAuth App

1

Go to the Atlassian Developer Console

Navigate to developer.atlassian.com/console/myapps and sign in.
2

Create a new OAuth 2.0 integration

Click Create then OAuth 2.0 integration. Enter your app name.
3

Add the callback URL

Under Authorization, add the Redirect URI from the Developer Portal to the Callback URL field.
4

Configure permissions

Under Permissions, add the required scopes for your Atlassian products (Jira, Confluence).
5

Get your credentials

Go to Settings to find your Client ID and Secret.
Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

​
Step 2: Add to Alter Vault

1

Open the Developer Portal

Go to portal.alterauth.com and navigate to your app.
2

Add Atlassian provider

Go to OAuth Providers > Add Provider > Atlassian.
3

Enter credentials

  • Client ID: Paste your Atlassian Client ID
  • Client Secret: Paste your Atlassian Client Secret
4

Select scopes

Choose the scopes your app needs.
5

Save

Click Save. The provider is now active.

​
Available Scopes

​
Identity

ScopeDescription
read:meRead the current user’s profile and discover accessible cloud instances (required for all API calls)
offline_accessAccess resources on behalf of the user when they are not present

​
Jira

ScopeDescription
read:jira-workRead Jira project and issue data
write:jira-workCreate and edit Jira issues and projects
read:jira-userRead Jira user information

​
Confluence

ScopeDescription
read:confluence-content.allRead Confluence pages and blog posts
write:confluence-contentCreate and update Confluence pages
read:confluence-space.summaryRead Confluence space summaries

​
Notes

  • You must configure specific API scopes under Permissions in the Atlassian Developer Console for each product (Jira, Confluence).
  • The read:me scope is required for all Atlassian API calls to discover accessible cloud instances.
  • See the Atlassian OAuth documentation for more details.