用途:在 Blazor 应用中实现认证与授权流程,覆盖 Server、WASM、Auto、SSR、Hybrid 各托管模型。
主要能力:按托管模型处理认证差异(Cookie 与 Token);使用 AuthorizeView 与 CascadingAuthenticationState;基于角色和策略的授权;Identity UI 脚手架与自定义;客户端 Token 处理与外部身份提供程序;实现明确的登录、退出与认证 UI。
使用方式:注册认证与授权服务(如 AddAuthentication、AddCascadingAuthenticationState、AddAuthorization);WASM 可用 AddOidcAuthentication 并借助 AuthorizationMessageHandler 附加 Token;登录/退出页面需使用 Static SSR 渲染模式以便 SignInManager 访问 HttpContext;可用 dotnet aspnet-codegenerator identity 脚手架 Identity 页面。
适用场景:需要为 Blazor 添加登录、退出、角色/策略控制或外部登录时。
限制与注意:交互式组件中不可访问 HttpContext,应使用 AuthenticationStateProvider;WASM 跨源 API 不宜依赖 Cookie;勿在 localStorage 无 XSS 防护地存储 Token;勿混用 AddIdentity 与 AddDefaultIdentity;需 .NET 8.0+。JWT 生成与校验、OWASP 加固、bUnit 与 E2E 测试、UI 框架选择不在本技能范围内。