Blazor

Adopt simplified authentication state serialization for Blazor Web Apps

Blazor Web Apps can optionally adopt simplified authentication state serialization.

In the server project:

• Remove the Persisting Authentication State Provider (PersistingAuthenticationStateProvider.cs).

• Remove the service registration from the Program file. Instead, chain a call to xref:Microsoft.Extensions.DependencyInjection.WebAssemblyRazorComponentsBuilderExtensions.AddAuthenticationStateSerialization%2A on xref:Microsoft.Extensions.DependencyInjection.RazorComponentsServiceCollectionExtensions.AddRazorComponents%2A:

  diffCopy

  - builder.Services.AddScoped<AuthenticationStateProvider, PersistingAuthenticationStateProvider>();
  
    builder.Services.AddRazorComponents()
        .AddInteractiveServerComponents()
        .AddInteractiveWebAssemblyComponents()
  +     .AddAuthenticationStateSerialization();
  

The API only serializes the server-side name and role claims for access in the browser. To include all claims, set xref:Microsoft.AspNetCore.Components.WebAssembly.Server.AuthenticationStateSerializationOptions.SerializeAllClaims to true:

.AddAuthenticationStateSerialization(options => options.SerializeAllClaims = true);

In the client project (.Client):

• Remove the Persistent Authentication State Provider (PersistentAuthenticationStateProvider.cs).

• Remove the service registration from the Program file. Instead, call xref:Microsoft.Extensions.DependencyInjection.WebAssemblyAuthenticationServiceCollectionExtensions.AddAuthenticationStateDeserialization%2A on the service collection:

  diffCopy

  - builder.Services.AddSingleton<AuthenticationStateProvider, PersistentAuthenticationStateProvider>();
  + builder.Services.AddAuthenticationStateDeserialization();
  

For more information, see xref:aspnetcore-9#simplified-authentication-state-serialization-for-blazor-web-apps.

Streaming rendering attribute no longer requires the true parameter

In .NET 8, streaming rendering required you to pass true for the enabled parameter:

@attribute [StreamRendering(true)]

In .NET 9 or later, true can optionally be removed, as true is now the default for the enabled parameter:

@attribute [StreamRendering]