如何诊断Microsoft Identity身份验证失败问题?
核心问题根因
你遇到的身份验证失败由两个明确的配置不匹配导致,优先处理受众验证错误即可解决绝大多数场景问题:
- IDX10214错误是JWT受众不匹配:前端请求到的访问令牌中
aud声明为Web API的应用ID242e8f40-d795-43bc-8ac8-8eed3df71745,但Web API的JWT验证配置中设置的ValidAudience为不匹配的客户端IDb99e89fc-8a1c-4605-8c18-796d7064037e,导致验证不通过。 - IDX10511错误是签名验证失败,由于默认隐藏了PII信息无法看到具体失败原因,需先开启PII显示再排查。
具体解决步骤
1. 开启PII显示(仅测试环境使用,不要在生产环境配置)
在ASP.NET Core Web API的Startup.cs的ConfigureServices方法中添加配置,开启身份验证相关的PII信息显示,方便查看完整错误详情:
public void ConfigureServices(IServiceCollection services) { IdentityModelEventSource.ShowPII = true; // 其余服务配置保持不变 }
2. 修正Web API的JWT受众验证配置
二选一即可:
- 方案A:直接将
ValidAudience修改为令牌中实际的aud值
services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme) .AddJwtBearer(options => { options.Authority = "https://login.microsoftonline.com/<你的Azure AD租户ID>"; options.TokenValidationParameters.ValidAudience = "242e8f40-d795-43bc-8ac8-8eed3df71745"; });
- 方案B:配置多受众列表,兼容多场景验证需求
services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme) .AddJwtBearer(options => { options.Authority = "https://login.microsoftonline.com/<你的Azure AD租户ID>"; options.TokenValidationParameters.ValidAudiences = new List<string> { "242e8f40-d795-43bc-8ac8-8eed3df71745", "b99e89fc-8a1c-4605-8c18-796d7064037e", "api://242e8f40-d795-43bc-8ac8-8eed3df71745" }; });
3. 排查签名验证失败问题
如果修正受众配置后仍存在IDX10511错误,按以下两点检查:
- 确认Web API配置的
Authority地址和前端MSAL配置的Authority地址完全一致,均为测试环境对应的Azure AD租户地址,没有误填集成环境的配置 - 确认Web API的JWT验证配置没有手动设置
IssuerSigningKey,默认情况下中间件会自动从Azure AD元数据拉取签名公钥,手动配置错误的签名密钥会导致验证失败
4. 通用身份验证排查方法
后续遇到类似验证问题时,可先将前端获取的访问令牌复制到本地JWT解析工具中,查看aud、iss、scp等核心声明是否符合预期,再对照Web API的验证配置逐一排查不匹配项即可快速定位问题。
内容的提问来源于stack exchange,提问作者Jesús López
相关产品推荐
相关产品推荐

