Atlassian Server Authentication

• 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.

• Integration requires Jira server/DataCenter version 8.22 or higher (OAuth 2.0).

Atlassian Server OAuth application link 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.

1. Log into Jira server and go to Administration > Applications > Application links.

2. Select Create link.

3. Select External application, and then choose Incoming as the direction.

4. Fill in Name, Redirect URL and Permission.

   

   Click the image to enlarge it.

   Redirect 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/server/oauth/response

5. Make sure Permission is set to Read.

6. Save configuration.

7. Jira will generate the OAuth credentials that include these details. Copy the values of Client ID and Client secret, as we will user them a bit latter.

   

   Click the image to enlarge it.

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 Server OAuth configuration and click Edit. This will display the configuration settings.

   

   Click the image to enlarge it.

4. Specify the setting values:

   Atlassian Server URL	The Atlassian Server URL whose members would be allowed to log in.
   OAuth Client ID and OAuth Client secret	The Client ID and secret of OAuth application link for Collaborator integration. This is the application that we have created on the Atlassian server earlier.
   Restrict access to JIRA	Specifies whether to restrict access to JIRA data (links to projects and tickets, their status) on the Collaborator side based on current user permissions on the Atlassian side. If disabled, Collaborator displays all JIRA items that are accessible to the particular account that was specified in JIRA Integration settings. If enabled and the user had signed in using Atlassian account, Collaborator will display active links only to those JIRA items that are accessible to current user on the Atlassian side. JIRA items that are not accessible to current user will be displayed as plain-text. If enabled and the user had signed in using Collaborator's generic authentication, Collaborator will display plain-text instead of JIRA links. See Restrict access to JIRA items section in Configuring JIRA Integration.
   Enable Sign in with Atlassian OAuth	Specifies whether to enable authentication using Atlassian accounts.

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