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
- .NET内置的
- 这个转换发生在服务端生成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
相关产品推荐
相关产品推荐

