step-1-setup-git-integration
This guide will walk you through the first steps of onboarding to Harness IDP, including enabling the module, configuring Git connectors, populating your catalog, and importing Harness entities.
Prerequisites
Provision the IDP Admin Role
- Harness IDP must be provisioned for the given account.
- Only users with the Harness Account Admin role or assigned IDP Admin role can configure IDP. Go to Assign Roles and Resource Groups to assign roles.

Configure Git Integrations
You land on the IDP module by navigating from the sidebar after logging into your Harness account. We strongly recommend users to follow the onboarding guide by selecting Get Started, for a seamless onboarding resulting in a catalog with software components.
Now that you're on the onboarding wizard, let's get started with setting up Git connectors to onboard the software components.
Setup Git Connectors
The software components in IDP are defined using YAML files, which are typically stored in your Git repositories. Configuring a connector for these Git providers is essential to fetch and manage these YAML files.
The following Git providers are supported:
- Harness Code Repository
- GitHub (Cloud & Enterprise)
- GitLab (Cloud & Self Hosted)
- Bitbucket
Note: Multiple Connectors with different hostnames can be used for a single Git Provider at once. While setting up the connector, both Account & Repo type URLs are supported. Connection through Harness platform and delegate is supported.
- Interactive Guide
- Step-by-Step
Setting up Git Connectors
- Select Harness Code Repository if enabled, or choose your preferred Git Provider from the available options.
- From the dropdown under Select Connector, either select an already present connector or create +New Connector.
- Configure the Connector as per the documentation.
- Select Apply Selected to use the connector.
- After the connection test runs, select Finish to save the connector.
Next Steps
Now that you've completed the initial setup: