Rational® Adapter
for Git requires several user IDs to work. A functional user ID is
required when you register the adapter web application with the Jazz
Team Server, for communication between the adapter and Rational Team
Concert, for the Git receive hook and for the Gerrit receive hook.
These are the user IDs required by the adapter:
- Functional user ID for registering the adapter web application
with the Jazz Team Server
- This user that is called gitadapter_user is
automatically created when you register the Git adapter application
with the Jazz Team Server. This functional user ID is used to run
tasks in the background and has the same capabilities as other registered
application users. There is no need to change the name of this user.
If you do want to change the name, you can type another name in the Functional
User ID field, or browse and search for an existing name.
The functional user ID does not need to exist in the external registry;
if the user does not exist in the repository, it is automatically
created.
- Functional user ID for communication between the adapter and Rational
Team Concert
- 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.
- Functional user ID for the Git receive hook or the Gerrit receive
hook
- The Git receive hook user or Gerrit receive hook user can be the
same as the functional user that you set up when you created the friend
relationship between the adapter and Rational Team Concert. That user
that is assigned for this server to server communication does not
need read access to the work items it is linking to, but requires
at a minimum JazzUsers repository permissions to the repository to
read and write work items in the Change and Configuration Management
project areas that are used as part of the integration. This user
ID is used to log in to the Jazz Team Server and to create the adapted
Git resource in the Git adapter database when the request comes from
the Git pre-receive or Gerrit path-set created hook. You can create
another Git receive hook user or Gerrit receive hook user but this
user also requires JazzUsers repository permissions to create and
update work items in Rational Team Concert from the adapter. As well
this user does not need a Rational Team Concert-Stakeholder Client
Access License, if you are using that method of licensing for the
adapter.
- Users that are logged in to Change and Configuration Management
To view Git adapter administration pages, this user must have
JazzGuests repository permissions. This user does not need a client
access license.
To update a Git adapter administration page,
this user must have JazzAdmins or JazzProjectAdmins repository permissions.
To
show the work item links, this user must have JazzGuests repository
permissions. This user does not need a client access license. To see
the work items, this user requires read access to the Rational Team
Concert work items. Read access does not mean that this user is a
member of the Rational Team Concert project area. The project area's
access control might grant read access to users outside the project
area.
To create links to work items from the Git server web
user interface, this user must have JazzUsers repository permissions.
This user requires a Rational Team Concert - Contributor Client Access
License or higher client access license and read access to the Rational
Team Concert work item it is linking to. There is no permission that
is required to save links on a work item. Reading a work item also
means that links can be added to it.
To open a Rational Team
Concert work item in the web user interface and follow that link back
to a commit, this user requires JazzGuests repository permissions.
This user does not need a client access license but requires read
access to the Rational Team Concert work item.
- Command-line Git user
- This user must have permissions for hooks to run when the request
comes from the Git pre-receive or Gerrit path-set created hook.