Establishing cross-server communication

You can establish cross-server communication by using the location information of another Jazz™ Team Server and an OAuth secret code phrase.

Before you begin

You must be a member of the JazzAdmins group.

About this task

Cross-Server communication allows you to specify other Jazz-based servers with which you want to establish server-to-server communication. Enter the location information of another Jazz Team Server and a code phrase to use as the OAuth secret. Then request access to that server to create an OAuth consumer key and store the information in the friends list. Once the OAuth key is authorized by the other server, this server will be able to interact with the other Jazz server.

Procedure

  1. Click the Server tab.
  2. In the Configuration pane, click Cross-Server Communication.
  3. On the Cross-Server Communication page, in the Title field, type a title to identify the other server. For example, My communication with server X.
  4. In the Root Services URI field, enter the URI for the Jazz root services of the server you want to add as a friend. For example, https://<friend-server>:9443/jazz/rootservices.
  5. In the OAuth Secret and Re-type Secret field, type an OAuth Secret code phrase to associate with the new OAuth consumer key.
    Note: In this step, you do not enter the key itself; you enter a shorter phrase that will be associated with the key.
  6. Optional: Select the Trusted check box. Trusted consumers can share authorization with other trusted consumers and do not require user approval to access data. For external products or Web sites, it is recommended to clear the Trusted check box.
  7. Click Request Access. A provisional key is requested on the other server and the access information is added to the server friends list. A new entry is added to the Authorize Keys section, including the new OAuth key and a link to authorize the key on the other server.

What to do next

If you have administrator permissions on the target server, follow the Grant access for the provisional key link that is provided at the bottom of the Cross-Server Communication page to navigate to OAuth Consumer Management on the target server and approve the access request; otherwise, work with a member of the administrator group on the target server to get approval for provisional OAuth consumer keys.

After you approve the access request, repeat this procedure for the other Jazz Team Servers so that they can access this Jazz Team Server.

The Server Friends List at the bottom of the Cross-Server Communication page lists the servers with which you have established cross-server communication.


Feedback