Adapter users

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.

Feedback