Update Sitecore Username For Federated Authentication Using Azure AD

Let's Fix The Sitecore Username

If you're using Federated Authentiation with Azure AD in combination with the Sitecore Identity Server you've more than likely encountered a weird result when you got logged in for the first time. I'm talking about the malformed, random usernames that are assigned as shown below.

Sitecore Identity Server encountering malformed and random usernames

Have no fear, you didn't configure anything incorrectly. That said, you do need to a bit of coding and a bit of configuration in order for the username to be something readible.

This article makes the assumption you've either followed along through or at least read the article, Configuring Federated Authentication To Azure AD With Sitecore Identity Server. We will be updating the Sitecore patch file we created there to apply our User Builder.

Configure A Custom User Builder

The simplest approach to updating the username is to update the Sitecore User Builder. The following user builder is a fairly basic approach and can be extended as desired.

The Code

public class CustomExternalUserBuilder : DefaultExternalUserBuilder
    public CustomExternalUserBuilder(ApplicationUserFactory applicationUserFactory, IHashEncryption hashEncryption) : base(applicationUserFactory, hashEncryption) { }

    protected override string CreateUniqueUserName(UserManager userManager, ExternalLoginInfo externalLoginInfo)
        if (externalLoginInfo == null) return "nullUserInfo";

        if (string.IsNullOrWhiteSpace(externalLoginInfo.Email))
            var validUserName = externalLoginInfo.DefaultUserName.Replace(",", "").Replace(".", "").Replace("'", "");

            return "sitecore\\" + validUserName.Replace(" ", "");

        return externalLoginInfo.Email;

The Config

The patch file we created previously can now be extended within the identityProvidersPerSites node to utilize our code above.

<identityProvidersPerSites hint="list:AddIdentityProvidersPerSites">
    <mapEntry name="all sites" type="Sitecore.Owin.Authentication.Collections.IdentityProvidersPerSitesMapEntry, Sitecore.Owin.Authentication" resolve="true">
      <sites hint="list">
      <externalUserBuilder type="MyApp.UserBuilders.CustomExternalUserBuilder, MyApp" resolve="true">

With that in place, you'll need to delete the original user and log in again in order for a user to be created with a proper username. You can see the result below.

Sitecore Identity Server showing the proper username after deleting the original user and logging in again

Depending on how you configure your user's properties as part of the Sitecore Identity Server Azure AD configuration, will depend on what is initially stored within the DefaultUserName. As such, you may have different options available.

Hey, Developers!

We're on the look out for talented developers to join our team.

Think you have what it takes?

Meet David Austin

Development Team Lead


David is a decorated Development Team Lead with Sitecore Technology MVP and Coveo MVP awards, as well as Sitecore CDP & Personalize Certified. He's worked in IT for 25 years; everything ranging from Developer to Business Analyst to Group Lead helping manage everything from Intranet and Internet sites to facility management and application support. David is a dedicated family man who loves to spend time with his girls. He's also an avid photographer and loves to explore new places.

Connect with David