Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

This page describes how to add a new application link in JIRA. The process for adding an application link is different depending on whether or not the application you are linking JIRA to supports Atlassian's Application Links.

If you are linking JIRA to an application without Application Links, you will need to perform additional configuration steps in that application, since the Application Links function in JIRA is unable to automatically configure authentication in applications that do not support Application Links.

Please read the appropriate set of instructions below:

On this page:

(warning) The information on this page does not apply to JIRA OnDemand.

 

Before you begin:

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. The 'Configure Application Links' page will appear, showing the application links that have 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.
      (info) 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 behaviour 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_OLD.
  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)

Before you begin:

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. The 'Configure Application Links' page will appear, showing the application links that have been set up.
  2. Click 'Add Application Link'. Step 1 of the 'Link to another server' dialogue will be displayed.
  3. Enter the server URL of the application that you want to link to, in the 'Server URL' field. Click the 'Next' button. Step 2 of the 'Link to another server' dialogue will be displayed.
  4. 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: Bamboo, FishEye/Crucible, JIRA, Confluence, Subversion.
    • 'Application URL' — This will be set to the server URL you entered in the previous step and will not be editable.
  5. Click the 'Create' button to create the application link. The 'Configure Application Links' page will be displayed, listing all of the application links that have currently been set up for your application including the one you just added.
  6. Configure the desired authentication type (Trusted Applications, OAuth, basic HTTP, none) for your new application link. See Configuring Authentication for an Application Link.
  7. In your application that does not support Application Links, configure 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 Trusted Applications authentication in your Application-Links-enabled application, you also need log into your non-Application-Links application and manually configure Trusted Applications (see the relevant administrator's documentation for the application).
Step 1
Step 2

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

  • No labels



See our Getting Help page for details.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.