//[doc-seo]
{
    "Description": "Follow this guide to smoothly migrate your Blazor WebAssembly project to OpenIddict, enhancing authentication capabilities with ABP Framework."
}

OpenIddict Blazor Wasm UI Migration Guide

Blazor Project

• In the MyApplication.Blazor.csproj replace project references:

  csharpCopy

  <PackageReference Include="Volo.Abp.IdentityServer.Blazor.WebAssembly" Version="6.0.*" />
  

  with

  csharpCopy

  <PackageReference Include="Volo.Abp.OpenIddict.Pro.Blazor.WebAssembly" Version="6.0.*" />
  

• In the MyApplicationBlazorModule.cs replace usings and module dependencies:

  csharpCopy

  using IdentityModel;
  using Volo.Abp.IdentityServer.Blazor.WebAssembly;
  ...
  typeof(AbpIdentityServerBlazorWebAssemblyModule),
  

  with

  csharpCopy

  using OpenIddict.Abstractions;
  using Volo.Abp.OpenIddict.Pro.Blazor.WebAssembly;
  ...
  typeof(AbpOpenIddictProBlazorWebAssemblyModule),
  

• In the MyApplicationBlazorModule.cs update the ConfigureAuthentication method:

  csharpCopy

  builder.Services.AddOidcAuthentication(options =>
  {
  	builder.Configuration.Bind("AuthServer", options.ProviderOptions);
      options.UserOptions.NameClaim = OpenIddictConstants.Claims.Name; // Add this line
      options.UserOptions.RoleClaim = OpenIddictConstants.Claims.Role; // Add this line
  
      options.ProviderOptions.DefaultScopes.Add("MyApplication");
      options.ProviderOptions.DefaultScopes.Add("roles"); // Update role to roles
      options.ProviderOptions.DefaultScopes.Add("email");
      options.ProviderOptions.DefaultScopes.Add("phone");
  });
  

  Remove options.UserOptions.RoleClaim = JwtClaimTypes.Role; and update role scope to roles.

• In the MyApplicationMenuContributor.cs under Navigation folder, replace the using and menu name under ConfigureMainMenuAsync:

  csharpCopy

  using Volo.Abp.IdentityServer.Blazor.Navigation;
  ...
  //Administration->Identity Server
  administration.SetSubItemOrder(AbpIdentityServerMenuNames.GroupName, 2);
  

  with

  csharpCopy

  using Volo.Abp.OpenIddict.Pro.Blazor.Menus;
  ...
  //Administration->OpenIddict
  administration.SetSubItemOrder(OpenIddictProMenus.GroupName, 2);
  

Http.Api.Host (Non-Separated IdentityServer)

• In the MyApplication.HttpApi.Host.csproj replace project references:

  csharpCopy

  <PackageReference Include="Volo.Abp.Account.Pro.Public.Web.IdentityServer" Version="6.0.*" />
  

  with

  csharpCopy

  <PackageReference Include="Volo.Abp.Account.Pro.Public.Web.OpenIddict" Version="6.0.*" />
  

• In the MyApplicationHttpApiHostModule.cs replace usings and module dependencies:

  csharpCopy

  using IdentityServer4.Configuration;
  using Volo.Abp.AspNetCore.Authentication.JwtBearer;
  ...
  typeof(AbpAccountPublicWebIdentityServerModule),
  

  with

  csharpCopy

  using OpenIddict.Validation.AspNetCore;
  ...
  typeof(AbpAccountPublicWebOpenIddictModule),
  

• In the MyApplicationHostModule.cs add PreConfigureServices like below with your application name as the audience:

  csharpCopy

  public override void PreConfigureServices(ServiceConfigurationContext context)
  {
      PreConfigure<OpenIddictBuilder>(builder =>
      {
          builder.AddValidation(options =>
          {
              options.AddAudiences("MyApplication"); // Replace with your application name
              options.UseLocalServer();
              options.UseAspNetCore();
          });
      });
  }
  

• In the MyApplicationHostModule.cs ConfigureServices method, replace the method call:

  From ConfigureAuthentication(context, configuration); to ConfigureAuthentication(context); and update the method as:

  csharpCopy

  private void ConfigureAuthentication(ServiceConfigurationContext context)
  {
      context.Services.ForwardIdentityAuthenticationForBearer(OpenIddictValidationAspNetCoreDefaults.AuthenticationScheme);
  }
  

• In the MyApplicationHostModule.cs OnApplicationInitialization method, replace the midware:

  csharpCopy

  app.UseJwtTokenMiddleware();
  app.UseIdentityServer();
  

  with

  Copy

  app.UseAbpOpenIddictValidation();
  

• Delete c.OAuthClientSecret(configuration["AuthServer:SwaggerClientSecret"]); in app.UseAbpSwaggerUI options configurations which is no longer needed.

• In appsettings.json delete SwaggerClientSecret from the AuthServer section like below:

  jsonCopy

  "AuthServer": {
      "Authority": "https://localhost:44345",
      "RequireHttpsMetadata": "false",
      "SwaggerClientId": "MyApplication_Swagger"
  },
  

Http.Api.Host (Separated IdentityServer)

• In the MyApplicationHttpApiHostModule.cs OnApplicationInitialization method, delete c.OAuthClientSecret(configuration["AuthServer:SwaggerClientSecret"]); in app.UseAbpSwaggerUI options configurations which is no longer needed.

• In appsettings.json delete SwaggerClientSecret from the AuthServer section like below:

  jsonCopy

  "AuthServer": {
      "Authority": "https://localhost:44345",
      "RequireHttpsMetadata": "false",
      "SwaggerClientId": "MyApplication_Swagger"
  },
  

IdentityServer

This project is renamed to AuthServer after v6.0.0. You can also refactor and rename your project to AuthServer for easier updates in the future.

• In MyApplication.IdentityServer.csproj replace project references:

  csharpCopy

  <PackageReference Include="Volo.Abp.Account.Pro.Public.Web.IdentityServer" Version="6.0.*" />
  

  with

  csharpCopy

  <PackageReference Include="Volo.Abp.Account.Pro.Public.Web.OpenIddict" Version="6.0.*" />
  

• In the MyApplicationIdentityServerModule.cs replace usings and module dependencies:

  csharpCopy

  using IdentityServer4.Configuration;
  using Volo.Abp.AspNetCore.Authentication.JwtBearer;
  ...
  typeof(AbpAccountPublicWebIdentityServerModule),
  

  with

  csharpCopy

  using OpenIddict.Validation.AspNetCore;
  ...
  typeof(AbpAccountPublicWebOpenIddictModule),
  

• In the MyApplicationIdentityServerModule.cs add PreConfigureServices like below with your application name as the audience:

  csharpCopy

  public override void PreConfigureServices(ServiceConfigurationContext context)
  {
      PreConfigure<OpenIddictBuilder>(builder =>
      {
          builder.AddValidation(options =>
          {
              options.AddAudiences("MyApplication"); // Replace with your application name
              options.UseLocalServer();
              options.UseAspNetCore();
          });
      });
  }
  

• In the MyApplicationIdentityServerModule.cs replace ForwardIdentityAuthenticationForBearer under ConfigureServices method:

  csharpCopy

  context.Services.ForwardIdentityAuthenticationForBearer();
  

  with

  csharpCopy

  context.Services.ForwardIdentityAuthenticationForBearer(OpenIddictValidationAspNetCoreDefaults.AuthenticationScheme);
  

• In the MyApplicationIdentityServerModule.cs, remove IdentityServerOptions configuration and JwtBearer options under ConfigureServices method:

  csharpCopy

  if (Convert.ToBoolean(configuration["AuthServer:SetSelfAsIssuer"])) // Remove
  {
      Configure<IdentityServerOptions>(options => { options.IssuerUri = configuration["App:SelfUrl"]; });
  }
  ...
  context.Services.AddAuthentication() // Remove
      .AddJwtBearer(options =>
      {
         options.Authority = configuration["AuthServer:Authority"];
         options.RequireHttpsMetadata = Convert.ToBoolean(configuration["AuthServer:RequireHttpsMetadata"]);
         options.Audience = "MyApplication";
      })
  

• In the MyApplicationIdentityServerModule.cs OnApplicationInitialization method, replace the midware:

  csharpCopy

  app.UseJwtTokenMiddleware();
  app.UseIdentityServer();
  

  with

 app.UseAbpOpenIddictValidation();

• To use the new AuthServer page, replace Index.cshtml.cs with AuthServer Index.cshtml.cs and Index.cshtml file with AuthServer Index.cshtml.

  Note: It can be found under the Pages folder.

See Also

• OpenIddict Step-by-Step Guide