Establishing friend relationships

You can establish friend relationships with another Jazz™ Team Server or an IBM® Engineering Lifecycle Management (ELM) application by providing the location information of the friend and an OAuth secret code phrase.

About this task

Adding a friend relationship 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 or ELM application 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. After the OAuth key is authorized by the other server, this server will be able to interact with the other Jazz Team Server or ELM application.
Note: When Jazz Security Architecture single sign-on (SSO) is enabled and the friend applications are registered with the same Jazz Authorization Server, use this procedure only to add the location information for each Jazz application. In such a deployment, instead of using OAuth consumer keys, the friend relationship is established by using the OpenID Connect (OIDC) authentication protocol. OIDC authentication is simpler than OAuth authentication because no OAuth consumer key is involved and therefore, no approval of a provisional consumer key is required.

Procedure

  1. Log in to the Administration page of the Jazz Team Server or an application registered with the server.
    • For the Jazz Team Server:
      1. Point your web browser to https://[fully qualified hostname]:9443/jts/admin
        Remember: The [fully qualified hostname] is the host name along with the DNS domain reference of the machine on which the Jazz Team Server is installed.
      2. On the Administration page, click the Server tab.
    • For an application registered with the server:
      1. Point your web browser to https://[fully qualified hostname]:9443/[application]/admin to access the application, where [application] is ccm.
  2. In the Communication pane, click Friends (Outbound).
  3. On the Friends page, in the Friends List section, click Add.
  4. In the Add Friend dialog, provide the following information.
    1. Enter a name to identify the friend.
    2. Provide the URI for root services on the server you want to add as a friend. The URI should be of the form, https://[fully qualified hostname]:<port number>/<context>/rootservices
      Note: For Engineering Requirements Management DOORS® Next, enter https://[fully qualified hostname]:<port number>/dwa/public/rootservices.
    3. Optional: In the OAuth Secret and Re-type Secret fields, enter an OAuth secret code phrase to associate with the new OAuth consumer key. This string can contain one or more words and special characters, and cannot exceed 50 characters. This string is never displayed in the user interface, and you do not enter this string again. This string, also called an OAuth consumer secret, acts as a password to access the friend server.
      Note: These fields are displayed only if you are configuring OAuth friends. If one or both of the friend applications have Jazz Security Architecture SSO enabled and are registered with the same Jazz Authorization Server, the fields are not displayed.
    4. Optional: Select the Trusted check box. Trusted consumers can share authorization with other trusted consumers and do not require user approval to access data.
      Note: This check box is displayed only if you are configuring OAuth friends. If one or both of the friend applications have Jazz Security Architecture SSO enabled and are registered with the same Jazz Authorization Server, this check box is not displayed.
    5. Click Create Friend, and then click Finish.

What to do next

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

The Friends List on the Friends page lists the servers with which you have established friend relationships.

Note: If you add a friend entry to a server in another application group and want to add widgets from that friend server to your mini dashboard on the current server, then you must add that same friend entry to all applications in this application group. This is because the mini dashboard can be rendered on any application, so there must be a friend relationship from each application to the destination server.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki