Skip to main content

Catalog Auto-Discovery with Platform Integrations

Last updated on

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.

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

Enabling 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
Enable Platform Integration
info

Once you import entities using Platform Integration, you won't 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.

Viewing 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:

Platform Integration List

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 entities

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:

When you view an account entity:

  • Kind: hierarchy
  • Type: account
Account Level Entity

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

Customizing 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.

Layout

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
Metric

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​