Approving an access request

After you create a friend server request from the Rational® Adapter for Git to the Change and Configuration Management server, you use the Jazz™ server administration to approve the request.

Before you begin

You must establish cross-server communication between the Rational Adapter for Git and the Change and Configuration Management server before performing this procedure.

Procedure

To approve a consumer key requested by the Rational Adapter for Git:

  1. Point your browser to https://[fully qualified hostname]:[port]/ccm/admin and log in to the Rational Team Concert™ server by using an account that has administrator privileges.
  2. Select the Consumers (Inbound) page. New requests are listed in the Provisional Keys section.
  3. At the Authorized field, change the Pending value to Approve.
  4. Click Save. The key is included in the Authorized Keys section of the page.
  5. On the OAuth Consumers page, in the Authorized Keys section, hover over the Actions column for the Consumer Name of the key that you want to edit and click the Edit consumer key icon. The Edit Consumer Key Properties dialog box opens.
  6. Associate a functional user ID that has the user privileges to update work items and has permissions in the RTC project areas that will be used by the adapter to add links to work items with the consumer key. This allows requests to be made by the user without additional authorization. Click Select User. In the Select User dialog box, add a user. Click Add and Close.
    Tip: You might want to make note of this user and use it if you choose to set up a Git receive hook or a Gerrit receive hook. This user is the one under which Git commit or Gerrit change links are added to Change and Configuration Management work items when the request comes from the Git pre-receive or Gerrit patch-set-created hook. This user does not need read access to the work items it is linking to, but requires at a minimum JazzGuests repository permissions to read the work items in the Change and Configuration Management project areas that are used as part of the integration. As well this user must have a minimum of a Rational Team Concert-Stakeholder Client Access License, if you are using that method of licensing for the adapter. When a user creates a link from the Gitweb web UI or Gerrit web UI, the users real Rational Team Concert identity and permissions is used to create and view links.

    For information about adding members to project areas, see Adding members to projects.

    .
  7. Click Finish. You have approved the server friend request.

Results

The Rational Team Concert application can now use the key to communicate with the Rational Adapter for Git.

What to do next

When access is approved, you set up Gitweb servers and Gerrit servers to work with the Rational Adapter for Git, see Deploying Gitweb additions and Deploying Gerrit additions.

Feedback