参考来源与致谢
- 引用来源:Manage application authenticationBehaviors to avoid unverified use of email claims for user identification or authorization – Microsoft Graph
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
当企业应用(尤其是多租户应用)使用令牌中的邮件声明(email claim)作为用户身份识别或授权依据时,若该邮件地址所属域名未经验证,攻击者可能通过修改用户对象的 mail 属性实现账号冒用或权限提升。以下场景风险尤为突出:
- 用户对象的
mail属性包含未验证域名所有者的邮件地址。 - 多租户应用中,某租户用户通过修改
mail属性越权访问另一租户资源。
本文适用于需要迁移 away from 邮件声明、改用更可靠标识(如对象 ID)的企业 IT 运维人员。
准备与风险 #
- 备份:修改前导出应用对象当前配置,记录
authenticationBehaviors现有值。 - 测试环境:先在非生产租户或测试应用验证行为变更,确认下游依赖不受影响。
- 回退提醒:保留原始配置,确保可恢复默认行为。
- 版本提示:
authenticationBehaviors属性可能仅在特定 API 版本(如 beta)可用,具体支持范围请查阅对应版本官方文档。 - 权限:执行配置需具备应用管理权限,使用最小权限账号操作。
处理步骤 #
1. 读取当前认证行为 #
查询单个应用的 authenticationBehaviors 属性(需使用 $select):
GET [外部链接已移除]
也可用 appId 查询:
GET [外部链接已移除]'[应用ID]')/authenticationBehaviors
2. 移除未验证域名的邮件声明 #
将 removeUnverifiedEmailClaim 设为 true,阻止签发含未验证域名所有者的邮件声明:
PATCH [外部链接已移除]
Content-Type: application/json
{
"removeUnverifiedEmailClaim": true
}
成功返回 204 No Content。
3. 如需保留(不推荐) #
若业务确需接受未验证邮件声明,可设为 false,但应评估风险并改用其他标识做授权。
PATCH [外部链接已移除]
Content-Type: application/json
{
"removeUnverifiedEmailClaim": false
}
4. 恢复默认行为 #
PATCH [外部链接已移除]
Content-Type: application/json
{
"removeUnverifiedEmailClaim": null
}
验证方法 #
- 重新获取令牌,检查声明中是否仍包含未验证域名的邮件地址。
- 确认应用授权逻辑不再依赖邮件声明,改用对象 ID 等稳定标识。
- 在测试租户模拟多租户越权场景,验证行为生效。
回退建议 #
- 若变更导致登录或授权异常,立即将
removeUnverifiedEmailClaim恢复为null或原值。 - 回退后复核应用日志与用户反馈,定位依赖邮件声明的代码路径。
- 长期方案:迁移至基于对象 ID 的识别与授权模型。
常见问题 #
- 默认行为是什么? 默认会移除未验证域名所有者的邮件声明,但单租户应用及有历史登录活动的多租户应用可能例外,具体以官方文档为准。
- 属性读不到? 确认使用
$select且 API 版本支持该属性。 - 能否只改部分应用? 可以,按应用对象逐个配置。
- 是否影响现有令牌? 行为变更影响后续签发的令牌,已签发令牌到期前可能仍有效。
提示:涉及生产环境变更前,务必完成备份与测试验证;不确定的版本支持与默认行为,请查阅对应版本官方文档。
