Add a GitHub Connector

Updated 4 days ago by Rashmi Nanda Sahoo

Harness Code Repository Connectors connect your Harness account with your Git platform. Connectors are used to pull important files, such as Helm charts, Kubernetes manifests, and Terraform scripts.

In this topic:

Before You Begin

Step 1: Add a GitHub Code Repo Connector

This topic assumes you have a Harness Project set up. If not, see Create Organizations and Projects.

You can add a Connector from any module in your Project in Project setup, or in your Organization, or Account Resources.

This topic shows you how to add a ServiceNow Connector to your Project.

In Project Setup, click Connectors.

Click New Connector, and then click GitHub. The GitHub Connector settings appear.

Enter a name for this Connector.

You can choose to update the ID or let it be the same as your ServiceNow Connector's name. For more information, see Entity Identifier Reference.

Enter Description and Tags for your Connector.

Click Continue.

For details on each setting, see GitHub Connector Settings Reference.

Step 2: Details

Select Account or Repository in URL Type.

Select Connection Type as HTTP or SSH.

Enter your GitHub Account URL.

In Test Repository, enter your repository name to test the connection.

Click Continue.

For SSH, ensure that the key is not OpenSSH, but rather PEM format. To generate an SSHv2 key, use: ssh-keygen -t rsa -m PEM The rsa and -m PEM ensure the algorithm and that the key is PEM.Next, follow the prompts to create the PEM key. For more information, see the  ssh-keygen man page and Connecting to GitHub with SSH.
Starting March 15, 2022, GitHub is fully deprecating RSA with SHA-1. GitHub will allow ECDSA and Ed25519 to be used. RSA keys uploaded after this cut-off date will work only with SHA-2 signatures (RSA keys uploaded before this date will continue to work with SHA-1). See Improving Git protocol security on GitHub from GitHub.Generating an SSH key in ECDSA looks like this:ssh-keygen -t ecdsa -b 256 -f /home/user/Documents/ECDSA/key -m pem

Step 3: Credentials

In Credentials, Enter your Username.

In Secret Key you can either create a new Encrypted Text or use an existing one.

Check the Enable API access.

In Personal Access Token, either create a new Encrypted Text or use an existing one that has your Git token. Harness requires the token for API access. Generate the token in your account on the Git provider and add it to Harness as a Secret.

Click Continue.

Step 4: Select Connectivity Mode

In Select Connectivity Mode, you have two options:

  • Connect Through Harness Platform: Harness SaaS will connect to your Git repo whenever you make a change and Git and Harness sync.
  • Connect Through a Harness Delegate: Harness will make all connections using the Harness Delegate. This option is used for Harness On-Prem often, but it is also used for Harness SaaS. See Harness On-Premise Overview.
Secrets: if you select Connect Through Harness Platform, the Harness Manager exchanges a key pair with the Secrets Manager configured in Harness using an encrypted connection. Next, the Harness Manager uses the encrypted key and the encrypted secret and then discards them. The keys never leave the Harness Manager. Secrets are always encrypted in transit, in memory, and in the Harness database.

If you select Connect Through Harness Platform, click Save and Continue.

If you select Connect Through a Harness Delegate, click Continue and then select/add the Delegate you want to use in Delegates Setup. See Delegate Installation Overview.

Click Save and Continue.

Harness tests the connection. Click Finish once the verification is successful.

The GitHub connector is listed in Connectors.

Please Provide Feedback