Skip to main content

Authentication - Atlassian oAuth

This guide will walk you through the process of setting up OAuth for Atlassian, helping you seamlessly integrate this essential tool with your existing systems.

Updated over 2 months ago

This guide will walk you through the process of setting up OAuth for Atlassian, helping you seamlessly integrate this essential tool with your existing systems. Whether you’re a developer or an IT administrator, follow these steps to simplify authentication and ensure a secure connection to Confluence’s APIs. Let’s get started!

Steps

Step 1: Navigate to the Integration Builder in Workspace 365

  1. Log in to Workspace 365.

  2. Go to the Integration Builder via the menu or the settings page.

  3. Click on the Authentication tab at the top of the page.

  4. Then click the New button to create a new authentication.

Step 2: Select the OAuth2 type and enter a name

  1. After clicking New, a window will appear to configure the authentication.

  2. In the Type field, select the OAuth2 option from the available choices.

  3. In the Name field, enter a recognisable name. For this guide, we will use:
    ​OAuth2 confluence Authentication.

Step 3: Access the Atlassian Developer Console and Log In

  1. Open your web browser and navigate to the Atlassian Developer Console.

  2. If prompted, enter your Atlassian account credentials to log in. Ensure you use an account with the necessary administrative permissions for setting up OAuth.

Once logged in, you’ll be directed to the My Apps dashboard, where you can manage your applications and integrations.

Step 4: Create a New OAuth 2.0 Integration

  1. On the My Apps dashboard, locate and click the Create button.

  2. From the available options, select OAuth 2.0 integration to begin setting up a new OAuth integration.

This will open a form where you can configure the details for your OAuth application.

Step 5: Name Your App and Agree to the Developer Terms

  1. In the form that appears, enter a name for your app. For this guide, use the name OAuth Connection Workspace365 Integration Builder to ensure consistency with the setup instructions.

  2. Scroll down and review the Developer Terms. Tick the checkbox to indicate your agreement.

  3. Once completed, click the Create button to finalise the setup.

Your OAuth app will now be created, and you’ll be redirected to its configuration page.

Step 6: Navigate to Authorisation and Add OAuth 2.0 (3LO)

  1. After creating your app, go to the Authorisation section in the app’s configuration page.

  2. Locate the OAuth 2.0 (3LO) option and click on the Add button next to it.

Step 7: Fill in the Redirect URL

  1. In the OAuth 2.0 (3LO) configuration settings, locate the field labelled Callback URL.

  2. Open your Workspace 365 environment and navigate to New Authentication

  3. Copy the Redirect URL provided in the Workspace 365 settings.

  4. Return to the Atlassian Developer Console and paste the copied URL into the Callback URL field and click on Save changes.

Step 8: Add Permissions for the Confluence API

  1. In the app’s configuration page, navigate to the Permissions section.

  2. Locate the Confluence API option and click on the Add button next to it.

  3. When prompted to select scopes, refer to the integration guide for the specific Confluence integration you are setting up. This guide will outline the exact scopes required for proper functionality.

Using the correct scopes ensures that the integration has all necessary permissions to operate seamlessly.

Step 9: Navigate to Settings

  1. In the app’s configuration page, locate and click on the Settings tab.

  2. In this section, you will find the Client ID and Client Secret for your app.

  3. Copy the Client ID and paste it into the Client ID field in the Authentication tab in Workspace 365.

  4. Copy the Client Secret and paste it into the Client Secret field in the Authentication tab in Workspace 365.

These values are essential for linking the OAuth integration with Workspace 365. Make sure to handle them securely and avoid sharing them publicly.

Step 10: Fill in the Authorisation and Token Endpoint URLs

  1. In the Authentication tab of Workspace 365, locate the fields for Authorisation Endpoint URL and Token Endpoint URL.

  2. Copy and paste the following URLs into the respective fields:

These URLs are necessary to complete the OAuth configuration and establish secure communication between Workspace 365 and Confluence. Ensure they are entered exactly as shown.

Step 11: Add the Required Scope to the Authentication

  1. In the Authentication tab of Workspace 365, locate the field for Scopes.

  2. Refer to the specific integration guide for the Confluence integration you are setting up to identify the required scope(s).

  3. Enter the necessary scope(s) into the Scopes field as specified in the guide.

Adding the correct scope ensures that the authentication process has the permissions needed for the Confluence integration to function properly.

Step 12: Save and Authenticate

  1. Click on Save in the Authentication tab of Workspace 365 to apply your changes.

  2. A pop-up window will appear prompting you to authenticate. Click on Authenticate to proceed.

  3. In the Atlassian authentication pop-up, review the requested permissions and click Allow to grant access.

Once this process is completed, the authentication should be successfully configured, and your integration with Confluence will be ready to use.

Related Articles
Authentication -Microsoft Graph oAuth2
Authentication - ExactOnline oAuth
Search simplified - Confluence page
Search simplified - Jira
Authentication – Dynamics Business Central (OAuth 2.0)
Did this answer your question?