Configuring identity mappings
The identity mappings feature allows you to map accounts from different integrations to Cortex accounts, based on name or email address. With identity mapping, you can not only make sure that integrations are working properly for your team members, but you can also ensure that the Developer Homepage and Eng Intelligence features are working as intended with their mappings.
In most cases, Cortex can automatically match user identities across systems with no setup required. When account details differ across tools, Cortex Admins can manually review and map users in Settings > Identity mappings.
Identity mapping is available for:
Git providers and Jira support multiple mappings per user.
View your personal identity mappings
All of your personal mappings for your established integrations are listed in Cortex under Settings > My identity mapping.
From this page, you can directly add your OAuth user for GitHub cloud if there’s no mapping. For other integrations, a user with the Configure identity mappings permission must configure the identity mappings.
OAuth mapping is only valid for GitHub cloud and not for GitHub Enterprise server.
Viewing and managing all identity mappings
Users with the Configure Identity Mappings permission can review all user mappings specific to each configured integration. Every integration you've set up appears on this page, whether or not you've mapped users to it yet.
To access:
From the main sidebar, click your avatar in the bottom-left corner.
Select Settings.
Scroll to the Identity mappings section.
Reviewing mapped and unmapped users
From the main sidebar, click your avatar in the bottom-left corner.
Select Settings.
Scroll to the Identity mappings section.
Select the integration whose users you want to review.
In the upper-right corner of the integration's User mappings page, click Display.
Toggle on or off the following:
Active integrations only (toggled on by default) - Show mappings only for integration configurations that are currently installed. Uninstalling a configuration doesn't delete the mappings you've saved for it; toggle this setting off to see them again.
Hide mapped users - Show only the users who don't have a mapping yet.
Click Done.
Mapping unmapped users
While viewing the user mappings for an integration, you can view Cortex's suggestions for user accounts. You can accept suggestions individually by clicking the checkmark next to a suggestion in a user’s row:
To accept multiple suggestions at once, click Accept all suggestions at the top of the list. This opens a dialog listing every account that has a suggested mapping, so you can review the suggestions and confirm them for many users at once.
If Cortex doesn't have a suggestion, select a mapping for that user from the Select mapping drop-down.
Mapping multiple identities to users
Cortex supports more than one identity per user, so if you run multiple instances of a Git provider or Jira, you can map an identity for each instance alias.
The following providers are supported:
To configure multiple mappings for a user:
From the main sidebar, click your avatar in the bottom-left corner.
Select Settings.
Scroll to the Identity mappings section.
Select the integration whose users you want to map.
Locate the user, then click the arrow next to their name to expand their mappings.
If an identity isn't mapped yet, the dropdown next to the instance alias suggests a user. Select the user, then click Save.
When a mapping isn't associated with an alias, the Identity mappings settings show a dropdown labeled Unknown. This can happen when an integration has multiple aliases configured. The next time Cortex syncs user identity information, it tries to match the mapping to an alias. The Unknown label doesn't affect how Cortex works.
Cortex lists only the aliases for integration configurations that are currently installed. If an alias you expect is missing from a user's mappings, the configuration it belongs to may have been removed or renamed. Uninstalling a configuration doesn't delete the mappings you've saved for it. To see them, click Display at the top of the list, then toggle off Active integrations only.
Last updated
Was this helpful?