Linking to another application
Linking two Atlassian applications, for example FishEye and JIRA Software, allows you to access one application's functions and resources from within the other. You link two applications by creating an application link between them.
See Integrating FishEye with Atlassian applications for an overview of the benefits of integrating your Atlassian applications with FishEye.
To link two Atlassian applications:
- Click the 'cog' menu in the FishEye header, and choose Administration (you'll need to be logged in as an administrator to see this link).
- Choose Application Links in the left-hand panel. The Application Links configuration page displays links that have already been set up.
Enter the URL of the application you want to link to, then click Create new link.
- If you check The servers have the same set of users... then this link will be configured using OAuth (with impersonation) authentication.
- If you are not an admin on both servers you won't be able to set up a 2-way (reciprocal) application link. If you want to go ahead and create a 1-way link anyway, clear the I am an administrator on both instances checkbox.
- Use the wizard to finish configuring the link.
- For FishEye 3.2 and later, creating a new application link now uses OAuth by default and enables both 3-legged OAuth (3LO) and 2-legged OAuth (2LO).
- When updating older application links (that perhaps used Trusted Apps authentication) to use OAuth, 3LO is used by default, but you need to explicitly enable 2LO using the check box in the application link configuration settings.
- Only use the 2LO with impersonation option in the application link configuration settings if your servers both have the same set of users and they fully trust each other.
When you complete the wizard, the Application Links plugin will create the link between your applications using the most secure authentication method that is supported between the two application types. After the link has been set up, it will appear on the "Configure Application Links" page. You can use this page to edit the configuration of application links to make them more secure or to change the link settings:
- To edit the settings of the application link (for example, to change the authentication type of the link), select Edit.
- If you've set up multiple links to the same type of application (for example, multiple JIRA servers), you can use the Make Primary link to specify which application is the default instance. See Making a Primary Link for Links to the Same Application Type for more information.
Having trouble integrating your Atlassian products with application links?
We've developed a guide to troubleshooting application links, to help you out. Take a look at it if you need a hand getting around any errors or roadblocks with setting up application links.