Skip to main content

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.

Identity mapping is available for:

View your personal identity mappings

All of your personal mappings for your established integrations are listed in Cortex under Settings > My integration accounts.

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.

warning

OAuth mapping is only valid for GitHub cloud and not for GitHub Enterprise server.

View all identity mappings

Users with the Configure identity mappings permission can review all user mappings specific to each configured integration in your Cortex Settings under the "Identity mappings" section. Any integrations configured will appear there, whether you have already mapped users or not.

See specific identity mapping pages in the Cortex Settings

Review mapped and ummapped users

You'll see the option to map accounts for any integrations you've already set up. Each page will display with a tab for all Unmapped users and Mapped users.

identity mapping 2

Map unmapped users

From the Unmapped users tab of any identity mappings page, 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.

You can also bulk accept suggestions selecting Accept all suggestions next to the search bar. This will open a modal where you can review all the accounts with available suggested mappings, and quickly confirm mappings for dozens of users at once.