LogoLogo
Login to CortexBook a DemoCortex Academycortex.io
  • Cortex Docs
  • Cortex Quick Start
  • Ingesting data into Cortex
    • Managing Entities
      • Adding entities
        • Add services
        • Add domains
        • Add teams
        • Add custom entity types
        • Defining dependencies
      • Entity details page
      • Defining ownership
      • Defining relationship types
      • Grouping entities
      • Adding external documentation
      • Adding Deploy data
      • Adding custom data
      • Viewing discovered entities
      • Archiving entities
      • Relationship graph
      • Using On-call Assistant for incidents
      • Managing Terraform infra in Cortex
    • Managing Catalogs
    • Integrations
      • Internally hosted integrations
      • ArgoCD
      • AWS
      • Azure DevOps
      • Azure Resources
      • BambooHR
      • Bitbucket
      • BugSnag
      • Buildkite
      • Checkmarx
      • CircleCI
      • ClickUp
      • Codecov
      • Coralogix
      • Custom webhook integrations
      • Datadog
      • Dynatrace
      • Entra ID (Azure AD)
      • FireHydrant
      • GitHub
      • GitLab
      • Google
      • Grafana
      • incident.io
      • Instana
      • Jenkins
      • Jira
      • Kubernetes
      • LaunchDarkly
      • Lightstep
      • Mend
      • Microsoft Teams
      • New Relic
      • Okta
      • Opsgenie
      • PagerDuty
      • Prometheus
      • Rollbar
      • Rootly
      • Sentry
      • ServiceNow
      • Slack
      • Snyk
      • SonarQube
      • Splunk Observability Cloud (SignalFx)
      • Splunk On-Call (VictorOps)
      • Sumo Logic
      • Veracode
      • Wiz
      • Workday
      • xMatters
  • Scorecards
    • Initiatives and Action items
      • Creating issues based on Initiatives
    • Scorecard rule exemptions
    • Scorecard rule filters
    • Scorecard examples
    • Scorecards as code
  • Reports
    • Executive report
    • All Scorecards report
    • Bird's eye report
    • Progress report
    • Report card
  • Eng Intelligence
    • Custom Metrics
    • Jira Metrics
    • Metrics Explorer (Beta)
  • Cortex Query Language (CQL)
    • Using CQL reports
    • Using JQ in Cortex
  • Workflows
    • Creating a Workflow
      • Workflows as code
    • Blocks
    • Running a Workflow
    • Registering a Scaffolder template
      • Scaffolder advanced usage
    • Using a Workflow to sync in ArgoCD
    • Kicking off a Jenkins pipeline in a Workflow
    • Calling internal service endpoints in a Workflow
  • Plugins
    • Creating a plugin
      • Creating a plugin proxy
    • Migrating Backstage plugins to Cortex
  • Engineering homepage
  • Workspace Settings
    • Using GitOps for Cortex
      • GitOps logs
    • Managing users
      • Roles and permissions
        • Custom roles
        • Team ownership entity editing
      • Configuring SSO
        • Microsoft Entra ID
        • Google
        • Other OIDC providers
        • Okta
          • Okta SCIM
      • Configuring identity mappings
      • Onboarding management
    • API keys, secrets, and tokens
      • Secrets
      • Personal tokens
    • Audit logs
    • Entity settings
      • Data verification
      • Auto archiving entities
    • IP allowlist
    • Notifications
      • Notification logs
    • Customizing your workspace
    • Using search in Cortex
  • Cortex API
    • REST API operations
      • API Keys
      • Audit Logs
      • Catalog Entities
      • Custom Data
        • Custom Data (Advanced)
      • Custom Events
      • Custom Metrics
      • Dependencies
      • Deploys
      • Discovery Audit
      • Docs
      • Eng Intel: User Labels
      • Entity Relationship Types (Beta)
      • Entity Relationships (Beta)
      • Entity Types
      • GitOps Logs
      • Groups
      • Initiatives
      • Integrations APIs
        • Azure Active Directory (Entra ID) API
        • Azure Resources API
        • AWS API
        • Azure DevOps API
        • CircleCI API
        • Coralogix API
        • Datadog API
        • GitHub API
        • GitLab API
        • incident.io API
        • LaunchDarkly API
        • New Relic API
        • PagerDuty API
        • Prometheus API
        • SonarQube API
      • IP Allowlist
      • Notification Logs
      • On call
      • Packages
      • Plugins
      • Queries
      • SCIM
      • Scorecards
      • Secrets
      • Team Hierarchies
      • Teams
      • Workflows
Powered by GitBook
On this page
  • View your personal identity mappings
  • View and manage all identity mappings
  • Review mapped and ummapped users
  • Map unmapped users
  • Map multiple identities to users

Was this helpful?

Export as PDF
  1. Workspace Settings
  2. Managing users

Configuring identity mappings

Last updated 2 months ago

Was this helpful?

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 and features are working as intended with their mappings.

Identity mapping is available for:

Git providers and Jira support .

View your personal identity mappings

All of your personal mappings for your established integrations are listed in Cortex under .

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.

View and manage 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.

Review mapped and ummapped users

Click on one of your configured integrations under Settings > Identity mappings to view the user mappings for that integration. You'll see the option to select a mapping next to users who have not yet been mapped for the integration you're viewing.

In the upper right corner of each integration's user mapping page, click Display then toggle on Hide mapped users to view only a list of unmapped users.

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

You can also bulk accept suggestions selecting Accept all suggestions in the upper right corner of the list. 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.

If Cortex does not have a suggestion, you will see a dropdown menu labeled Select mapping for that user.

Map multiple identities to users

You may have multiple instances within your git providers or Jira. It is possible to have multiple identities mapped in Cortex for a single user corresponding with each instance alias.

The following providers are supported:

To configure multiple mappings for a user:

  1. In Cortex, click your avatar in the lower left corner then click Settings.

  2. In Settings, under "Identity mappings," click into the integration you want to configure mappings for.

  3. Locate the user you need to map. Next to their name, click the arrow to expand their mappings.

  4. In the dropdown menus next to each instance alias name, if an identity has not been mapped, Cortex will recommend a possible user to map. In the dropdown, select the user, then click Save.

    • If multiple aliases are configured for an integration, you may see a dropdown in the identity mappings settings titled Unknown. This happens if no alias is associated with the identity mapping. When Cortex syncs user identity information, it will attempt to match the identity mapping with an alias. This will not impact any functionality within Cortex.

Azure DevOps
Bitbucket
GitHub
GitLab
Jira
Developer Homepage
Eng Intelligence
Azure DevOps
Bitbucket
ClickUp
GitHub
GitLab
Jira
Microsoft Teams
Opsgenie
PagerDuty
Slack
Settings > My identity mapping
multiple mappings per user
See specific identity mapping pages in the Cortex Settings