ASP.NET 5 集成Azure ADFS认证:声明变更与OpenIdConnectScheme选用疑问
核心问题答复
- 基于Microsoft.Identity.Web的ASP.NET Core应用对接Azure AD/AD FS的交互式登录场景,
OpenIdConnectDefaults.AuthenticationScheme是框架内置的OpenID Connect认证方案常量,属于官方推荐技术栈的组成部分,但绝大多数场景下你根本不需要手动硬编码指定它作为默认方案。 - 旧代码里传入
AzureADDefaults.AuthenticationScheme的写法,本质是已废弃的Microsoft.AspNetCore.Authentication.AzureAD.UI包提供的顶层默认方案标识——这个方案内部就是靠串联OpenIdConnect和Cookie两个子方案实现的登录流程。切换到新的Microsoft.Identity.Web体系后,框架会自动完成整套方案的串联配置,完全不需要你手动显式指定OpenIdConnect的方案名。你新建的VS模板项目里没有出现手动指定OpenIdConnect方案的代码,就是这个原因。
Claim取值异常的根因
- 旧版
AzureAD.UI包内部默认开启了入站声明映射逻辑:会把OpenID Connect协议返回的upn、preferred_username等短格式标准声明,自动映射为.NET框架惯用的长格式ClaimTypes.Upn(即http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn),因此你之前用identity.FindFirst(ClaimTypes.Upn)能正常取到邮箱对应的UPN值。 - 切换到Microsoft.Identity.Web后,为了贴合OpenID Connect的标准声明规范,框架默认关闭了这套强制映射逻辑,会直接把令牌中携带的原始声明透传给
ClaimsIdentity对象。之前映射后生成的长格式ClaimTypes.Upn自然不会出现,调用查找方法时就返回了null。 - 你当前临时使用的
preferred_username是OpenID Connect协议定义的标准声明,返回的值本身是准确的,但确实不建议在代码里硬编码这类字符串。Microsoft.Identity.Web内置了Microsoft.Identity.Web.Constants.Claims常量类,已经预定义了所有常用标准声明的字符串值,直接引用即可从根源上避免魔法字符串问题。
官方推荐的实践规范
- 配置认证时不需要手动在
AddAuthentication方法里硬编码指定OpenIdConnectDefaults.AuthenticationScheme:直接调用Microsoft.Identity.Web提供的AddMicrosoftIdentityWebApp(Configuration, configSectionName: "AzureAd")扩展方法即可,该方法内部会自动完成:- 把OpenIdConnect设为默认认证方案
- 自动配置Cookie登录方案
- 自动处理令牌刷新、增量同意、权限校验等通用逻辑
- 如果需要在特定场景下显式指定认证方案(比如给单个Action配置
[Authorize]特性),直接引用框架内置的常量即可,不要手写方案名字符串,示例:[Authorize(AuthenticationSchemes = OpenIdConnectDefaults.AuthenticationScheme)] public IActionResult SecureEndpoint() { return View(); } - 如果你不想修改全项目中原本依赖
ClaimTypes.Upn取值的旧代码,可以在OpenIdConnect配置中开启兼容映射模式,让行为和旧版AzureAD.UI完全一致:services.AddAuthentication() .AddMicrosoftIdentityWebApp(Configuration, configSectionName: "AzureAd") .WithOpenIdConnect(options => { // 开启入站声明映射,将短格式标准声明映射回.NET惯用的长格式ClaimTypes options.MapInboundClaims = true; });
常见误区澄清
- 不存在“必须手动指定OpenIdConnectDefaults.AuthenticationScheme才算完成合规集成”的要求:这个常量的作用只是帮你避免硬编码方案名字符串,新的项目模板和扩展方法已经默认帮你把它设为了应用的默认认证方案。
- 如果对接的是本地AD FS服务(而非Azure AD云租户),只要AD FS开启了OpenID Connect端点,Microsoft.Identity.Web就完全兼容:返回的
preferred_username声明本质上就对应AD FS中配置的用户UPN属性,和之前的取值逻辑没有本质差异,只是声明的展示格式从映射后的长字符串变回了协议原生的短名称。
内容的提问来源于stack exchange,提问作者DrGriff
相关产品推荐
相关产品推荐

