Using a shared user base for the Git hosting server and EWM

For creating Git commit links to IBM® Engineering Workflow Management (EWM) work items, a shared user base, such as a common LDAP, is optional. If a shared user base cannot be configured between EWM and the Git hosting server, or if there is a mismatch between some attributes in the user’s profile, then you can set up a functional user ID of an EWM user in the hook configuration.

About this task

See the help topics for each hosting server for details about how to provide a functional user ID in the hook configuration.

Note: To configure process enforcement for Git push operations, you must have a shared user base between the Git hosting server, such as GitHub Enterprise or GitLab, and EWM. Ensure that some attributes of the user profile in EWM and the Git hosting server match so that process enforcement for Git push operations works correctly.

To link between Git commits and EWM work items without enabling process enforcement for Git push operations, add a functional user ID of an EWM user to the hook configuration. Make sure that the functional user is authorized for Git requests. See Authorizing Git requests for information on authorizing Git requests.

Procedure

To set up a common user base between the Git hosting server and EWM, consult the following tables.
EWM user profile GitHub Enterprise Description
User ID (case-sensitive) username The username can be found in the Your Profile page in GitHub Enterprise, below profile the image and name.
E-mail address Primary e-mail address Primary email can be found in the Emails tab in the Settings page.
EWM user profile GitLab/GitLab Enterprise Description
User ID (case-sensitive) @username Open the Settings page and click the Account tab. Look for the username in the Path field under the Change username section.
E-mail address Email Email field in the user Settings page.
EWM user profile Gerrit Description
User ID (case-sensitive) Username

Username field can be found in the Settings page.

A common EWM User ID and Gerrit Username is optional.

E-mail address Email address

Email Address field can be found in the Settings page.

EWM user profile Bitbucket Description
User ID (case-sensitive) User id The user id can be found in the Your Profile page in Bitbucket, next to the profile image and below user name.
E-mail address Email Address Email address can be found in the Your Profile page in Bitbucket, next to the profile image and below the user id.