Skip to main content

Automatch Developer Identities

Overview

Auto Identity Discovery in Harness SEI helps you automatically identify and unify developer identities across all supported integrations. Instead of manually mapping developer identifiers (emails, usernames, or account IDs) from different tools, SEI intelligently correlates and creates a single unified developer identity.

This eliminates manual effort, reduces onboarding bottlenecks, and ensures that metrics are attributed correctly to each developer. In modern engineering organizations, developers work across multiple systems such as Jira, GitHub, GitLab, Azure DevOps, Bitbucket, and more. Each system may store developer information differently (email, account ID, username).

Without unification:

  • The same developer may appear as multiple contributors in SEI 2.0
  • Metrics can become inaccurate or fragmented
  • Onboarding new teams requires manual reconciliation

Auto Identity Discovery solves this by using a correlation model (email-driven, contribution-driven, and API-driven, depending on the integration) to automatically unify these identities into a single record in SEI 2.0. For more information, see Upload Developer Cloud IDs.

How It Works

  1. Email-based correlation: SEI fetches developer details (i.e. usernames, account IDs, and emails where available) from source systems and automatically consolidates them so each developer has a single unified profile across all integrations.

  2. Contribution-driven correlation: For integrations that do not allow direct identity fetch, SEI analyzes commit and pull request activity to intelligently infer developer identities.

  3. Unification model: Once identities are detected, SEI maps all associated records into a single unified developer identity. This ensures that contributions made by the same person across different tools are consistently attributed.

This model runs automatically during data ingestion. Team managers can review and adjust mappings if mismatches occur, ensuring the highest level of accuracy.

Supported integrations

Auto Identity Discovery relies on fetching developer emails from the source systems. Due to security restrictions, Harness SEI cannot fetch user details for some integrations. In such scenarios, Harness provide an API that you can use to update the developer identities in SEI 2.0 by pulling the user details in your environment without having to give Harness SEI access to retrieve user details.

The required permissions vary by integration.

IntegrationAuto-matching SupportedNotes
Jira Cloud (Connect App)NoThe Connect App is scheduled to be deprecated.
Jira Cloud (API Token)YesIf you are using a fine-grained access token, the token requires the following permissions:

- Read:user:jira
- Read:jira-user
- Read:account-id:jira

If you are using a classic token, the following permissions are required on the Atlassian Service/User account:

- Atlassian Browse Users
- User Picker
Jira Satellite / Data CenterYesIf you are using a fine-grained access token, the token requires the following permissions:

- Read:user:jira
- Read:jira-user
- Read:account-id:jira

If you are using a classic token, the following permissions are required on the Atlassian Service/User account:

- Atlassian Browse Users
- User Picker
GitHub (App)YesApp installation automatically grants access to developer identities if the app is installed by an organization owner or admin.

If the installation requires approval from other admins/owners, SEI may not receive all notifications or emails until the installation is fully approved.
GitHub Access Token (PAT)YesThe GitHub Personal Access Token (Classic) requires the following permissions:

- Read:org
- Repo:all
- Read:user
- User:email

If your GitHub organization uses SAML SSO, enable SSO for your personal access token. For instructions, see Authorizing a personal access token for use with SAML SSO.
GitHub (Satellite / Cloud Connect)YesThe GitHub Personal Access Token (Classic) requires the following permissions:

- Read:org
- Repo:all
- Read:user
- User:email

If your GitHub organization uses SAML SSO, enable SSO for your personal access token. For instructions, see Authorizing a personal access token for use with SAML SSO.
Azure DevOps (OAuth / PAT)Yes, partialThe Azure DevOps integrations do not support direct identity detection by fetching user information. Instead, SEI analyzes the data ingested from contributions such as commits and pull requests to infer developer identities.

This approach allows SEI to unify developer records only when related contributions are available in the system. If no contribution data exists for a developer, no mapping will occur. As a result, identity coverage may be incomplete, and accuracy cannot be guaranteed.

Harness recommends that team managers periodically review developer identities within their teams to validate mappings and ensure metrics are reported correctly.
Bitbucket ServerYes, partialThe BitBucket Server integration does not support direct identity detection by fetching user information. Instead, SEI analyzes the data ingested from contributions such as commits and pull requests to infer developer identities.

This approach ensures SEI can still unify developer records, but accuracy may vary depending on the availability and quality of contribution data. Because of this, identity coverage is not guaranteed to be 100% accurate.

We strongly recommend that team managers periodically review developer identities within their teams to validate mappings and ensure metrics are reported correctly.
Bitbucket CloudYes, partialThe BitBucket Cloud integration does not support direct identity detection by fetching user information. Instead, SEI analyzes the data ingested from contributions such as commits and pull requests to infer developer identities.

This approach ensures SEI can still unify developer records, but accuracy may vary depending on the availability and quality of contribution data. Because of this, identity coverage is not guaranteed to be 100% accurate.

We strongly recommend that team managers periodically review developer identities within their teams to validate mappings and ensure metrics are reported correctly.
GitLab (OAuth / PAT)Yes, partialThe GitLab integration does not support direct identity detection by fetching user information. Instead, SEI analyzes the data ingested from contributions such as commits and pull requests to infer developer identities.

This approach ensures SEI can still unify developer records, but accuracy may vary depending on the availability and quality of contribution data. Because of this, identity coverage is not guaranteed to be 100% accurate.

We strongly recommend that team managers periodically review developer identities within their teams to validate mappings and ensure metrics are reported correctly.
GitLab (Self-Managed / Satellite)Yes, partialThe GitLab Self-Managed instances do not support direct identity detection by fetching user information. Instead, SEI analyzes the data ingested from contributions such as commits and pull requests to infer developer identities.

This approach ensures SEI can still unify developer records, but accuracy may vary depending on the availability and quality of contribution data. Because of this, identity coverage is not guaranteed to be 100% accurate.

We strongly recommend that team managers periodically review developer identities within their teams to validate mappings and ensure metrics are reported correctly.
Harness Code (Cloud / Satellite)YesSEI infers identity from commit & PR data. Accuracy may vary; team validation recommended.

Limitations

Due to security restrictions and integration-specific API capabilities, SEI cannot always fetch user details directly.

In such cases:

  1. SEI relies on contribution data (commits, pull requests) to infer identity.
  2. This may not be 100% accurate & coverage depends on data availability.
  3. Team managers should review developer identity mappings periodically to ensure accuracy.

Update developer identities

For integrations where SEI cannot fetch user details, we provide APIs that let you securely pull user information in your environment and update developer identities in SEI without granting SEI direct access. For more information, see Upload Developer Cloud IDs.

Once records are matched, they are reflected in your teams across all org tree(s).

To view these developer identities:

  1. Click on the Insights tab in the Harness navigation. In the Org Tree on the left-hand side, go to your Team and click on the Team Settings icon next to a leaf node.
  2. You'll see the developer records that have been auto-populated for that team on the Developers tab.

This ensures identity mappings are visible in context and remain consistent with your team's resource (the system the specific team uses to generate insights).