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 supports Unified Application Links (i.e. has UAL installed). If you are linking to a non-UAL application, you will need to do additional configuration in the non-UAL application. This is because UAL in your UAL-enable application will not be able to access your non-UAL application to automatically configure authentication for you.

Please read the appropriate set of instructions below:

On this page:

Before you begin:

To link to an application that supports UAL:

  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, in the 'Server URL' field. 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 (i.e. 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 (if you are not logged into the remote server already):
      (info) Please note, these credentials are only used to authenticate you to the remote server, so that UAL 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 will be used to display browser links to this application. You may have used a server URL that is not accessible to other users in the previous 'Link to another server' dialogue, e.g. an internal IP address. If so, you can change the accessible URL to an address in a domain that is available 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:
    (info) 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 supports UAL (click to view full-sized images)

Before you begin:

To link to an application that does not support UAL:

  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 is the URL that is displayed in browser links pointing to this application. 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 (trusted apps, OAuth, basic http, none) for your new application link using UAL. See Configuring Authentication for an Application Link.
  7. In your application that does not support UAL, 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 apps authentication in your UAL-enabled application, you also need log into your non-UAL application and manually configure trusted apps (see the relevant administrator's documentation for the application).

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

  • No labels