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:
- 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.
- Select the Consumers (Inbound) page. New requests are listed in the Provisional Keys section.
- At the Authorized field, change
the Pending value to Approve.
- Click Save. The key
is included in the Authorized Keys section of the page.
- 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.
- 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.
.
- 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.