Atlassian

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

Note

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

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.

Warning

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

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

Identity

Scope	Description
read:me	Read the current user’s profile and discover accessible cloud instances (required for all Jira/Confluence API calls)
offline_access	Access resources on behalf of the user when they are not present

Jira

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

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

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.

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
addComment	admin, send	POST	/rest/api/3/issue/{issueIdOrKey}/comment
addNotifications	send	PUT	/rest/api/3/notificationscheme/{id}/notification
createNotificationScheme	send	POST	/rest/api/3/notificationscheme
getCommentsByIds	send	POST	/rest/api/3/comment/list
notify	admin, send	POST	/rest/api/3/issue/{issueIdOrKey}/notify
publishDraftWorkflowScheme	send	POST	/rest/api/3/workflowscheme/{id}/draft/publish
setCommentProperty	admin, send	PUT	/rest/api/3/comment/{commentId}/properties/{propertyKey}
updateComment	admin, send	PUT	/rest/api/3/issue/{issueIdOrKey}/comment/{id}
updateProjectEmail	send	PUT	/rest/api/3/project/{projectId}/email
reorderCustomFieldOptions	payment	PUT	/rest/api/3/field/{fieldId}/context/{contextId}/option/move
reorderIssueTypesInIssueTypeScheme	payment	PUT	/rest/api/3/issuetypescheme/{issueTypeSchemeId}/issuetype/move
AddonPropertiesResource.deleteAddonProperty_delete	admin, delete	DELETE	/rest/atlassian-connect/1/addons/{addonKey}/properties/{propertyKey}
bulkDeleteIssueProperty	admin, delete	DELETE	/rest/api/3/issue/properties/{propertyKey}
bulkDeleteWorklogs	admin, delete	DELETE	/rest/api/3/issue/{issueIdOrKey}/worklog
cancelTask	delete, write	POST	/rest/api/3/task/{taskId}/cancel
deleteActor	admin, delete	DELETE	/rest/api/3/project/{projectIdOrKey}/role/{id}
deleteAndReplaceVersion	delete, write	POST	/rest/api/3/version/{id}/removeAndSwap
deleteAvatar	delete	DELETE	/rest/api/3/universal_avatar/type/{type}/owner/{owningObjectId}/avatar/{id}
deleteComment	admin, delete	DELETE	/rest/api/3/issue/{issueIdOrKey}/comment/{id}
deleteCommentProperty	admin, delete	DELETE	/rest/api/3/comment/{commentId}/properties/{propertyKey}
deleteComponent	delete	DELETE	/rest/api/3/component/{id}
ConnectToForgeMigrationTaskSubmissionResource.submitTask_post	admin, write	POST	/rest/atlassian-connect/1/migration/{connectKey}/{jiraIssueFieldsKey}/task
addAttachment	admin, write	POST	/rest/api/3/issue/{issueIdOrKey}/attachments
addSecurityLevelMembers	admin, write	PUT	/rest/api/3/issuesecurityschemes/{schemeId}/level/{levelId}/member
addVote	admin, write	POST	/rest/api/3/issue/{issueIdOrKey}/votes
addWatcher	admin, write	POST	/rest/api/3/issue/{issueIdOrKey}/watchers
addIssueTypesToContext	write	PUT	/rest/api/3/field/{fieldId}/context/{contextId}/issuetype
addIssueTypesToIssueTypeScheme	write	PUT	/rest/api/3/issuetypescheme/{issueTypeSchemeId}/issuetype
addScreenTab	write	POST	/rest/api/3/screens/{screenId}/tabs
addSecurityLevel	write	PUT	/rest/api/3/issuesecurityschemes/{schemeId}/level
appendMappingsForIssueTypeScreenScheme	write	PUT	/rest/api/3/issuetypescreenscheme/{issueTypeScreenSchemeId}/mapping
createCustomFieldContext	write	POST	/rest/api/3/field/{fieldId}/context
createCustomFieldOption	write	POST	/rest/api/3/field/{fieldId}/context/{contextId}/option
createIssueTypeAvatar	write	POST	/rest/api/3/issuetype/{id}/avatar2
ConnectToForgeMigrationFetchTaskResource.fetchMigrationTask_get	read	GET	/rest/atlassian-connect/1/migration/{connectKey}/{jiraIssueFieldsKey}/task
getAllIssueFieldOptions	read	GET	/rest/api/3/field/{fieldKey}/option
getAlternativeIssueTypes	read	GET	/rest/api/3/issuetype/{id}/alternatives
getBulkOperationProgress	read	GET	/rest/api/3/bulk/queue/{taskId}
getChangeLogs	read	GET	/rest/api/3/issue/{issueIdOrKey}/changelog
getComment	read	GET	/rest/api/3/issue/{issueIdOrKey}/comment/{id}