This documentation relates to an earlier version of Application Links.
View this page in the current documentation or visit the current documentation home.

Skip to end of metadata
Go to start of metadata

This page describes how to add a new application link. The process for adding an application link is different depending on whether the application you are linking to has Application Links installed. If you are linking to a an application that does not have Application Links, you will need to do additional configuration. This is because Application Links in one application will not be able to automatically configure authentication in the application that does not have Application Links.

Please read the appropriate set of instructions below:

On this page:

Before you begin:

To link to an application that includes Application Links:

  1. Log in as an administrator and navigate to the administration page. Click 'Application Links' in the administration menu. The 'Configure Application Links' page will be displayed, listing all of the application links that have currently been set up for your application.
  2. Click 'Add Application Link'. The 'Link to another server' dialogue will be displayed.
  3. Enter the server URL of the application that you want to link to. Click the 'Next' button. The 'Link to Reference Application' dialogue will be displayed.
  4. Fill out the fields, as follows:
    • Tick the 'Create a link back to this server' checkbox, if you want to create a two-way link. This will also create a link from the remote server back to your application. If you want to do this, you will need to enter the 'Username' and 'Password'of an administrator for the remote server:
      Please note: These credentials are only used to authenticate you to the remote server, so that Application Links can make the changes required for the new link. The credentials are not saved.
    • 'Accessible URL of this application for the reciprocal link' — This URL is used when displaying links to the application in the browser. When creating the application link, you may have used a URL that is not accessible to other users, such as an internal IP address. If so, you can change the display URL to an address in a domain that is accessible to other users.
  5. Click the 'Next' button. The 'Set Users and Trust' dialogue will be displayed.
  6. Fill out the fields to configure authentication for your application link, as follows:
    For more information about configuring authentication, see Configuring Authentication for an Application Link.
    • Select either 'The servers have the same set of users' or 'The servers have different sets of users' depending on how you manage users between the two applications.
    • Tick the 'These servers fully trust each other', if you know that the code in both applications will behave itself at all times and are sure each application will maintain the security of its private key.
  7. 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.

Screenshots above: Adding an application link to an application that includes 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 an administrator and navigate to the administration page. Click 'Application Links' in the administration menu. The 'Configure Application Links' page will be displayed, listing all of the application links that have currently been set up for your application.
  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).

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

Making an Application Link the Primary Link
Configuring Authentication for an Application Link
Administering Entity Links for an Application Link

  • No labels