You need to enable JavaScript to run this app. Blazor Web Assembly解析JWT时ClaimTypes.Name变为unique_name原因问询
优惠活动
大模型
产品
解决方案
定价
更多

Blazor Web Assembly解析JWT时ClaimTypes.Name变为unique_name原因问询

JWT声明类型从ClaimTypes.Name变为unique_name的原因

核心原因:微软JWT处理库的默认声明映射机制

  • 你使用的System.IdentityModel.Tokens.Jwt库(.NET生态生成、解析JWT的官方默认库)为了兼容旧版.NET身份体系与OpenID Connect标准,预设了声明类型双向映射规则:
    • .NET内置的ClaimTypes.Name对应的完整URI为 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name,默认会被映射为JWT Payload中的短名称unique_name
  • 这个转换发生在服务端生成JWT的阶段,并非Blazor WASM解析时才修改:你可以把生成的JWT复制到解码工具中查看,Payload里存储的键本身就已经是unique_name,Blazor端只是读取了原始JWT的内容
  • 如果Blazor端使用默认配置解析JWT,遍历ClaimsPrincipal.Claims集合时,unique_name会被反向映射回ClaimTypes.Name类型,只有直接读取JWT原始Payload时才会看到unique_name字段

可选修改方案

如果需要保留原始声明类型、关闭自动映射,可以在服务端生成JWT、以及Blazor端初始化身份验证的逻辑中添加如下代码:

// 清除入站、出站的默认声明类型映射
JwtSecurityTokenHandler.DefaultInboundClaimTypeMap.Clear();
JwtSecurityTokenHandler.DefaultOutboundClaimTypeMap.Clear();

配置后JWT中存储的声明键会和你代码中声明的Claim.Type完全一致,不会自动转换。


内容的提问来源于stack exchange,提问作者Arash Nsi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.11 13:42:01