> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/internal-developer-portal/new-to-idp/get-started/step-2-set-up-software-catalog-get-started/auto-discovery-step-2-set-up-software-catalog-get-started.md).

# Auto-Discovery

{% @harness-package-selector/package-selector platforms="%5B%7B%22label%22%3A%22Create%20Manually%22%2C%22slug%22%3A%22create-manually%22%2C%22path%22%3A%22internal-developer-portal%2Fnew-to-idp%2Fget-started%2Fstep-2-set-up-software-catalog-get-started%2Fcreate-manually-step-2-set-up-software-catalog-get-started%22%7D%2C%7B%22label%22%3A%22Auto-Discovery%22%2C%22slug%22%3A%22auto-discovery%22%2C%22path%22%3A%22internal-developer-portal%2Fnew-to-idp%2Fget-started%2Fstep-2-set-up-software-catalog-get-started%2Fauto-discovery-step-2-set-up-software-catalog-get-started%22%7D%2C%7B%22label%22%3A%22Import%20from%20Git%22%2C%22slug%22%3A%22import-from-git%22%2C%22path%22%3A%22internal-developer-portal%2Fnew-to-idp%2Fget-started%2Fstep-2-set-up-software-catalog-get-started%2Fimport-from-git-step-2-set-up-software-catalog-get-started%22%7D%5D" selectedPlatform="auto-discovery" %}

### Auto-Discover entities using Harness CD <a href="#auto-discover-entities-using-harness-cd" id="auto-discover-entities-using-harness-cd"></a>

Harness IDP can automatically discover and import your Harness CD services into the Software Catalog. This feature allows you to quickly populate your catalog with existing services without any manual configuration.

#### What is auto-discovery? <a href="#what-is-auto-discovery" id="what-is-auto-discovery"></a>

Auto-Discovery integration enables:

* **Automatic scanning** of your Harness account for all CD services across the selected scope (Account, Organization, or Project level)
* **Automatic conversion** of each CD service into a **Component** entity with the **Service** type in Harness IDP
* **Metadata mapping** from service configuration to IDP entity properties
* **Uni-directional sync** from CD service to IDP entity (changes in IDP do not affect the CD service)

For detailed information about the integration, go to [Auto-Discovery using Harness CD](/internal-developer-portal/use-idp/software-catalog/create-entity/catalog-discovery/integrations/harness-cd.md).

***

#### Before you begin <a href="#before-you-begin" id="before-you-begin"></a>

Before you begin, ensure:

* The feature flag **`IDP_CATALOG_CD_AUTO_DISCOVERY`** is enabled on your account. Contact [Harness Support](mailto:support@harness.io) to enable it.
* **Harness CD** is enabled for your account (must be the **same account** you use for Harness IDP).
* You have appropriate RBAC permissions to view CD services in Harness CD.

***

#### Configure auto-discovery integration <a href="#configure-auto-discovery-integration" id="configure-auto-discovery-integration"></a>

{% tabs %}
{% tab title="Interactive Guide" %}
{% embed url="<https://app.tango.us/app/embed/3c879999-6426-4bbb-8566-1d0e69612a7b?skipCover=true&defaultListView=false&skipBranding=false&makeViewOnly=true&hideAuthorAndDetails=true>" %}
Configure Catalog Auto-Discovery
{% endembed %}
{% endtab %}

{% tab title="Step-by-Step" %}
**Step 1: Enable the Harness CD auto-discovery integration**

1. In Harness IDP, navigate to **Configure** → **Integrations**.
2. Locate the **Harness CD services** integration card.
3. Click **Enable** to activate the integration.

***

**Step 2: Configure and sync Harness CD services**

After enabling the integration, configure what services to sync to your IDP Catalog. When you enable auto-discovery, each CD service is converted into an IDP entity with some specific characteristics. Go to [Sync Harness CD Services](/internal-developer-portal/use-idp/software-catalog/create-entity/catalog-discovery/integrations/harness-cd.md#2-sync-harness-cd-services-to-the-idp-catalog) to learn more about this entity mapping.

1. On the **Harness CD services** integration card, click **Edit**.
2. Choose your sync scope:

   **Option A: All Scopes**

   * Syncs services across the entire account (all organizations and projects).

   **Option B: Particular Organizations & Projects**

   * Syncs only from selected organizations and/or projects
   * Use the dropdown to select specific scopes
3. Click **Save Changes** to begin syncing.

That is it! Your CD services will now appear in the IDP Catalog.
{% endtab %}
{% endtabs %}

***

#### View and manage CD services in the IDP catalog <a href="#view-and-manage-cd-services-in-the-idp-catalog" id="view-and-manage-cd-services-in-the-idp-catalog"></a>

Once the sync is complete, you can view and manage your auto-discovered services.

{% tabs %}
{% tab title="Interactive Guide" %}
{% embed url="<https://app.arcade.software/share/8bZl2R7toUCtKqjrThZo>" %}
View and Manage Synced Services
{% endembed %}
{% endtab %}

{% tab title="Step-by-Step" %}
**View synced services:**

1. Navigate to the **Catalog** in Harness IDP
2. Search for any CD service by name or identifier
3. Click on an entity to view all synced data from the CD service

***

**Auto-Configured features:**

Auto-discovered entities come with built-in features:

**1. CI/CD Plugin:**

* The **CI/CD** plugin is automatically configured for each entity
* View deployment history, pipelines, and execution details directly in IDP

**2. Quick Navigation:**

* Use the **Open in Harness CD** button on the entity overview page
* Navigate directly to the service in Harness CD for detailed management
  {% endtab %}
  {% endtabs %}

{% @harness-feedback/feedback %}