Help Desk

Return to Cortex App

(On-prem) Removing a Jira Integration from User Identity Mappings

  • Updated

A removed Jira integration (alias) may continue to appear in Settings → Identity mappings → Jira, even though the integration no longer exists.

Applies To

  • Self-hosted (on-prem) Cortex deployments

  • Jira integrations that were previously removed or renamed

Symptoms

  • A “shadow” Jira integration or alias appears in Jira user mappings

  • The alias cannot be removed from the UI

  • The integration no longer serves any functional purpose

Cause

When a Jira integration or alias is removed, its corresponding identity-mapping records are not automatically cleaned up. As a result, aliases can remain visible in the Jira user mappings UI.

Resolution

The current workaround is to manually delete the stale identity mapping from the Cortex database.

Steps

  1. Identify the exact Jira alias you want to remove (shown in the UI).

  2. Run a DELETE query against the Cortex database similar to the following:

DELETE FROM identity_mappings
WHERE tenant_id = <your_tenant_id>
  AND type = 'JIRA'
  AND alias = '<jira_alias>';

  1. Refresh the Jira user mappings page in Cortex.

Expected Result

  • The stale Jira alias no longer appears as a mapping option

  • Jira user mapping can be completed using the correct integration

Related articles