Setting up Rational DOORS Web Access to access remote applications with OSLC

You can set up IBM® Rational® DOORS® Web Access so that it can access the data that is stored in a remote application by using OSLC. Gather information about the remote application from its administrator and register the application with Rational DOORS.

Before you begin

Contact the administrator of the other application that you want to integrate with and request the OAuth Consumer Name, the Consumer Secret, and the Root Services URL for the application.

About this task

When you receive the necessary information from the administrator of the remote application, use the Remote Services window to register the details.

After you register the remote application, you add the projects from the remote application that you want to integrate with.

Note: If you do not do these steps correctly, an error is displayed when you try to set up links between Rational DOORS Web Access and the other application. After you configure the integration, an error is also displayed if you uninstall the remote application or if connectivity to the application is interrupted.

Procedure

  1. Log in to Rational DOORS as a database manager or a custom user who has the power to manage the database.
  2. Click File > OSLC > Remote Services. The Remote Services window opens.
  3. In the Server List pane, click Add and complete the fields with the information that you were given by the administrator of the remote application.
    Note: When you configure "friend" relationships for OSLC linking between participating servers, always use a server name. Do not use an IP address.
  4. Click Register. The remote application is added to the list.
  5. In the Collaboration Links pane, click Add.
  6. Select the remote application that you registered and browse to the project in the application that you want to integrate with. You might be prompted to log in to the remote application.
  7. Click Add to complete the integration with the project.

What to do next

You must give the administrator of the other application a Consumer Key, OAuth Secret, and the Root Services URL for your Rational DOORS Web Access installation.

For information about gathering this information, see Setting up Rational DOORS Web Access to be accessed by remote applications with OSLC.

If you integrate Rational DOORS Web Access with an application that uses Jazz Team Server and link discovery, you are prompted to authenticate when you open modules that contain links to the remote application. You can avoid repeated authentication prompts by designating Rational DOORS Web Access as a trusted service.
  1. Log on to the remote application server and open the Server Administration page, for example:
    • Jazz Team Server: https://host-name:9443/jts/admin
    • Design Management Server: https://host-name:9443/dm/admin
  2. In the Communication section, click Consumers (Inbound).
  3. Edit the Rational DOORS Web Access consumer and ensure that the Trusted check box is selected.
  4. Click Advanced Properties.
  5. In the com.ibm.team.repository.service.internal.oauth.TrustedCallbackService section, enter a Trusted Callback Service URL value that specifies the URL to the Rational DOORS Web Access server; for example, https://dwaserver.com:9443. This entry establishes the trusted server URI that corresponds to the Trusted option.
  6. Save the Advanced Properties settings.
Note: If you move a Rational DOORS database that contains OSLC links to a different server, the OSLC links in the associated application are broken. You must configure each link from any associated applications to the new database server.
Related concepts:
Configuring Rational DOORS Web Access to use OSLC

Feedback