Skip to main content

Identity mappings

The Identity mappings feature allows you to map accounts from different integrations to Cortex accounts. You can access Identity mappings from settings.

All of your established integrations are listed in Settings under My integration accounts in the Preferences section. You can go here to make sure that your personal mappings are set up correctly.

identity mapping 1

Identity mapping is available for Azure DevOps, Bitbucket, GitHub, GitLab, Jira, Microsoft Teams, Opsgenie, PagerDuty, ClickUp, and Slack.

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

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.

You can check whether your personal accounts have been linked to your Cortex account on the My integration accounts page in settings.

From this page, you can also directly add your OAuth user for GitHub cloud if there’s no mapping. For other integrations, you can follow the identity mappings page link to set it up.

warning

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

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.