---
title: 避免用邮件声明做用户身份识别与授权：应用认证行为配置指南
description: 企业应用不应以邮件声明作为用户身份识别或授权依据，否则可能因未验证域名所有者而遭受账号与权限提升攻击。本文面向 IT 运维，说明适用场景、准备与风险、通过 authenticationBehaviors 配置 removeUnverifiedEmailClaim 的处理步骤、验证方法、回退建议及常见问题。
url: "https://www.lanever.com/docs/%e9%81%bf%e5%85%8d%e7%94%a8%e9%82%ae%e4%bb%b6%e5%a3%b0%e6%98%8e%e5%81%9a%e7%94%a8%e6%88%b7%e8%ba%ab%e4%bb%bd%e8%af%86%e5%88%ab%e4%b8%8e%e6%8e%88%e6%9d%83%ef%bc%9a%e5%ba%94%e7%94%a8%e8%ae%a4%e8%af%81/"
updated: "2026-10-12"
category: Office365
---

# 避免用邮件声明做用户身份识别与授权：应用认证行为配置指南

> **参考来源与致谢**
>
>
>
> - **引用来源：**[Manage application authenticationBehaviors to avoid unverified use of email claims for user identification or authorization - Microsoft Graph](https://learn.microsoft.com/en-us/graph/applications-authenticationbehaviors?tabs=http)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

当企业应用（尤其是多租户应用）使用令牌中的邮件声明（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 版本支持该属性。
- **能否只改部分应用？** 可以，按应用对象逐个配置。
- **是否影响现有令牌？** 行为变更影响后续签发的令牌，已签发令牌到期前可能仍有效。

> 提示：涉及生产环境变更前，务必完成备份与测试验证；不确定的版本支持与默认行为，请查阅对应版本官方文档。
