You need to enable JavaScript to run this app. 如何诊断Microsoft Identity身份验证失败问题?
优惠活动
大模型
产品
解决方案
定价
更多

如何诊断Microsoft Identity身份验证失败问题?

核心问题根因

你遇到的身份验证失败由两个明确的配置不匹配导致,优先处理受众验证错误即可解决绝大多数场景问题:

  1. IDX10214错误是JWT受众不匹配:前端请求到的访问令牌中aud声明为Web API的应用ID 242e8f40-d795-43bc-8ac8-8eed3df71745,但Web API的JWT验证配置中设置的ValidAudience为不匹配的客户端ID b99e89fc-8a1c-4605-8c18-796d7064037e,导致验证不通过。
  2. 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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.21 20:15:01