Registering the GitHub repository in EWM

When you register a Git repository, you create an association between the Git repository and a IBM® Engineering Workflow Management (EWM) process area.

Before you begin

You must have permissions to register a repository. For more information, see Defining Git-related permissions and preconditions.

A shared user base, such as a common LDAP, between EWM and the GitHub Enterprise server is optional. It is recommended to add an EWM functional user ID to the webhook configuration. Ensure that the functional user is authorized for Git requests.


  1. In the web client, log on to Change and Configuration Management. For example, go to https://host_name:9443/ccm/web.
  2. On the All Projects page, click the desired project area.
  3. Click Source Control > Work with Git.
  4. Click Register a Git repository.
  5. Enter the name of the Git repository that you want to register.
  6. In the URL field, enter the URL of the Git repository.
  7. Optional: To specify a project area or team area that controls which users can commit or push changes to the Git repository and that enforces process based on user roles and work item attribute values, click the arrow at the end of the Controlling Process Area field and select a project area or team area.
  8. Expand the GitHub / GitLab Configuration section. In the Hosting Server field, select GitHub Enterprise from the list.
  9. In the Secret Key Authorization field, enter a secret. The secret is provided when you configure the webhook in GitHub Enterprise.
  10. Click Copy next to the webhook URL.
  11. Optional: If GitHub Enterprise and EWM do not share a user base, then a functional user ID is required. To use a functional user ID for a webhook URL:
    1. Click Insert Functional User.
    2. Select the user and click OK. Click Copy next to the webhook URL.
    3. Click Save.

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki