Catalog Auto-Discovery with Platform Integrations

Discover services from Platform integrations and sync them to the IDP Catalog

The Platform Integration feature in Harness IDP automatically syncs all scope-level entities from the Harness Platform as IDP catalog entities. This integration creates a hierarchical view of your Harness account structure, including accounts, organizations, and projects, making them discoverable and manageable within the IDP catalog.

This feature requires the IDP_INTEGRATIONS feature flag to be enabled. Contact Harness Support to enable it.

Overview

Platform Integration synchronizes your entire Harness Platform hierarchy into the IDP catalog as entities with a special hierarchy kind. This provides a unified view of your organizational structure and all associated services across accounts, organizations, and projects.

Key features:

• Automatic synchronization - Syncs all entities from the Harness Platform to IDP catalog

• Hierarchical structure - Maintains account → organization → project relationships

• Scope-based filtering - View entities by account, organization, or project scope

• Read-only entities - Imported entities cannot be deleted from the catalog

• Continuous sync - Keeps catalog entities up-to-date with Platform changes

Enable platform integration

To enable Platform Integration:

1. Navigate to Configure → Integrations → Platform Integration

2. If not already enabled, click Enable to activate the integration

3. The integration will display an enable/disable toggle with minimal configuration required

Once you import entities using Platform Integration, you will not be able to delete them from the catalog. They are managed by the Platform Integration sync process.

After enabling, all scope-level entities (accounts, organizations, and projects) from the Harness Platform will be automatically imported into the IDP catalog.

View imported entities

Once the import is complete, you can view all imported entities in two ways:

From platform integration page

Navigate to Configure → Integrations → Platform Integration to view the imported entities table:

Clicking on an entity in this table will navigate you to the IDP catalog entity details page.

From IDP catalog

Navigate to Catalog and filter by Kind: hierarchy to view all hierarchical entities. You can then select the specific type (account, organization, or project) to view entities at that level.

Hierarchy entity structure

Platform Integration creates entities with Kind: hierarchy, which represents the organizational structure of your Harness Platform. These entities have different types based on their level in the hierarchy:

Account-Level Entity

When you view an account entity:

• Kind: hierarchy

• Type: account

The Overview tab displays two tables:

1. Organizations belonging to this Account - Lists all direct child organizations

2. Entities belonging to this scope (account) - Lists all entities at the account scope level

Organization-Level Entity

When you view an organization entity:

• Kind: hierarchy

• Type: organization

The Overview tab displays three sections:

1. Projects belonging to this Organization - Lists all direct child projects

2. Entities belonging to this scope (organization) - Lists all entities at the organization scope level

Project-Level Entity

When you view a project entity:

• Kind: hierarchy

• Type: project

The Overview tab displays:

1. Entities belonging to this scope (project) - Lists all entities at the project scope level

Customize hierarchy entity views

Beyond the default hierarchical relationships, you can customize the Overview tab of hierarchy entities to display additional metrics and insights using Aggregation Rules and Layout Configuration.

What you can add

• Stats Cards - Display aggregated metrics from child entities (e.g., average test coverage, deployment frequency)

• Aggregation Tables - Show breakdowns of metrics with individual values from child entities

How it works

1. Create Aggregation Rules - Define how to roll up metrics from lower-level entities (e.g., from components to projects, from projects to organizations)

2. Configure Layouts - Add stats cards and tables to display the aggregated metrics on hierarchy entities

3. View Results - Navigate to hierarchy entities to see your customized metrics and insights

For example, you can aggregate DORA metrics from service components to project entities, then roll up test coverage from projects to organizations, and display these as cards on the Overview tab.

Next steps

• Learn about Aggregation Rules to roll up metrics across hierarchy levels

• Explore Layout Configuration to customize hierarchy entity views

• Understand Catalog Ingestion to add custom properties to entities