Docs

Add Atlassian as a social connection

How to set up social connection with Atlassian

Overview

Adding social connection with Atlassian to your app with Clerk is done in a few steps - you will need to populate the Client ID, Client Secret and Redirect URI in your instance settings.

To make the development flow as smooth as possible, Clerk uses preconfigured shared OAuth credentials and redirect URIs for development instances - no other configuration is needed.

For production instances, you will need to generate your own Client ID and Client Secret using your Atlassian account.

Note

The purpose of this guide is to help you create an Atlassian account and an Atlassian OAuth 2.0 Integration - if you're looking for step-by-step instructions using Clerk to add social connection (OAuth) to your application, follow the Social connection (OAuth) guide.

Before you start

Configuring an Atlassian OAuth 2.0 Integration

You can navigate to the list of all your apps to select an existing app or create a new one:

Atlassian app listing

From there, click on the desired existing app or create a new one, which will take you to the app page.

Atlassian OAuth 2.0 app page

While not necessary for the integration to work, you can edit your app name, description and set a logo for it in the Settings tab.

Atlassian OAuth 2.0 settings page

From the app page, click on the Permissions tab in the sidebar menu.

Atlassian OAuth 2.0 Integration permissions

Here, you will need to configure the OAuth 2.0 scopes that should be requested from your users when they attempt to connect with Atlassian.

At the very minimum, you will need to enable the User identity API, which corresponds to the read:me OAuth 2.0 scope. This enables Clerk to retrieve basic user profile info when creating users for your app.

Afterwards, you will need to set up the Callback URL so that Atlassian can redirect back to your Clerk app upon successful connection.

This is done by navigating to the Authorization section and clicking on Add.

Atlassian OAuth 2.0 Authorization page

In this section, you will need to paste the Redirect URI that Clerk has provided for you.

Atlassian OAuth 2.0 App callback URL settings

After entering the callback URL, the Client ID & Client Secret will now be available in the Settings tab:

Atlassian OAuth 2.0 settings page with Client ID & Client Secret

You will need to copy these values and paste:

  • The Atlassian Client ID to the Client ID input on Clerk
  • The Atlassian Client Secret to the Client Secret input on Clerk
Client ID and Client Secret inputs for Atlassian connection

If you have enabled further scopes on Atlassian, you can add them in the Clerk Atlassian configuration settings as well. This will affect the tokens that Atlassian issues to you, so that you can access the intended Atlassian resources.

Finally, you will need to make your Atlassian app publicly accessible, since it starts out as private by default. This is done from the Distribution tab:

Atlassian OAuth 2.0 app distribution settings

After clicking on Edit, you will need to provide the following information and save the form:

  • Set the distribution status to Sharing
  • Enter your vendor name
  • Enter a link to your privacy policy page
  • Enter a link to yout terms page
  • Add a contact page link (optional)
  • Indicate that your data does store data, since at the very least the user profile info is used to create users on the Clerk end
Atlassian OAuth2 distribution sharing form

Notes:

  • To be able to connect, the user must have access to at least one Atlassian site (e.g. JIRA, Confluence)
  • Currently the user can authorize access only to a single Atlassian site

Congratulations! Social connection with Atlassian is now configured for your instance.

Feedback

What did you think of this content?

Last updated on