Okta Group Push to Existing Groups in Atlassian Fails with Display Name Already Exists Error
Last Updated:
Overview
When pushing groups from Okta to Atlassian, groups created directly in Atlassian do not appear for linking, and a display name error occurs. This happens because Atlassian prevents syncing groups marked as default access groups via System for Cross-domain Identity Management (SCIM). Resolve this issue by reviewing the group conflicts in the Atlassian administration console and syncing the groups to overwrite the Atlassian groups with the Okta groups.
The Atlassian group push to link existing groups no longer displays groups that were created in Atlassian and not pushed from Okta. The following error appears:
Errors reported by remote server: Resource [GROUP]: with displayName already exists.
Applies To
- Okta Identity Engine (OIE)
- Okta Classic Engine
- Atlassian
- Group Push
Cause
Group conflicts occur when groups have the same name in Okta as groups that already exist in the Atlassian organization. Atlassian cannot sync groups from Okta when the group is a default access group on the Atlassian product site. According to the Atlassian Cloud documentation, any group marked as a default group cannot be managed via System for Cross-domain Identity Management (SCIM) integration.
Solution
Review the groups before performing a sync.
Before syncing and replacing the groups, Atlassian provides a list of group names and a breakdown of the membership changes. Review the following screenshot for a sample breakdown of the group name, product access, site name, and the number of users added or removed if the group is overwritten.
How are the groups synced after the review?
When Atlassian syncs groups, Atlassian overwrites the organization and site groups with Okta groups. This means that some users could lose or gain product access and permissions granted by the group. Navigate to the Atlassian administration console to review the member changes and sync the groups.
- Navigate to the organization at admin.atlassian.com.
- Navigate to the Identity provider directory. A warning message appears with the number of groups that were unable to sync.
- Select Review groups.
- Review the member changes to see which members are added or removed from the group.
- Select Sync group. Alternatively, select Sync all groups and follow the prompts to quickly sync all groups.
Verify that the group sync is complete.
Verify the group sync is complete by checking that the number of synced groups in the Atlassian user provisioning settings matches the number in Okta.
