Atlassian Authentication

Applies to Collaborator 13.7, last modified on July 16, 2021

This topic describes how to enable authentication to Collaborator server using Atlassian account. To achieve this, you need create OAuth application on the Atlassian side and specify its parameters in Collaborator server. To learn about other authentication options, see Additional Authentication Options.

For existing users: To login to Collaborator using your Atlassian account, please ensure that your email address specified in User preferences coincides with email address specified in Atlassian account profile.
Atlassian authentication for Collaborator can be used on organization level only.

Enable HTTPS Connections

Atlassian OAuth application will use HTTPS connections, thus you will need to enable it for Collaborator server as well. For instructions, please see Configure HTTPS. Do not forget to restart the Collaborator server to apply changes.

Configure Atlassian OAuth

  1. Log into Atlassian Developer Console under organization you have administrative access to.

  2. In the upper-right corner click Create and then select OAuth 2.0 integration from the drop-down. This will display the new application settings.

    New application settings

    Click the image to enlarge it.

  3. Specify any meaningful name for your application, check the "I agree to be bound by Atlassian's developer terms" check box and click Create.

    This will create an application and display its settings.

  4. Select Authorization in the left menu.

  5. Next to OAuth 2.0 (3LO), select Configure.

  6. In the Callback URL setting specify the URL where the OAuth response will be sent to.

    Collaborator servers have this service at the following endpoint: https://yourcollabserver.com/services/atlassian/oauth/response

    Callback URL setting

    Click the image to enlarge it.

  7. Click Save changes.

  8. Select Permissions in the left menu.

  9. Locate the Jira platform REST API and User identity API items and click Add next to them. Optionally, add any other API scopes to be used for authorization.

    Permissions setting

    Click the image to enlarge it.

  10. Select Distribution in the left menu.

  11. Under the Enable sharing setting click the Marketplace Support Service Desk link to submit a request to make your app public.

    Enable sharing setting

    Click the image to enlarge it.

    Once the request is approved, toggle-on the Enable sharing slider.

  12. Select Settings in the left menu.
  13. Copy the values of Client ID and Secret, as we will user them a bit latter.

    OAuth application settings

    Click the image to enlarge it.

Configure Collaborator Server

  1. Open the Collaborator login page in a browser and log in to Collaborator as an administrator.

  2. In Collaborator, go to Admin > Additional Login Options.

  3. Locate the Atlassian OAuth configuration and click Edit. This will display the configuration settings.

    The Atlassian OAuth settings page

    Click the image to enlarge it.

  4. Specify the setting values:

    OAuth Client ID and OAuth Client secret The Client ID and secret of OAuth application for Collaborator integration.
    This is the application that we have created on the Atlassian server earlier.
    Atlassian resources

    The names of Atlassian resources (organizations) whose members would be allowed to log in.

    Use ',' as a separator if several resources should be specified.

    Enable Sign in with Atlassian OAuth Specifies whether to enable authentication using Atlassian accounts.

Now the integration between Collaborator and your Atlassian OAuth application is configured and running.

Technical details

Atlassian authentication for Collaborator can be used on organization level only.

Collaborator retrieves user information from the Atlassian server and checks if any of existing users have matching login names or email addresses. Once such user is found, it logs the user in. Otherwise, it creates a new user account in Collaborator.

See Also

Additional Authentication Options
GitHub Authentication
Link User Accounts

Highlight search results