Changing the Username attribute for Delegated Directories
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.
Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
Changing the username attribute in delegated directories has a few extra steps depending on how the directory is configured.
Scenario 1
If Copy User on Login and Update User attributes on Login are checked within the directory settings then the User Name Attribute field can simply be updated.
Scenario 2
If Copy User on Login and Update User attributes on Login are not already checked the following must be done:
- Check Copy User on Login and Update User attributes on Login
- Wait for all users to log in at least once
- Update the User Name Attribute field to the desired value
This process must be followed because when Copy User on Login and Update User attributes on Login are not checked the external ID (User Unique ID Attribute in the directory configuration) used to track the user across username changes is not synced into Confluence.