Adding an Application Link

Adding an Application Link to an Application That Supports Application Links

Before you begin:

• Make sure that the base URL is set correctly in JIRA. See Configuring JIRA Options for instructions.
• Make sure that the base URL is set correctly in the application which you intend to link to. See the appropriate instructions: Confluence instructions | FishEye/Crucible instructions | Bamboo instructions). This is required for synchronisation to work correctly.

To link to an application that supports Application Links:

1. Log in as a system administrator and go to the administration page. Click Application Links in the administration menu. You'll see a list of the application links that have already been set up.
2. Click 'Add Application Link'. Step 1 of the link wizard will appear.
3. Enter the server URL of the application that you want to link to (the 'remote application').
4. Click the 'Next' button. Step 2 of the link wizard will appear.
5. Enter the following information:
   • 'Also create a link from 'XYZ' back to this server' – Select this option if you want to create a two-way link between the remote application (which in this case is called 'XYZ') and your application. If you want to do this, you will need to enter the username and password of an administrator for the remote application.
     Please Note:
     • These credentials are not saved. They are only used at this step of the wizard to authenticate with the remote application, so that a reciprocal Application Link can be created in the remote application back to your application.
     • If the the remote application is Jira or Confluence, these credentials need to be a user account with the system administrator global permission.
   • 'Reciprocal Link URL' – The URL you give here will override the base URL specified in your remote application's administration console, for the purposes of the application links connection. Application Links will use this URL to access the remote application.
6. Click the 'Next' button. Step 3 of the link wizard will appear.
7. Enter the information required to configure authentication for your application link:
   • 'The servers have the same set of users and usernames' or 'The servers have either different sets of users or usernames' – Select one of these options depending on how you manage users between the two applications.
   • 'These servers fully trust each other' – Select this option if you fully understand and trust the behavior of both applications at all times and are sure that each application will maintain the security of their private key.
     For more information about configuring authentication, see Configuring Authentication for an Application Link.
8. Click the 'Create' button to create the application link.

Step 1	Step 2	Step 3

Screenshots above: Adding an application link to an application that supports Application Links (click to view full-sized images)

Adding an Application Link to an Application That Does Not Support Application Links

Before you begin:

• Make sure that the base URL is set correctly in JIRA. See Configuring JIRA Options for instructions.
• Make sure that the base URL is set correctly in the application which you intend to link to. See the appropriate instructions: Confluence instructions | FishEye/Crucible instructions | Bamboo instructions). This is required for synchronisation to work correctly.

To link to an application that does not support Application Links:

1. Log in as a system administrator and go to the administration page. Click Application Links in the administration menu. You'll see a list of the application links that have already been set up.
2. Enter the URL of the application that you want to link to and click Create new link.
3. Fill out the fields, as follows:
   • Application Name — Enter the name by which this remote application will be referred to, in your application.
   • Application Type — Select the type of application that you are linking to: Generic, Fisheye/Crucible, Confluence, Bitbucket Server, Bamboo, Jira.
4. Click Continue to create the application link. You'll see the application link that you just added on the 'Configure Application Links' page.
5. Edit the new link to set up authentication (OAuth is recommended) for your new application link. 
6. In the linked application that does not support Application Links, set up  the same type of authentication that you configured for your application link's outgoing authentication (in the previous step). For example, if you configured outgoing OAuth authentication in your Application-Links-enabled application, you also need log into your non-Application-Links application and manually configure OAuth (see the relevant administrator's documentation for the application).
   For more information about configuring authentication, see Configuring Authentication for an Application Link.

Step 1	Step 2

Screenshots above: Adding an application link to an application that supports Application Links (click to view full-sized images)

Related Topics

• Making an Application Link the Primary Link
• Configuring Authentication for an Application Link
• Configuring Project Links across Applications