How to adjust an existing Application Link to use OAuth
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Does this apply to you?
We recommend the use of OAuth for Application Links. Because all new Application Links use OAuth, only older links need to be updated. Recreating the link ensures it is created correctly; however it is possible to update an existing link as well.
Recreate the link
Recreating the link ensures that the application link is correctly configured for the current environment.
Note: Deleting or modifying an Application Link is a non-destructive process. Any existing macros or gadgets will resume functioning once the link has been recreated correctly. No content is removed as a result of removing an Application Link.
To delete the link
Log into your application as an Administrator
Browse to the "Application Links" screen of your application
Click the Delete Icon next to the application link you wish to delete.
The application will attempt to contact the linked application to delete the link. You should delete both sides of the link before recreating it
In some cases, it may not be possible to automatically delete the link from the linked application. You should log in to the linked application as an Administrator and verify that it has been deleted correctly.
To create a new link
Log into your application as an Administrator
Browse to the "Application Links" screen of your application
Enter the URL of the application you'd like to link to
Follow the on screen instructions.
Update an existing Link
Disable the existing authentication mechanisms
For each application, disable the Trusted Applications and Basic Authentication mechanisms:
Log into your application as an Administrator, and browse to the "Application Links" screen
Click "Edit" next to the Application Link you wish to change
Click "Outgoing Authentication"
Click the "Trusted Applications" tab
If Trusted Applications is enabled, click "Disable"
Click the "Basic Access" tab
If Basic Authentication is enabled, click "Disable"
Click "Incoming Authentication"
Repeat Steps 5-7
Enable OAuth
For each application, enable the OAuth authentication mechanism:
Log into your application as an Administrator, and browse to the "Application Links" screen
Click "Outgoing Authentication"
Click the "OAuth" tab
Click "Enable"
At this point, 3-Legged OAuth (3LO) has been enabled. When a user access information from another application, they'll be prompted to allow access. You can enable 2-Legged OAuth (2LO) and 2-Legged OAuth with Impersonation (2LOi) requests if required.
Note: The "Execute As" option is only available on the "Incoming Authentication" screen of an application link.
Was this helpful?