In this example, we will create a two-way Trusted Apps application link between a "local" FishEye server with UAL ((http://fisheye.example.com/ in this example) and a "remote" JIRA server without UAL (http://jira.example.com/ in this example). We'll add the link from the FishEye server. In FishEye, do the following: Excerpt Include |
---|
| _AppLinksNav |
---|
| _AppLinksNav |
---|
nopanel | true_AppLinksNav |
---|
| Click 'Add Application Link' to open the add application link wizard.1. Specifying the Remote ApplicationFirst, we need to specify which application we are linking to. Enter the URL for the JIRA server in the 'Link to another server' dialogue, as shown in the screenshot below, and click 'Next'. Screenshot: Entering the server URL Gliffy Diagram |
---|
size | M |
---|
name | Add AppLink - Server URL |
---|
|
2. Creating the Application LinkEnter an 'Application Name' and choose the 'Application Type' to be 'JIRA'. Click the 'Create' button. The application link will be created and displayed on the 'Configure Application Links' page. Our JIRA server does not have UAL, so we cannot automatically create a link back to our FishEye server nor set up authentication. We'll manually set these up in the next step. Screenshot: Creating the application link Gliffy Diagram |
---|
size | M |
---|
name | Add AppLink - Link Back |
---|
|
3. Configuring Authentication for the Application LinkWe are going to use Trusted Apps authentication for all incoming and outgoing requests via the application link, as both servers share the same userbase. Trusted Apps authentication is recommended when both applications fully trust each other and share the same set of users (read more about configuring Trusted Apps authentication). Other authentication configurations are described in Configuring Authentication for an Application Link. On the 'Configure Application Links' page, click the 'Configure' link next to the application link just created. The configuration dialogue for the application link will be displayed. First, we need to configure our JIRA server to trust our FishEye server. Navigate to the 'Outgoing Authentication' tab on the configuration dialogue and click the 'Configure' button on the 'Trusted Applications' sub-tab. Click the 'Apply' button to apply trusted apps authentication. We also need to configure our FishEye server to trust our JIRA server. Navigate to the 'Incoming Authentication' tab on the configuration dialogue and click the 'Configure' button on the 'Trusted Applications' sub-tab. Click the 'Apply' button to apply trusted apps authentication. Screenshot: Setting up Trusted Apps authentication for an application link (click to view larger image) Gliffy Diagram |
---|
size | M |
---|
name | Add AppLink - Authentication |
---|
|
4. Additional JIRA ConfigurationOur JIRA server does not have UAL, so we need to perform additional trusted apps configuration in JIRA before our application link will work. Follow the instructions on adding a trusted app in the JIRA documentation: Configuring Trusted Applications. You will need to enter the following information: - 'Base URL' — Enter the URL of your FishEye server, 'http://fisheye.example.com/'
- 'Application Name' — Enter the name for your FishEye server, 'Example FishEye'.
- 'Timeout' — '10000'
- 'IP Addresses' — Leave this blank, unless you are using a proxy server (if so, see the trusted apps documentation for further instructions).
- 'URL Patterns' — Enter the following URLs:
/sr/jira.issueviews:searchrequest, /secure/RunPortlet, /rest, /rpc/soap
You may also want to enable issues activity in your activity stream. To do this, navigate to your Application Links and click the 'JIRA settings' link next to your application link. Tick the 'Include in 'Activity Streams' checkbox and click 'Save'. Congratulations, you've just created an application link! |