[Blazor] 一文理清 Blazor Identity 鉴权验证

一文理清 Blazor Identity 鉴权验证

择要

在现代Web应用程序中，身份认证与授权是确保应用安全性和用户数据掩护的关键环节。Blazor作为基于C#和.NET的前端框架，提供了丰富的身份认证与授权机制。本文将深入解析Blazor的身份认证框架的构成，比较不同渲染模式下鉴权逻辑的异同，并通过具体案例演示如安在Blazor Server和Blazor WebAssembly中实现身份认证。通过本文的学习，读者将能够更好地理解并应用Blazor中的Identity，以构建安全可靠的Web应用程序。
鉴权框架的构成

Blazor的身份认证框架主要由以下三个核心部分组成：
基架： AuthenticationMiddleware (Microsoft.AspNetCore.Authentication)

AuthenticationMiddleware是ASP.NET Core中用于处理身份认证的中心件组件。它位于请求处理管道中，负责验证用户的身份并构建ClaimsPrincipal对象，将其附加到HttpContext.User属性中。全部后续的中心件和请求处理程序都可以访问该用户对象，从而了解当前请求的身份信息。
在Blazor应用程序中，AuthenticationMiddleware的作用是拦截HTTP请求，检查请求中是否包含有效的认证凭据（例如Cookie、JWT等）。如果凭据有效，它将解析并构建用户的身份信息；如果无效，则将用户视为未认证状态。
否
是
Cookie认证
JWT认证
其他方案
成功
失败
是
否
通过
不通过
HTTP请求
是否需要认证
直接访问资源
Authentication中心件
检查认证方案
解析Cookie
解析Authorization Header
...
验证Cookie有效性
验证Token署名
验证相应凭证
验证结果
创建ClaimsPrincipal
返回401/403
设置HttpContext.User
是否需要授权
Authorization中心件
访问资源
检查授权策略
访问资源
返回403

引用：

• Microsoft 文档：身份验证中心件
  
• Microsoft 文档：使用身份验证中心件
  

后端鉴权逻辑服务： IdentityCore (Microsoft.AspNetCore.Identity)

IdentityCore是ASP.NET Core提供的完整的身份管理框架。它为开发者提供了处理用户注册、登录、角色管理、暗码重置等功能的 APIs 和服务。IdentityCore高度可定制，可以使用不同的数据存储方式（如Entity Framework Core、MongoDB等）和暗码哈希算法。
在Blazor Server模式下，IdentityCore通常与AuthenticationMiddleware结合使用。后端服务器负责处理全部与身份相关的逻辑，包括验证用户凭据、管理用户数据和生成身份认证令牌等。
核心架构图

IdentityUser
+string Id
+string UserName
+string Email
+string PasswordHash
+string SecurityStamp
+bool EmailConfirmed
+bool TwoFactorEnabled
IdentityRole
+string Id
+string Name
+string NormalizedName
UserManager
+CreateAsync()
+FindByIdAsync()
+AddToRoleAsync()
+CheckPasswordAsync()
+GenerateEmailConfirmationTokenAsync()
SignInManager
+PasswordSignInAsync()
+SignInAsync()
+SignOutAsync()
+TwoFactorAuthenticatorSignInAsync()
RoleManager
+CreateAsync()
+FindByIdAsync()
+AddClaimAsync()
IdentityDbContext
+DbSet Users
+DbSet Roles
+DbSet UserClaims
+DbSet RoleClaims
UserStore
+CreateAsync()
+UpdateAsync()
+FindByIdAsync()
+AddToRoleAsync()
RoleStore
+CreateAsync()
+UpdateAsync()
+FindByIdAsync()
IdentityOptions
+PasswordOptions
+LockoutOptions
+UserOptions
+SignInOptions
IdentityBuilder
+AddEntityFrameworkStores()
+AddDefaultTokenProviders()
+AddDefaultUI()

配置与启动流程 （图中的配置函数非常原始，案例中会使用较新的简化函数，不过最终都是调用它们）

OptionsEFIdentityServicesStartupOptionsEFIdentityServicesStartup服务配置阶段配置暗码规则锁定策略用户选项等中心件配置ConfigureServices()AddIdentity()注册核心服务AddEntityFrameworkStores()Configure()UseAuthentication()UseAuthorization()配置认证中心件配置授权中心件
用户注册与认证流程

EmailDBStoreSignInManagerUserManagerControllerClientEmailDBStoreSignInManagerUserManagerControllerClient注册流程alt[需要邮箱验证]登录流程alt[启用2FA]注册请求CreateAsync(user, password)验证暗码规则生成SecurityStampHash暗码CreateAsync(user)保存用户GenerateEmailConfirmationTokenAsync发送确认邮件登录请求PasswordSignInAsyncFindByNameAsyncFindByNameAsync查询用户CheckPasswordAsync要求2FA验证提供2FA码TwoFactorSignInAsync创建身份票据设置认证Cookie
授权与角色管理流程（更侧重于使用AuthorizationMiddleware）

DBStoreRoleManagerUserManagerControllerClientDBStoreRoleManagerUserManagerControllerClient角色管理授权验证alt[基于角色][基于Claims]创建角色请求CreateAsync(role)CreateAsync(role)保存角色分配角色请求AddToRoleAsync(user, role)AddToRoleAsync更新用户角色关系请求受掩护资源[Authorize(Roles = "Admin")]IsInRoleAsyncIsInRoleAsync查询角色关系GetClaimsAsyncGetClaimsAsync查询Claims
扩展点和自定义实现

«interface»
IUserStore
+CreateAsync()
+UpdateAsync()
+DeleteAsync()
+FindByIdAsync()
«interface»
IUserPasswordStore
+SetPasswordHashAsync()
+GetPasswordHashAsync()
«interface»
IUserRoleStore
+AddToRoleAsync()
+RemoveFromRoleAsync()
+GetRolesAsync()
«interface»
IUserClaimStore
+AddClaimsAsync()
+RemoveClaimsAsync()
+GetClaimsAsync()
CustomUserStore
-IRepository repository
+CreateAsync()
+UpdateAsync()
+FindByIdAsync()
«interface»
IPasswordHasher
+HashPassword()
+VerifyHashedPassword()
«interface»
IPasswordValidator
+ValidateAsync()
«interface»
IUserValidator
+ValidateAsync()

主要特点：
模块化设计：核心身份模子、用户管理服务、存储抽象层、验证器接口
灵活的扩展性：自定义用户模子、自定义存储实现、可配置的选项、验证器扩展
完整的认证流程：用户注册、暗码验证、双因素认证、外部登录
丰富的授权机制：基于角色、基于Claims、基于策略、动态授权
安全特性：暗码哈希、账户锁定、安全戳验证、令牌管理
引用：

• Microsoft 文档：ASP.NET Core 上的 Identity 简介
  
• Microsoft 文档：在 ASP.NET Core 项目中添加 Identity
  

前端鉴权逻辑服务： AuthenticationStateProvider (Microsoft.AspNetCore.Components.Authorization)

AuthenticationStateProvider是Blazor中用于提供当前用户身份状态的抽象类。它的主要作用是向Blazor组件提供身份认证状态（AuthenticationState），以便组件能够根据用户的身份进行相应的显示和操作。
在Blazor应用程序中，AuthenticationStateProvider的具体实现方式取决于应用的渲染模式和身份认证方案。对于Blazor Server，这个提供程序可以直接从服务器的HttpContext.User获取身份信息；对于Blazor WebAssembly，由于代码在客户端运行，需要通过其他方式（如调用后端API或解析令牌）获取用户身份。
状态存储Identity服务自定义AuthProviderAuthenticationStateProviderCascadingAuthenticationStateBlazor组件状态存储Identity服务自定义AuthProviderAuthenticationStateProviderCascadingAuthenticationStateBlazor组件初始化阶段alt[自定义认证逻辑][默认实现]状态访问alt[通过注入访问][通过级联参数访问]状态变动Server模式授权验证alt[未授权][已授权]组件初始化GetAuthenticationStateAsync()委托处理获取用户信息返回用户数据构建AuthenticationState缓存状态获取当前用户返回ClaimsPrincipalnew AuthenticationState()返回AuthenticationState通过级联参数提供状态[CascadingParameter]Task@inject AuthenticationStateProvider返回Provider实例GetAuthenticationStateAsync()await AuthenticationState获取User信息处理授权逻辑用户状态变动更新AuthenticationState更新缓存状态NotifyAuthenticationStateChanged关照状态变动触发重新渲染@attribute [Authorize]GetAuthenticationStateAsync()获取缓存状态返回状态重定向到登录页允许访问渲染受掩护内容
主要特点：
状态管理：缓存认证状态、状态变动关照、状态同步更新
组件集成：CascadingAuthenticationState提供状态共享、AuthorizeView用于条件渲染、Authorize特性支持
自定义能力：自定义认证逻辑、自定义授权策略、状态持久化
安全特性：状态验证、角色授权、Claims基础授权
性能优化：状态缓存、按需刷新、组件重渲染控制
引用：

• Microsoft 文档：ASP.NET Core Blazor 身份验证和授权
  

不同渲染模式中鉴权逻辑的异同

相同点

组件在获取用户信息与鉴权状态时，都同一使用CascadingAuthenticationState

无论是Blazor Server还是Blazor WebAssembly，组件在需要访问用户身份信息时，都通过CascadingAuthenticationState提供的AuthenticationState。这使得组件能够以一致的方式获取用户的身份认证状态，无需关注底层的实现细节。
使用级联参数获取用户信息

1. @code {
2.     [CascadingParameter] private Task<AuthenticationState> stateTask { get; set; }
4.     private ClaimsPrincipal user;
6.     protected override async Task OnInitializedAsync()
7.     {
8.         var authState = await stateTask;
9.         user = authState.User;
10.     }
11. }

复制代码

使用服务获取用户信息

1. @inject AuthenticationStateProvider AuthenticationStateProvider
3. @code {
4.     private ClaimsPrincipal user;
6.     protected override async Task OnInitializedAsync()
7.     {
8.         var authState = await AuthenticationStateProvider.GetAuthenticationStateAsync();
9.         user = authState.User;
10.     }
11. }

复制代码

引用：

• Microsoft 文档：使身份验证状态成为级联参数
  

不同点

Server模式 实现RevalidatingServerAuthenticationStateProvider（基于AuthenticationStateProvider） 重点在验证ClaimPrincipal中的安全戳

在Blazor Server模式下，应用程序在服务器上运行，客户端通过SignalR持久连接与服务器通讯。默认情况下，Blazor Server使用ServerAuthenticationStateProvider，它直接从HttpContext.User获取用户的身份信息。
为了增强安全性，Blazor Server提供了RevalidatingServerAuthenticationStateProvider。它继承自ServerAuthenticationStateProvider，能够在指定的时间间隔内重新验证用户的身份状态。这主要通过检查ClaimsPrincipal中的安全戳（Security Stamp）来实现。当用户的安全戳发生变化（如暗码更改、账户被禁用等），该提供程序会检测到并更新用户的身份状态，要求用户重新登录。
HttpContext认证状态存储Blazor组件RevalidatingAuthProviderAuthenticationStateProviderBlazor CircuitSignalR HubCookie中心件数据库User StoreUserManagerSignInManagerIdentity服务认证中心件服务器浏览器用户HttpContext认证状态存储Blazor组件RevalidatingAuthProviderAuthenticationStateProviderBlazor CircuitSignalR HubCookie中心件数据库User StoreUserManagerSignInManagerIdentity服务认证中心件服务器浏览器用户SecurityStamp生成阶段Guid.NewGuid().ToString()如暗码修改/角色变动等alt[用户注册][安全相关操作]登录阶段包含用户Claims和SecurityStampHttpContext可用new AuthenticationState(Principal)认证状态持久化验证当前用户状态opt[需要重新验证]alt[首次请求或状态逾期]后台定期验证par[获取Claims中的SecurityStamp][获取数据库中的SecurityStamp]alt[SecurityStamp不匹配][SecurityStamp匹配]loop[每30分钟]注册请求CreateAsync生成新SecurityStamp保存用户信息存储SecurityStampUpdateSecurityStampAsync生成新SecurityStamp更新用户信息更新SecurityStamp登录请求SignInAsync验证凭据获取用户信息返回用户数据验证成功验证成功创建ClaimsPrincipal创建认证Cookie设置Cookie首次HTTP请求(带Cookie)返回初始HTML（App.razor）WebSocket连接请求(带Cookie)创建Circuit验证请求Cookie解析认证Cookie还原ClaimsPrincipal返回Principal创建AuthenticationState初始化认证状态存储认证状态GetAuthenticationStateAsync()检查状态是否需要重新验证返回验证时间ValidateAuthenticationStateAsync返回AuthenticationState用户交互处理请求❌无法访问HttpContext获取认证状态返回认证状态ValidateAuthenticationStateAsync从Claims获取SecurityStampGetSecurityStampAsync查询用户获取SecurityStamp返回当前SecurityStamp返回结果返回SecurityStamp更新认证状态NotifyAuthenticationStateChanged更新UI状态继续使用当前认证状态
引用：

• Microsoft 文档：在服务器上重新验证身份
  
• Microsoft 文档：RevalidatingServerAuthenticationStateProvider 源码示例
  

Webassembly模式 实现AuthenticationStateProvider与HttpMessageHandler（可选） 重点在访问个人信息终结点（或从自包含令牌）解析ClaimPrincipal

在Blazor WebAssembly模式下，应用程序在客户端浏览器中运行，没有直接访问服务器HttpContext的能力。因此，获取用户身份信息需要通过其他方式。例如，实现自定义的AuthenticationStateProvider，通过调用后端API（如用户信息终结点）获取用户信息，或者解析存储在客户端的JWT令牌来构建ClaimsPrincipal。
别的，为了在客户端向受掩护的API发送请求时主动附加身份认证令牌，或是在令牌逾期后主动刷新令牌，可以配置HttpClient使用自定义的HttpMessageHandler。这样，可以在请求头中添加必要的身份认证信息（如Bearer Token）或拦截401相应并刷新令牌重试请求。
Token服务后端APIHttpClientHandlerAuthenticationProviderBlazor组件Blazor WebAssembly应用浏览器用户Token服务后端APIHttpClientHandlerAuthenticationProviderBlazor组件Blazor WebAssembly应用浏览器用户alt[Token存在且未过-期][Token不存在或已-逾期]alt[验证成功][验证失败]alt[刷新成功][刷新失败]alt[Token有效][Token无效或逾期（返回401）]alt[刷新成功][刷新失败]alt[Token即将逾期][Token仍旧有效]loop[每固定时间间隔]打开应用URL加载Blazor WebAssembly应用初始化认证状态检查当地存储的Token使用现有Token设置为未认证状态返回认证状态渲染组件点击登录按钮调用Login方法发送登录请求(带用户凭据)验证用户凭据返回访问Token和刷新Token存储Token（如localStorage）更新认证状态为已认证关照认证状态已改变重新渲染受限页面返回错误信息关照登录失败GetAuthenticationStateAsync()使用Token请求用户信息（/userinfo）添加Authorization头返回用户信息返回AuthenticationState（包含用户信息）发起HTTP请求（携带API地址）拦截请求，添加Authorization头发送请求（带Token）返回请求数据返回数据返回401 Unauthorized关照Token无效实验刷新Token发送刷新Token请求验证刷新Token返回新的访问Token和刷新Token返回新的Token更新存储的Token关照重试原请求重新发送原请求（带新Token）返回请求数据返回数据返回刷新失败信息关照刷新失败清除Token，更新为未认证状态关照认证状态已改变（未认证）重定向到登录页或显示登录按钮检查Token有效期刷新Token验证刷新Token返回新的Token更新Token更新存储的Token返回刷新失败信息关照刷新失败清除Token，更新为未认证状态关照认证状态已改变（未认证）重定向到登录页或显示登录按钮无需操作
引用：

• Microsoft 文档：在 Blazor WebAssembly 中实现自定义 AuthenticationStateProvider
  
• Microsoft 文档：向 HttpClient 请求添加令牌
  

眼见为实：通过案例实现两种渲染模式的鉴权

下面，我们将通过具体的案例，演示如安在Blazor Server和Blazor WebAssembly应用程序中实现身份认证。
Server + Cookie

注册服务

1. builder.Services.AddCascadingAuthenticationState();                                                         // 添加级联参数获取认证信息
2. builder.Services.AddScoped<AuthenticationStateProvider, IdentityRevalidatingAuthenticationStateProvider>(); // 注册自实现的StateProvider
4. builder.Services.AddAuthentication(options =>
5. {
6.     //在这里设定默认方案
7.     options.DefaultScheme = IdentityConstants.ApplicationScheme;
8.     options.DefaultSignInScheme = IdentityConstants.ExternalScheme;
9.     options.DefaultSignOutScheme = IdentityConstants.ExternalScheme;
10. }).AddIdentityCookies(options =>
11. {
12. });
14. builder.Services.AddIdentityCore<ApplicationUser>(options =>    //ApplicationUser继承自IdentityUser
15. {
16.     //在这里设定鉴权配置，比如验证邮箱（这里不验证）、密码规则（这里设置最简规则）
17.     options.SignIn.RequireConfirmedAccount = false;
18.     options.Password.RequiredLength = 6;
19.     options.Password.RequireDigit = false;
20.     options.Password.RequireLowercase = false;
21.     options.Password.RequireNonAlphanumeric = false;
22.     options.Password.RequireUppercase = false;
23. })
24.     .AddRoles<IdentityRole>()                                   //需要自定义角色时，继承IdentityRole
25.     .AddEntityFrameworkStores<ApplicationDbContext>()           //ApplicationDbContext需要继承IdentityDbContext，其他ORM请自行搜索Store实现
26.     .AddSignInManager()                                         //使用Cookie时，推荐注册
27.     .AddDefaultTokenProviders();
29. builder.Services.AddSingleton<IEmailSender<ApplicationUser>, IdentityNoOpEmailSender>();
31. var app = builder.Build();
33. app.UseAuthentication();
34. app.UseAuthorization();

复制代码

其中，AddIdentityCookies方法的源代码如下：

1.     /// <summary>
2.     /// Adds the cookie authentication needed for sign in manager.
3.     /// </summary>
4.     /// <param name="builder">The current <see cref="AuthenticationBuilder"/> instance.</param>
5.     /// <param name="configureCookies">Action used to configure the cookies.</param>
6.     /// <returns>The <see cref="IdentityCookiesBuilder"/> which can be used to configure the identity cookies.</returns>
7.     public static IdentityCookiesBuilder AddIdentityCookies(this AuthenticationBuilder builder, Action<IdentityCookiesBuilder> configureCookies)
8.     {
9.         var cookieBuilder = new IdentityCookiesBuilder();
10.         cookieBuilder.ApplicationCookie = builder.AddApplicationCookie();
11.         cookieBuilder.ExternalCookie = builder.AddExternalCookie();
12.         cookieBuilder.TwoFactorRememberMeCookie = builder.AddTwoFactorRememberMeCookie();
13.         cookieBuilder.TwoFactorUserIdCookie = builder.AddTwoFactorUserIdCookie();
14.         configureCookies?.Invoke(cookieBuilder);
15.         return cookieBuilder;
16.     }

复制代码

IdentityNoOpEmailSender

1.     public sealed class IdentityNoOpEmailSender : IEmailSender<ApplicationUser>
2.     {
3.         private readonly IEmailSender emailSender = new NoOpEmailSender(); //案例不实现真正的邮件发送
5.         public Task SendConfirmationLinkAsync(ApplicationUser user, string email, string confirmationLink) =>
6.             emailSender.SendEmailAsync(email, "Confirm your email", $"Please confirm your account by <a target="_blank" href='https://www.cnblogs.com/{confirmationLink}'>clicking here</a>.");
8.         public Task SendPasswordResetLinkAsync(ApplicationUser user, string email, string resetLink) =>
9.             emailSender.SendEmailAsync(email, "Reset your password", $"Please reset your password by <a target="_blank" href='https://www.cnblogs.com/{resetLink}'>clicking here</a>.");
11.         public Task SendPasswordResetCodeAsync(ApplicationUser user, string email, string resetCode) =>
12.             emailSender.SendEmailAsync(email, "Reset your password", $"Please reset your password using the following code: {resetCode}");
13.     }

复制代码

IdentityRevalidatingAuthenticationStateProvider

1. public sealed class IdentityRevalidatingAuthenticationStateProvider(
2.         ILoggerFactory loggerFactory,
3.         IServiceScopeFactory scopeFactory,
4.         IOptions<IdentityOptions> options)
5.     : RevalidatingServerAuthenticationStateProvider(loggerFactory)
6. {
7.     protected override TimeSpan RevalidationInterval => TimeSpan.FromMinutes(30);
9.     protected override async Task<bool> ValidateAuthenticationStateAsync(
10.         AuthenticationState authenticationState, CancellationToken cancellationToken)
11.     {
12.         // Get the user manager from a new scope to ensure it fetches fresh data
13.         await using var scope = scopeFactory.CreateAsyncScope();
14.         var userManager = scope.ServiceProvider.GetRequiredService<UserManager<ApplicationUser>>();
15.         return await ValidateSecurityStampAsync(userManager, authenticationState.User);
16.     }
18.     private async Task<bool> ValidateSecurityStampAsync(UserManager<ApplicationUser> userManager, ClaimsPrincipal principal)
19.     {
20.         var user = await userManager.GetUserAsync(principal);
21.         if (user is null)
22.         {
23.             return false;
24.         }
25.         else if (!userManager.SupportsUserSecurityStamp)
26.         {
27.             return true;
28.         }
29.         else
30.         {
31.             var principalStamp = principal.FindFirstValue(options.Value.ClaimsIdentity.SecurityStampClaimType);
32.             var userStamp = await userManager.GetSecurityStampAsync(user);
33.             return principalStamp == userStamp;
34.         }
35.     }
36. }

复制代码

登录时，可以使用表单提交，也可以使用Ajax POST（制作动态网页时的首选），后端处理的逻辑代码相同，即都通过SignInManager实现发送Set-Cookie请求
表单处理：

1.     public async Task LoginUser()
2.     {
3.             // This doesn't count login failures towards account lockout
4.             // To enable password failures to trigger account lockout, set lockoutOnFailure: true
5.             var result = await SignInManager.PasswordSignInAsync(Input.Email, Input.Password, Input.RememberMe, lockoutOnFailure: false);
6.             if (result.Succeeded)
7.             {
8.                 RedirectManager.RedirectTo("/");
9.             }
10.             else if (result.RequiresTwoFactor)
11.             {
12.                 RedirectManager.RedirectTo(
13.                     "Account/LoginWith2fa",
14.                     new() { ["returnUrl"] = ReturnUrl, ["rememberMe"] = Input.RememberMe });
15.             }
16.             else if (result.IsLockedOut)
17.             {
18.                 RedirectManager.RedirectTo("Account/Lockout");
19.             }
20.             else
21.             {
22.                 errorMessage = $@"账号或密码错误";
23.             }
24.     }

复制代码

WebAPI：

1. app.MapPost("Login", async (CheckDto Input,
2.                             UserManager<ApplicationUser> userManager,
3.                             SignInManager<ApplicationUser> signInManager) =>
4. {
5.     var emailResult = await userManager.FindByEmailAsync(dto.username);
6.     if (emailResult is null) return Results.BadRequest("账号未注册");
7.     if (await userManager.CheckPasswordAsync(emailResult, dto.password))
8.     {
9.         await signInManager.SignInAsync(emailResult, false);
10.         return Results.Ok();
11.     }
12.     return Results.BadRequest("密码错误");  //401不能返回错误信息，故使用400
13. });

复制代码

WebAssembly + Cookie + UserInfo Endpoint

此方式是微软推荐的鉴权方式，相比于JWT安全性较高
注册服务（使用.NET 8以后新增的方法）

1. builder.Services.AddAuthorization();
2. builder.Services.AddIdentityApiEndpoints<ApplicationUser>()
3.     .AddEntityFrameworkStores<ApplicationDbContext>();
5. var app = builder.Build();
7. app.UseAuthentication();
8. app.UseAuthorization();
10. app.MapIdentityApi<ApplicationUser>();

复制代码

源码解读：

1.     /// <summary>
2.     /// Adds a set of common identity services to the application to support <see cref="IdentityApiEndpointRouteBuilderExtensions.MapIdentityApi{TUser}(IEndpointRouteBuilder)"/>
3.     /// and configures authentication to support identity bearer tokens and cookies.
4.     /// </summary>
5.     /// <param name="services">The <see cref="IServiceCollection"/>.</param>
6.     /// <param name="configure">Configures the <see cref="IdentityOptions"/>.</param>
7.     /// <returns>The <see cref="IdentityBuilder"/>.</returns>
8.     public static IdentityBuilder AddIdentityApiEndpoints<TUser>(this IServiceCollection services, Action<IdentityOptions> configure)
9.         where TUser : class, new()
10.     {
11.         ArgumentNullException.ThrowIfNull(services);
12.         ArgumentNullException.ThrowIfNull(configure);
14.         services
15.             .AddAuthentication(IdentityConstants.BearerAndApplicationScheme)
16.             .AddScheme<AuthenticationSchemeOptions, CompositeIdentityHandler>(IdentityConstants.BearerAndApplicationScheme, null, compositeOptions =>
17.             {
18.                 compositeOptions.ForwardDefault = IdentityConstants.BearerScheme;
19.                 compositeOptions.ForwardAuthenticate = IdentityConstants.BearerAndApplicationScheme;
20.             })
21.             .AddBearerToken(IdentityConstants.BearerScheme)
22.             .AddIdentityCookies();
24.         return services.AddIdentityCore<TUser>(configure)
25.             .AddApiEndpoints();
26.     }
27.     /// <summary>
28.     /// Add endpoints for registering, logging in, and logging out using ASP.NET Core Identity.
29.     /// </summary>
30.     /// <typeparam name="TUser">The type describing the user. This should match the generic parameter in <see cref="UserManager{TUser}"/>.</typeparam>
31.     /// <param name="endpoints">
32.     /// The <see cref="IEndpointRouteBuilder"/> to add the identity endpoints to.
33.     /// Call <see cref="EndpointRouteBuilderExtensions.MapGroup(IEndpointRouteBuilder, string)"/> to add a prefix to all the endpoints.
34.     /// </param>
35.     /// <returns>An <see cref="IEndpointConventionBuilder"/> to further customize the added endpoints.</returns>
36.     public static IEndpointConventionBuilder MapIdentityApi<TUser>(this IEndpointRouteBuilder endpoints)
37.         where TUser : class, new()
38.     {
39.         ArgumentNullException.ThrowIfNull(endpoints);
41.         var timeProvider = endpoints.ServiceProvider.GetRequiredService<TimeProvider>();
42.         var bearerTokenOptions = endpoints.ServiceProvider.GetRequiredService<IOptionsMonitor<BearerTokenOptions>>();
43.         var emailSender = endpoints.ServiceProvider.GetRequiredService<IEmailSender<TUser>>();
44.         var linkGenerator = endpoints.ServiceProvider.GetRequiredService<LinkGenerator>();
46.         // We'll figure out a unique endpoint name based on the final route pattern during endpoint generation.
47.         string? confirmEmailEndpointName = null;
49.         var routeGroup = endpoints.MapGroup("");
51.         // NOTE: We cannot inject UserManager<TUser> directly because the TUser generic parameter is currently unsupported by RDG.
52.         // https://github.com/dotnet/aspnetcore/issues/47338
53.         routeGroup.MapPost("/register", async Task<Results<Ok, ValidationProblem>>
54.             ([FromBody] RegisterRequest registration, HttpContext context, [FromServices] IServiceProvider sp) =>
55.         {
56.             var userManager = sp.GetRequiredService<UserManager<TUser>>();
58.             if (!userManager.SupportsUserEmail)
59.             {
60.                 throw new NotSupportedException($"{nameof(MapIdentityApi)} requires a user store with email support.");
61.             }
63.             var userStore = sp.GetRequiredService<IUserStore<TUser>>();
64.             var emailStore = (IUserEmailStore<TUser>)userStore;
65.             var email = registration.Email;
67.             if (string.IsNullOrEmpty(email) || !_emailAddressAttribute.IsValid(email))
68.             {
69.                 return CreateValidationProblem(IdentityResult.Failed(userManager.ErrorDescriber.InvalidEmail(email)));
70.             }
72.             var user = new TUser();
73.             await userStore.SetUserNameAsync(user, email, CancellationToken.None);
74.             await emailStore.SetEmailAsync(user, email, CancellationToken.None);
75.             var result = await userManager.CreateAsync(user, registration.Password);
77.             if (!result.Succeeded)
78.             {
79.                 return CreateValidationProblem(result);
80.             }
82.             await SendConfirmationEmailAsync(user, userManager, context, email);
83.             return TypedResults.Ok();
84.         });
86.         routeGroup.MapPost("/login", async Task<Results<Ok<AccessTokenResponse>, EmptyHttpResult, ProblemHttpResult>>
87.             ([FromBody] LoginRequest login, [FromQuery] bool? useCookies, [FromQuery] bool? useSessionCookies, [FromServices] IServiceProvider sp) =>
88.         {
89.             var signInManager = sp.GetRequiredService<SignInManager<TUser>>();
91.             var useCookieScheme = (useCookies == true) || (useSessionCookies == true);
92.             var isPersistent = (useCookies == true) && (useSessionCookies != true);
93.             signInManager.AuthenticationScheme = useCookieScheme ? IdentityConstants.ApplicationScheme : IdentityConstants.BearerScheme;
95.             var result = await signInManager.PasswordSignInAsync(login.Email, login.Password, isPersistent, lockoutOnFailure: true);
97.             if (result.RequiresTwoFactor)
98.             {
99.                 if (!string.IsNullOrEmpty(login.TwoFactorCode))
100.                 {
101.                     result = await signInManager.TwoFactorAuthenticatorSignInAsync(login.TwoFactorCode, isPersistent, rememberClient: isPersistent);
102.                 }
103.                 else if (!string.IsNullOrEmpty(login.TwoFactorRecoveryCode))
104.                 {
105.                     result = await signInManager.TwoFactorRecoveryCodeSignInAsync(login.TwoFactorRecoveryCode);
106.                 }
107.             }
109.             if (!result.Succeeded)
110.             {
111.                 return TypedResults.Problem(result.ToString(), statusCode: StatusCodes.Status401Unauthorized);
112.             }
114.             // The signInManager already produced the needed response in the form of a cookie or bearer token.
115.             return TypedResults.Empty;
116.         });
118.         routeGroup.MapPost("/refresh", async Task<Results<Ok<AccessTokenResponse>, UnauthorizedHttpResult, SignInHttpResult, ChallengeHttpResult>>
119.             ([FromBody] RefreshRequest refreshRequest, [FromServices] IServiceProvider sp) =>
120.         {
121.             var signInManager = sp.GetRequiredService<SignInManager<TUser>>();
122.             var refreshTokenProtector = bearerTokenOptions.Get(IdentityConstants.BearerScheme).RefreshTokenProtector;
123.             var refreshTicket = refreshTokenProtector.Unprotect(refreshRequest.RefreshToken);
125.             // Reject the /refresh attempt with a 401 if the token expired or the security stamp validation fails
126.             if (refreshTicket?.Properties?.ExpiresUtc is not { } expiresUtc ||
127.                 timeProvider.GetUtcNow() >= expiresUtc ||
128.                 await signInManager.ValidateSecurityStampAsync(refreshTicket.Principal) is not TUser user)
130.             {
131.                 return TypedResults.Challenge();
132.             }
134.             var newPrincipal = await signInManager.CreateUserPrincipalAsync(user);
135.             return TypedResults.SignIn(newPrincipal, authenticationScheme: IdentityConstants.BearerScheme);
136.         });
138.         routeGroup.MapGet("/confirmEmail", async Task<Results<ContentHttpResult, UnauthorizedHttpResult>>
139.             ([FromQuery] string userId, [FromQuery] string code, [FromQuery] string? changedEmail, [FromServices] IServiceProvider sp) =>
140.         {
141.             var userManager = sp.GetRequiredService<UserManager<TUser>>();
142.             if (await userManager.FindByIdAsync(userId) is not { } user)
143.             {
144.                 // We could respond with a 404 instead of a 401 like Identity UI, but that feels like unnecessary information.
145.                 return TypedResults.Unauthorized();
146.             }
148.             try
149.             {
150.                 code = Encoding.UTF8.GetString(WebEncoders.Base64UrlDecode(code));
151.             }
152.             catch (FormatException)
153.             {
154.                 return TypedResults.Unauthorized();
155.             }
157.             IdentityResult result;
159.             if (string.IsNullOrEmpty(changedEmail))
160.             {
161.                 result = await userManager.ConfirmEmailAsync(user, code);
162.             }
163.             else
164.             {
165.                 // As with Identity UI, email and user name are one and the same. So when we update the email,
166.                 // we need to update the user name.
167.                 result = await userManager.ChangeEmailAsync(user, changedEmail, code);
169.                 if (result.Succeeded)
170.                 {
171.                     result = await userManager.SetUserNameAsync(user, changedEmail);
172.                 }
173.             }
175.             if (!result.Succeeded)
176.             {
177.                 return TypedResults.Unauthorized();
178.             }
180.             return TypedResults.Text("Thank you for confirming your email.");
181.         })
182.         .Add(endpointBuilder =>
183.         {
184.             var finalPattern = ((RouteEndpointBuilder)endpointBuilder).RoutePattern.RawText;
185.             confirmEmailEndpointName = $"{nameof(MapIdentityApi)}-{finalPattern}";
186.             endpointBuilder.Metadata.Add(new EndpointNameMetadata(confirmEmailEndpointName));
187.         });
189.         routeGroup.MapPost("/resendConfirmationEmail", async Task<Ok>
190.             ([FromBody] ResendConfirmationEmailRequest resendRequest, HttpContext context, [FromServices] IServiceProvider sp) =>
191.         {
192.             var userManager = sp.GetRequiredService<UserManager<TUser>>();
193.             if (await userManager.FindByEmailAsync(resendRequest.Email) is not { } user)
194.             {
195.                 return TypedResults.Ok();
196.             }
198.             await SendConfirmationEmailAsync(user, userManager, context, resendRequest.Email);
199.             return TypedResults.Ok();
200.         });
202.         routeGroup.MapPost("/forgotPassword", async Task<Results<Ok, ValidationProblem>>
203.             ([FromBody] ForgotPasswordRequest resetRequest, [FromServices] IServiceProvider sp) =>
204.         {
205.             var userManager = sp.GetRequiredService<UserManager<TUser>>();
206.             var user = await userManager.FindByEmailAsync(resetRequest.Email);
208.             if (user is not null && await userManager.IsEmailConfirmedAsync(user))
209.             {
210.                 var code = await userManager.GeneratePasswordResetTokenAsync(user);
211.                 code = WebEncoders.Base64UrlEncode(Encoding.UTF8.GetBytes(code));
213.                 await emailSender.SendPasswordResetCodeAsync(user, resetRequest.Email, HtmlEncoder.Default.Encode(code));
214.             }
216.             // Don't reveal that the user does not exist or is not confirmed, so don't return a 200 if we would have
217.             // returned a 400 for an invalid code given a valid user email.
218.             return TypedResults.Ok();
219.         });
221.         routeGroup.MapPost("/resetPassword", async Task<Results<Ok, ValidationProblem>>
222.             ([FromBody] ResetPasswordRequest resetRequest, [FromServices] IServiceProvider sp) =>
223.         {
224.             var userManager = sp.GetRequiredService<UserManager<TUser>>();
226.             var user = await userManager.FindByEmailAsync(resetRequest.Email);
228.             if (user is null || !(await userManager.IsEmailConfirmedAsync(user)))
229.             {
230.                 // Don't reveal that the user does not exist or is not confirmed, so don't return a 200 if we would have
231.                 // returned a 400 for an invalid code given a valid user email.
232.                 return CreateValidationProblem(IdentityResult.Failed(userManager.ErrorDescriber.InvalidToken()));
233.             }
235.             IdentityResult result;
236.             try
237.             {
238.                 var code = Encoding.UTF8.GetString(WebEncoders.Base64UrlDecode(resetRequest.ResetCode));
239.                 result = await userManager.ResetPasswordAsync(user, code, resetRequest.NewPassword);
240.             }
241.             catch (FormatException)
242.             {
243.                 result = IdentityResult.Failed(userManager.ErrorDescriber.InvalidToken());
244.             }
246.             if (!result.Succeeded)
247.             {
248.                 return CreateValidationProblem(result);
249.             }
251.             return TypedResults.Ok();
252.         });
254.         var accountGroup = routeGroup.MapGroup("/manage").RequireAuthorization();
256.         accountGroup.MapPost("/2fa", async Task<Results<Ok<TwoFactorResponse>, ValidationProblem, NotFound>>
257.             (ClaimsPrincipal claimsPrincipal, [FromBody] TwoFactorRequest tfaRequest, [FromServices] IServiceProvider sp) =>
258.         {
259.             var signInManager = sp.GetRequiredService<SignInManager<TUser>>();
260.             var userManager = signInManager.UserManager;
261.             if (await userManager.GetUserAsync(claimsPrincipal) is not { } user)
262.             {
263.                 return TypedResults.NotFound();
264.             }
266.             if (tfaRequest.Enable == true)
267.             {
268.                 if (tfaRequest.ResetSharedKey)
269.                 {
270.                     return CreateValidationProblem("CannotResetSharedKeyAndEnable",
271.                         "Resetting the 2fa shared key must disable 2fa until a 2fa token based on the new shared key is validated.");
272.                 }
274.                 if (string.IsNullOrEmpty(tfaRequest.TwoFactorCode))
275.                 {
276.                     return CreateValidationProblem("RequiresTwoFactor",
277.                         "No 2fa token was provided by the request. A valid 2fa token is required to enable 2fa.");
278.                 }
280.                 if (!await userManager.VerifyTwoFactorTokenAsync(user, userManager.Options.Tokens.AuthenticatorTokenProvider, tfaRequest.TwoFactorCode))
281.                 {
282.                     return CreateValidationProblem("InvalidTwoFactorCode",
283.                         "The 2fa token provided by the request was invalid. A valid 2fa token is required to enable 2fa.");
284.                 }
286.                 await userManager.SetTwoFactorEnabledAsync(user, true);
287.             }
288.             else if (tfaRequest.Enable == false || tfaRequest.ResetSharedKey)
289.             {
290.                 await userManager.SetTwoFactorEnabledAsync(user, false);
291.             }
293.             if (tfaRequest.ResetSharedKey)
294.             {
295.                 await userManager.ResetAuthenticatorKeyAsync(user);
296.             }
298.             string[]? recoveryCodes = null;
299.             if (tfaRequest.ResetRecoveryCodes || (tfaRequest.Enable == true && await userManager.CountRecoveryCodesAsync(user) == 0))
300.             {
301.                 var recoveryCodesEnumerable = await userManager.GenerateNewTwoFactorRecoveryCodesAsync(user, 10);
302.                 recoveryCodes = recoveryCodesEnumerable?.ToArray();
303.             }
305.             if (tfaRequest.ForgetMachine)
306.             {
307.                 await signInManager.ForgetTwoFactorClientAsync();
308.             }
310.             var key = await userManager.GetAuthenticatorKeyAsync(user);
311.             if (string.IsNullOrEmpty(key))
312.             {
313.                 await userManager.ResetAuthenticatorKeyAsync(user);
314.                 key = await userManager.GetAuthenticatorKeyAsync(user);
316.                 if (string.IsNullOrEmpty(key))
317.                 {
318.                     throw new NotSupportedException("The user manager must produce an authenticator key after reset.");
319.                 }
320.             }
322.             return TypedResults.Ok(new TwoFactorResponse
323.             {
324.                 SharedKey = key,
325.                 RecoveryCodes = recoveryCodes,
326.                 RecoveryCodesLeft = recoveryCodes?.Length ?? await userManager.CountRecoveryCodesAsync(user),
327.                 IsTwoFactorEnabled = await userManager.GetTwoFactorEnabledAsync(user),
328.                 IsMachineRemembered = await signInManager.IsTwoFactorClientRememberedAsync(user),
329.             });
330.         });
332.         accountGroup.MapGet("/info", async Task<Results<Ok<InfoResponse>, ValidationProblem, NotFound>>
333.             (ClaimsPrincipal claimsPrincipal, [FromServices] IServiceProvider sp) =>
334.         {
335.             var userManager = sp.GetRequiredService<UserManager<TUser>>();
336.             if (await userManager.GetUserAsync(claimsPrincipal) is not { } user)
337.             {
338.                 return TypedResults.NotFound();
339.             }
341.             return TypedResults.Ok(await CreateInfoResponseAsync(user, userManager));
342.         });
344.         accountGroup.MapPost("/info", async Task<Results<Ok<InfoResponse>, ValidationProblem, NotFound>>
345.             (ClaimsPrincipal claimsPrincipal, [FromBody] InfoRequest infoRequest, HttpContext context, [FromServices] IServiceProvider sp) =>
346.         {
347.             var userManager = sp.GetRequiredService<UserManager<TUser>>();
348.             if (await userManager.GetUserAsync(claimsPrincipal) is not { } user)
349.             {
350.                 return TypedResults.NotFound();
351.             }
353.             if (!string.IsNullOrEmpty(infoRequest.NewEmail) && !_emailAddressAttribute.IsValid(infoRequest.NewEmail))
354.             {
355.                 return CreateValidationProblem(IdentityResult.Failed(userManager.ErrorDescriber.InvalidEmail(infoRequest.NewEmail)));
356.             }
358.             if (!string.IsNullOrEmpty(infoRequest.NewPassword))
359.             {
360.                 if (string.IsNullOrEmpty(infoRequest.OldPassword))
361.                 {
362.                     return CreateValidationProblem("OldPasswordRequired",
363.                         "The old password is required to set a new password. If the old password is forgotten, use /resetPassword.");
364.                 }
366.                 var changePasswordResult = await userManager.ChangePasswordAsync(user, infoRequest.OldPassword, infoRequest.NewPassword);
367.                 if (!changePasswordResult.Succeeded)
368.                 {
369.                     return CreateValidationProblem(changePasswordResult);
370.                 }
371.             }
373.             if (!string.IsNullOrEmpty(infoRequest.NewEmail))
374.             {
375.                 var email = await userManager.GetEmailAsync(user);
377.                 if (email != infoRequest.NewEmail)
378.                 {
379.                     await SendConfirmationEmailAsync(user, userManager, context, infoRequest.NewEmail, isChange: true);
380.                 }
381.             }
383.             return TypedResults.Ok(await CreateInfoResponseAsync(user, userManager));
384.         });
385.     }

复制代码

可以看到，基架生成的info接口返回的用户信息非常有限，实际业务中需要自行写一个返回角色/Claims信息的userinfo接口（注入UserManager和RoleManager查询）
根据基架生成的API，编写前端代码：
注册服务：

1. // 注册LocalStorage服务
2. builder.Services.AddBlazoredLocalStorageAsSingleton();
3. // 注册鉴权服务
4. builder.Services.AddSingleton<AuthenticationStateProvider, CookieAuthenticationStateProvider>();
5. // 注册通用客户端的鉴权拦截器（令牌过期重试）
6. builder.Services.AddSingleton<AuthenticationStateHandler>();
7. // 注册鉴权专用客户端
8. builder.Services.AddHttpClient("auth", client =>
9. {
10.     client.BaseAddress = new Uri("API_URL");
11. });
12. // 注册业务通用客户端
13. builder.Services.AddHttpClient("backend", client =>
14. {
15.     client.BaseAddress = new Uri("API_URL");
16. }).AddHttpMessageHandler<AuthenticationStateHandler>();
17. // 设为默认客户端
18. builder.Services.AddSingleton(sp => sp.GetRequiredService<IHttpClientFactory>().CreateClient("backend"));
19. // 注册鉴权基架
20. builder.Services.AddAuthorizationCore();
21. builder.Services.AddCascadingAuthenticationState();

复制代码

AuthenticationStateHandler:

1. public class AuthenticationStateHandler(AuthenticationStateProvider stateProvider, NavigationManager navigationManager) : DelegatingHandler
2. {
3.     protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
4.     {
5.         var response = await base.SendAsync(request, cancellationToken);
6.         //如果令牌过期，刷新令牌并重试请求
7.         if (response.StatusCode == System.Net.HttpStatusCode.Unauthorized)
8.         {
9.             var authState = await stateProvider.GetAuthenticationStateAsync();
10.             if (authState.User.Identity?.IsAuthenticated ?? false)
11.             {
12.                 if (await (stateProvider as CookieAuthenticationStateProvider).RefreshTokenAsync())
13.                 {
14.                     return await SendAsync(request, cancellationToken);
15.                 }
16.             }
17.             navigationManager.NavigateTo("/login");
18.         }
19.         return response;
20.     }
21. }

复制代码

CookieAuthenticationStateProvider:

1. public sealed class CookieAuthenticationStateProvider(IServiceProvider serviceProvider, IHttpClientFactory httpClientFactory, ILocalStorageService localStorage, ISyncLocalStorageService syncLocalStorage) : AuthenticationStateProvider
2. {
3.     //token过期时间
4.     private static TimeSpan UserCacheRefreshInterval = TimeSpan.FromHours(1);
5.     //上次获取token时间
6.     private static DateTimeOffset UserLastCheckTime = DateTimeOffset.FromUnixTimeSeconds(0);
7.     //缓存用户状态
8.     private ClaimsPrincipal CachedUser = new(new ClaimsIdentity());
9.     //默认用户状态（未登录）
10.     private static readonly Task<AuthenticationState> defaultUnanthenticatedTask = Task.FromResult(new AuthenticationState(new ClaimsPrincipal(new ClaimsIdentity())));
11.     //刷新令牌
12.     private string? refresh_token { get; set; } = syncLocalStorage.GetItem<string>("refresh_token");
13.     //访问令牌
14.     private string? access_token { get; set; } = syncLocalStorage.GetItem<string>("access_token");
15.     //鉴权专用客户端示例
16.     private HttpClient client = httpClientFactory.CreateClient("auth");
17.     //解析令牌获取身份信息
18.     private async Task ParseTokenAsync()
19.     {   
20.         var response = await client.GetAsync("/info");  //推荐自己写userinfo接口代替
21.         if (response.IsSuccessStatusCode)
22.         {
23.             var infoResponse = await response.Content.ReadFromJsonAsync<InfoResponse>();
24.             if (infoResponse != null)
25.             {
26.                 var claims = new List<Claim>
27.                 {
28.                     new Claim(ClaimTypes.Email, infoResponse.Email),
29.                     new Claim("IsEmailConfirmed", infoResponse.IsEmailConfirmed.ToString())
30.                 };
31.             CachedUser = new ClaimsPrincipal(new ClaimsIdentity(claims, "Bearer"));
32.             }
33.         }
34.         else
35.         {
36.             CachedUser = new ClaimsPrincipal(new ClaimsIdentity());
37.         }
38.     }
39.     //设置客户端携带令牌
40.     private void SetClientToken()
41.     {
42.         client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", access_token);
43.         serviceProvider.GetRequiredService<HttpClient>().DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", access_token);
44.     }
45.     //处理令牌接口返回值
46.     private async Task<bool> ParseResponseAsync(AccessTokenResponse token)
47.     {
48.         if (token != null)
49.         {
50.             refresh_token = token.RefreshToken;
51.             access_token = token.AccessToken;
52.             await localStorage.SetItemAsync("access_token", access_token);
53.             await localStorage.SetItemAsync("refresh_token", refresh_token);
54.             UserCacheRefreshInterval = TimeSpan.FromSeconds(token.ExpiresIn);
55.             UserLastCheckTime = DateTimeOffset.UtcNow;
56.             SetClientToken();
57.             await ParseTokenAsync();
58.             NotifyAuthenticationStateChanged(GetAuthenticationStateAsync());
59.             return true;
60.         }
61.         return false;
62.     }
63.     //注册
64.     public async Task<RegisterResponse> RegisterAsync(RegisterModel model)
65.     {
66.         var response = await client.PostAsJsonAsync(@"register", model);
67.         var reg = await response.Content.ReadFromJsonAsync<RegisterResponse>();
68.         if (reg.Succeeded) await ParseResponseAsync(reg.TokenResponse);
69.         return reg;
70.     }
71.     //登录
72.     public async Task<bool> LoginAsync(string username, string password)
73.     {
74.         var response = await client.PostAsJsonAsync(@"login", new LoginRequest { Username = username, Password = password } );
75.         if (response.StatusCode == HttpStatusCode.Unauthorized)
76.         {
77.             return false;
78.         }
79.         var token = await response.Content.ReadFromJsonAsync<AccessTokenResponse>();
80.         return await ParseResponseAsync(token);
81.     }
82.     //登出
83.     public async Task LogoutAsync()
84.     {
85.         await client.PostAsync(@"logout",new StringContent(string.Empty));
86.         refresh_token = null;
87.         access_token = null;
88.         await localStorage.RemoveItemAsync("access_token");
89.         await localStorage.RemoveItemAsync("refresh_token");
90.         UserLastCheckTime = DateTimeOffset.FromUnixTimeSeconds(0);
91.         CachedUser = new ClaimsPrincipal(new ClaimsIdentity());
92.         NotifyAuthenticationStateChanged(defaultUnanthenticatedTask);
93.     }
94.     //刷新令牌
95.     public async Task<bool> RefreshTokenAsync()
96.     {
97.         if (refresh_token is null) return false;
98.         SetClientToken();
99.         var response = await client.PostAsJsonAsync(@"refresh", new { RefreshToken = refresh_token });
100.         if (response.StatusCode == HttpStatusCode.Unauthorized)
101.         {
102.             return false;
103.         }
104.         var token = await response.Content.ReadFromJsonAsync<AccessTokenResponse>();
105.         return await ParseResponseAsync(token);
106.     }
107.     //获取用户鉴权信息
108.     public override async Task<AuthenticationState> GetAuthenticationStateAsync()
109.     {
110.         if (DateTimeOffset.UtcNow - UserLastCheckTime < UserCacheRefreshInterval || await RefreshTokenAsync())
111.         {
112.             return new AuthenticationState(CachedUser);
113.         }
114.         return await defaultUnanthenticatedTask;
115.     }
116. }

复制代码

WebAssembly + JWT

此方法安全性较低，不推荐
注册服务

1. // JWT 配置
2. var jwtSettings = builder.Configuration.GetSection("JwtSettings");
3. var secretKey = Encoding.UTF8.GetBytes(jwtSettings["SecretKey"]!);
5. // 添加认证服务
6. builder.Services.AddAuthentication(options =>
7. {
8.     options.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme;
9.     options.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
10. })
11. .AddJwtBearer(options =>
12. {
13.     options.TokenValidationParameters = new TokenValidationParameters
14.     {
15.         ValidateIssuer = true,
16.         ValidateAudience = true,
17.         ValidateLifetime = true,
18.         ValidateIssuerSigningKey = true,
19.         ValidIssuer = jwtSettings["Issuer"],
20.         ValidAudience = jwtSettings["Audience"],
21.         IssuerSigningKey = new SymmetricSecurityKey(secretKey)
22.     };
23. });
25. // 添加授权服务
26. builder.Services.AddAuthorization();
28. // 添加 JWT 服务
29. builder.Services.AddScoped<JwtService>();
31. // 添加 Identity 服务（如果需要）
32. builder.Services.AddIdentityCore<ApplicationUser>(options =>
33. {
34.     options.Password.RequireDigit = false;
35.     options.Password.RequireLowercase = false;
36.     options.Password.RequireNonAlphanumeric = false;
37.     options.Password.RequireUppercase = false;
38.     options.Password.RequiredLength = 6;
39.     options.SignIn.RequireConfirmedEmail = false;
40. }).AddRoles<IdentityRole<Guid>>()
41.     .AddEntityFrameworkStores<ApplicationDbContext>()
42.     .AddDefaultTokenProviders()
43.     .AddRoleManager<RoleManager<IdentityRole<Guid>>>()
44.     .AddUserManager<UserManager<ApplicationUser>>();
46. var app = builder.Build();
48. app.UseAuthentication();
49. app.UseAuthorization();

复制代码

appsettings.json

1.   "JwtSettings": {
2.     "SecretKey": "your-very-looong-secret-key-here",
3.     "Issuer": "your-issuer",
4.     "Audience": "your-audience"
5.   }

复制代码

JwtService

1. public class JwtService(IConfiguration configuration)
2. {
3.     public AccessTokenResponse GenerateTokens(ApplicationUser user, IList<string> roles)
4.     {
5.         // 生成访问令牌
6.         var accessToken = GenerateAccessToken(user, roles);
8.         // 生成刷新令牌
9.         var refreshToken = GenerateRefreshToken();
11.         // 计算过期时间（以秒为单位）
12.         var expiresIn = Convert.ToInt32(TimeSpan.FromHours(1).TotalSeconds);
14.         return new AccessTokenResponse(accessToken, expiresIn, refreshToken);
15.     }
17.     private string GenerateAccessToken(ApplicationUser user, IList<string> roles)
18.     {
19.         var secretKey = Encoding.UTF8.GetBytes(configuration["JwtSettings:SecretKey"]!);
20.         var signingCredentials = new SigningCredentials(
21.             new SymmetricSecurityKey(secretKey),
22.             SecurityAlgorithms.HmacSha256Signature
23.         );
25.         var claims = new List<Claim>
26.     {
27.         new(ClaimTypes.NameIdentifier, user.Id.ToString()),
28.         new(ClaimTypes.Name, user.UserName!)
29.     };
31.         claims.AddRange(roles.Select(role => new Claim(ClaimTypes.Role, role)));
33.         var token = new JwtSecurityToken(
34.             issuer: configuration["JwtSettings:Issuer"],
35.             audience: configuration["JwtSettings:Audience"],
36.             claims: claims,
37.             expires: DateTime.UtcNow.AddHours(1),
38.             signingCredentials: signingCredentials
39.         );
41.         return new JwtSecurityTokenHandler().WriteToken(token);
42.     }
44.     private string GenerateRefreshToken()
45.     {
46.         var randomNumber = new byte[64];
47.         using var rng = RandomNumberGenerator.Create();
48.         rng.GetBytes(randomNumber);
49.         return Convert.ToBase64String(randomNumber);
50.     }
52.     public ClaimsPrincipal? GetPrincipalFromExpiredToken(string token)
53.     {
54.         var secretKey = configuration["JwtSettings:SecretKey"]!;
56.         var tokenValidationParameters = new TokenValidationParameters
57.         {
58.             ValidateIssuer = true,
59.             ValidateAudience = true,
60.             ValidateLifetime = false, // 不验证过期时间
61.             ValidateIssuerSigningKey = true,
62.             ValidIssuer = configuration["JwtSettings:Issuer"],
63.             ValidAudience = configuration["JwtSettings:Audience"],
64.             IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(secretKey))
65.         };
67.         var tokenHandler = new JwtSecurityTokenHandler();
68.         var principal = tokenHandler.ValidateToken(token, tokenValidationParameters, out SecurityToken securityToken);
70.         if (securityToken is not JwtSecurityToken jwtSecurityToken ||
71.             !jwtSecurityToken.Header.Alg.Equals(SecurityAlgorithms.HmacSha256Signature,
72.             StringComparison.InvariantCultureIgnoreCase))
73.         {
74.             return null;
75.         }
77.         return principal;
78.     }
79. }

复制代码

IdentityEndpoints

1.     public static void MapIdentityEndpoints(this IEndpointRouteBuilder routes)
2.     {
3.         var group = routes.MapGroup("/Account").WithTags("Account");
5.         group.MapPost("/Login", async (
6.         LoginRequest model,
7.         UserManager<ApplicationUser> userManager,
8.         JwtService jwtService) =>
9.         {
10.             var user = await userManager.FindByNameAsync(model.Username);
11.             if (user == null)
12.             {
13.                 return Results.Unauthorized();
14.             }
16.             var isPasswordValid = await userManager.CheckPasswordAsync(user, model.Password);
17.             if (!isPasswordValid)
18.             {
19.                 return Results.Unauthorized();
20.             }
22.             var roles = await userManager.GetRolesAsync(user);
23.             var tokenResponse = jwtService.GenerateTokens(user, roles);
25.             // 保存刷新令牌到用户记录
26.             user.RefreshToken = tokenResponse.RefreshToken;
27.             user.RefreshTokenExpiryTime = DateTime.UtcNow.AddDays(7); // 刷新令牌7天有效
28.             await userManager.UpdateAsync(user);
30.             return Results.Ok(tokenResponse);
31.         })
32.         .AllowAnonymous()
33.         .WithName("Login")
34.         .WithOpenApi();
36.         group.MapGet("/User", (HttpContext context) =>
37.         {
38.             var user = context.User;
39.             return Results.Ok(new
40.             {
41.                 Username = user.Identity?.Name,
42.                 UserId = user.FindFirst(ClaimTypes.NameIdentifier)?.Value,
43.                 Roles = user.Claims
44.                     .Where(c => c.Type == ClaimTypes.Role)
45.                     .Select(c => c.Value)
46.                     .ToList()
47.             });
48.         })
49.         .RequireAuthorization()
50.         .WithName("User")
51.         .WithOpenApi();
53.         group.MapPost("/Refresh", async (
54.                       RefreshTokenModel model,
55.                       UserManager<ApplicationUser> userManager,
56.                       JwtService jwtService,
57.                       HttpContext context) =>
58.         {
59.             // 从请求头获取过期的访问令牌
60.             string? accessToken = context.Request.Headers["Authorization"]
61.                 .FirstOrDefault()?.Split(" ").Last();
63.             if (string.IsNullOrEmpty(accessToken))
64.             {
65.                 return Results.BadRequest("Access token is required");
66.             }
68.             // 从过期的访问令牌中获取用户信息
69.             var principal = jwtService.GetPrincipalFromExpiredToken(accessToken);
70.             if (principal == null)
71.             {
72.                 return Results.BadRequest("Invalid access token");
73.             }
75.             var username = principal.Identity?.Name;
76.             var user = await userManager.FindByNameAsync(username!);
78.             if (user == null ||
79.                 user.RefreshToken != model.RefreshToken ||
80.                 user.RefreshTokenExpiryTime <= DateTime.UtcNow)
81.             {
82.                 return Results.BadRequest("Invalid refresh token");
83.             }
85.             // 生成新的令牌
86.             var roles = await userManager.GetRolesAsync(user);
87.             var newTokenResponse = jwtService.GenerateTokens(user, roles);
89.             // 更新数据库中的刷新令牌
90.             user.RefreshToken = newTokenResponse.RefreshToken;
91.             user.RefreshTokenExpiryTime = DateTime.UtcNow.AddDays(7);
92.             await userManager.UpdateAsync(user);
94.             return Results.Ok(newTokenResponse);
95.         })
96.         .AllowAnonymous()
97.         .WithName("Refresh")
98.         .WithOpenApi(); ;
99.         group.MapPost("/Logout", async (
100.                       UserManager<ApplicationUser> userManager,
101.                       HttpContext context) =>
102.          {
103.              var user = context.User;
104.              var appUser = await userManager.FindByNameAsync(user.Identity?.Name!);
105.              if (appUser == null)
106.              {
107.                  return Results.NotFound();
108.              }
110.              // 清除刷新令牌
111.              appUser.RefreshToken = null;
112.              appUser.RefreshTokenExpiryTime = null;
113.              await userManager.UpdateAsync(appUser);
115.              return Results.Ok();
116.          })
117.         .RequireAuthorization()
118.         .WithName("Logout")
119.         .WithOpenApi();
120.         group.MapPost("/Register", async (
121.                       RegisterModel model,
122.                       UserManager<ApplicationUser> userManager,
123.                       JwtService jwtService) =>
124.         {
125.             // 验证模型
126.             if (model.Password != model.ConfirmPassword)
127.             {
128.                 return Results.BadRequest(new RegisterResponse(
129.                     false,
130.                     ["密码和确认密码不匹配"], null, null
131.                 ));
132.             }
134.             // 检查用户名是否已存在
135.             var existingUser = await userManager.FindByNameAsync(model.Username);
136.             if (existingUser != null)
137.             {
138.                 return Results.BadRequest(new RegisterResponse(
139.                     false,
140.                     ["用户名已存在"], null, null
141.                 ));
142.             }
144.             // 检查邮箱是否已存在
145.             var existingEmail = await userManager.FindByEmailAsync(model.Email);
146.             if (existingEmail != null)
147.             {
148.                 return Results.BadRequest(new RegisterResponse(
149.                     false,
150.                     ["邮箱已被使用"], null, null
151.                 ));
152.             }
154.             // 创建新用户
155.             var user = new ApplicationUser
156.             {
157.                 UserName = model.Username,
158.                 Email = model.Email,
159.                 EmailConfirmed = true // 如果需要邮箱验证，设置为 false
160.             };
162.             // 添加用户
163.             var result = await userManager.CreateAsync(user, model.Password);
165.             if (!result.Succeeded)
166.             {
167.                 return Results.BadRequest(new RegisterResponse(
168.                     false,
169.                     result.Errors.Select(e => e.Description), null, null
170.                 ));
171.             }
173.             // 添加默认角色
174.             // await userManager.AddToRoleAsync(user, "User");
176.             // 生成令牌
177.             var roles = await userManager.GetRolesAsync(user);
178.             var tokenResponse = jwtService.GenerateTokens(user, roles);
180.             // 保存刷新令牌
181.             user.RefreshToken = tokenResponse.RefreshToken;
182.             user.RefreshTokenExpiryTime = DateTime.UtcNow.AddDays(7);
183.             await userManager.UpdateAsync(user);
185.             // 返回成功响应和令牌
186.             return Results.Ok(new RegisterResponse(true, [], tokenResponse, "注册成功"));
187.         })
188.         .AllowAnonymous()
189.         .WithName("Register")
190.         .WithOpenApi();
191.     }

复制代码

前端只需要修改上一案例中的ParseTokenAsync方法

1.         private async Task ParseTokenAsync()
2.         {
3.             var handler = new JwtSecurityTokenHandler();
4.             var token = handler.ReadJwtToken(access_token);
5.             CachedUser = new ClaimsPrincipal(new ClaimsIdentity(token.Claims, "Bearer"));
6.         }

复制代码

结语

详细案例文章、视频、源码请等候后续发布

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。