旧 EAT 认证已不再受支持：应迁移到 Microsoft Entra ID 令牌认证，并在获授权的 Microsoft 365 测试范围内分别验收收件、卡片显示、令牌校验和动作结果。只有测试地址收到邮件，不能证明卡片可用或服务端认证安全。
负责迁移旧 Actionable Messages 集成的开发者，可按下文验证新链路。
QA 工程师可用阶段记录区分“邮件收到”“卡片显示”和“操作成功”。
维护 Microsoft 365 测试环境的团队，可据此规划获授权的测试收件人和发布复核。
最后更新于 2026 年 10 月 25 日；认证状态与配置依据 Microsoft Entra ID 令牌迁移说明、Actionable Messages Developer Dashboard 指南及相关安全、客户端文档核实。Microsoft 确认迁移于 2026 年 6 月 8 日完成，旧认证不再受支持。
迁移起点：先确认认证类型，不要把三类故障混在一起
在改配置前，先检查集成使用的认证类型。Microsoft 的迁移说明指出，未更新为 Entra ID 令牌认证的集成不再工作；在 Dashboard 中核对现有提供方认证类型，并记录应用注册、动作 URL、发件身份和服务端令牌验证逻辑。需要迁移时，可创建新的提供方注册用于端到端验证，而不是把旧 EAT 当作可随时回退的选项。
随后把问题拆成三条独立记录：
- 邮件未到：检查发送日志、退信、收件地址和邮件投递链路。
- 邮件已到但卡片不显示：检查测试用户资格、提供方注册、发件身份、卡片内容及客户端支持。
- 按钮触发但操作失败：检查请求是否抵达动作端点、令牌校验结果、权限判断和业务响应。
这三类现象可能同时出现，但原因不同。把它们都标成“认证失败”，会让团队在错误的环节反复改配置。
第一阶段：为新认证建立可回退的测试基线
迁移前保存当前可运行版本的配置快照，至少包括提供方注册标识、动作 URL、发件地址、卡片版本、令牌校验配置和相关部署版本。标记哪些组件由团队控制，哪些依赖 Microsoft 365 管理员审批或平台支持。旧 EAT 不能作为迁移后的回退方案；真正可回退的是最近一个已验证的 Entra 代码与配置版本。
测试应在隔离环境进行，使用获授权且符合当前注册范围的 Microsoft 365 测试收件人。不要把临时邮箱、个人邮箱或共享邮箱自行假设为合格的组织测试用户。Dashboard 对 Test Users 范围要求填写组织内的 Microsoft 365 用户；组织范围和全局范围则各有审批与授权要求。范围决定谁能验证卡片，不是一个可以随意替换的邮箱地址字段。
注意： 收件箱用于观察邮件是否抵达；Microsoft 365 测试用户范围决定卡片功能是否对该收件人启用。两者不是同一资格。
第二阶段：注册应用并配置 Entra 令牌认证
按官方迁移流程，在 Microsoft Entra 管理中心检查或创建应用注册。测试和组织范围通常使用单租户应用；全局范围对应多租户应用。再在提供方注册中填写应用标识与生成的 AppIdUri，按要求公开 API、配置所需范围，并预授权 Actions 应用。不要把测试租户、应用标识或权限复制到生产配置后就默认所有租户都已获授权。
审批范围也要分开处理：Test Users 自助注册可用于指定测试用户；Organization 范围需经过组织管理员审核；Global 范围还涉及跨租户适用的管理员同意和 Microsoft 审批。获批后的注册可能需要等待生效；官方说明最长可能需要 24 小时。在等待窗口内反复重建注册或更改认证类型，会增加排查变量。
| 验收对象 | 测试前核对 | 通过时应留下的证据 |
|---|---|---|
| 注册范围 | Test Users、Organization 或 Global；收件人确实属于范围 | Dashboard 状态、审批记录、测试用户清单 |
| 应用与权限 | 租户、应用标识、AppIdUri、API 范围及 Actions 预授权 |
配置版本、授权状态、部署记录 |
| 动作端点 | URL 与注册信息一致，使用 HTTPS，环境指向自家测试服务 | 请求日志、令牌校验结果、业务响应 |
| 邮件与卡片 | 发件身份、收件人、客户端及卡片内容 | 原始测试邮件、到达记录、客户端截图 |
第三阶段：先验证端点，再测试按钮
在服务端为合法与拒绝请求准备彼此独立的用例。至少覆盖：合法令牌且业务允许、令牌签名或有效性不通过、受众或权限不匹配、业务规则拒绝。服务端应按 Entra 应用配置验证收到的令牌，不能只解码 JWT 并读取字段，也不能因为请求来自按钮就默认可信。实现时应依照所用应用注册和 API 配置核对签名、有效期、受众及授权范围；可参照 Microsoft 的 访问令牌验证说明。
每个用例要能回答两件事：认证层是否接受或拒绝了请求？业务层是否只在认证和授权都通过后执行预期操作？将拒绝原因写入不含令牌秘密的服务端日志，并保存请求关联标识。不要把完整承载令牌写进普通日志或测试报告。
旧认证文档中出现的令牌字段与新 Entra 流程不能混为一谈。迁移后应以 Entra 专用配置和对应验证流程为准；若现有端点还使用其他 Authorization 机制，也要检查请求头冲突，并在测试中确认动作请求确实走到了预期的认证中间件。
经验提示： 按钮出现、浏览器或客户端发出请求、端点返回 HTTP 响应，分别是呈现、传输和服务端处理的证据。只有令牌验证与业务断言都通过，才能记为操作验收通过。
第四阶段：发测试邮件，分层检查显示与收件
使用当前注册范围内的测试用户，直接向其发送自家服务产生的邮件。不要转发旧样本来代替新邮件；转发可能改变卡片标记。每次测试记录客户端名称与版本、发件时间、到达时间、是否退信、卡片是否显示、按钮是否可操作、端点响应和服务端令牌判定。没有真实测得的到达耗时，就留空或标为未测，不要用估算值填报。
邮件已收到但卡片未显示时，先核查收件人范围和注册状态，再检查发件身份及卡片结构。之后对比支持的客户端：Microsoft 当前列出网页版、部分 Microsoft 365 桌面通道和移动客户端等支持情况；例如，移动浏览器中的 Outlook 网页版不支持 Actionable Messages，Windows 桌面端的邮件下载设置也可能影响呈现。不能因为某个客户端失败就推断所有收件人都失败。
还要把“收到邮件”与“邮件通过发件验证”分开。官方安全说明要求为 Actionable Messages 邮件启用发件验证；具体方案应按发送场景核对 SPF、DKIM 或签名卡片要求。服务端动作令牌验证是另一条安全边界，不能由收件箱截图代替。(Microsoft 的 Actionable Messages 安全要求)
按结果选择下一步：通过、等待，还是暂停
- 若测试用户已获准、Entra 令牌校验通过，且动作端点返回预期业务结果，则扩大到下一批获批用户，并保留同一套证据字段。
- 若注册刚获批但仍未生效，且官方等待窗口尚未结束，则保持配置不变，等待后再按同一收件人和样本复测。
- 若邮件可达但卡片不显示，则回查注册范围、发件验证、卡片内容与客户端支持；先不要改动令牌业务逻辑。
- 若按钮请求到达但令牌无效或权限不符，则暂停扩大范围，修复服务端验证；不得以隐藏错误或放宽授权作为临时验收。
- 若关键账户找回、长期通知或安全审核依赖该邮件地址，则使用组织控制的稳定测试邮箱，不以短时收件地址替代。
灰度发布前再核对权限、发件身份和动作 URL 与登记内容一致。保存配置版本、原始测试邮件、客户端结果、端点验证日志和审批记录。它们能证明特定测试条件下的链路结果，不等于对所有 Microsoft 365 收件人的可用性或生产送达作出保证。若测试邮件本身迟迟未到，可参照测试邮件到达排查指南检查收件证据；如需区分短期收件与长期地址方案，可查看收件箱使用指南。
结尾：短时收件只能作旁证，不能替代组织测试账号
如果需要观察一封测试邮件是否抵达，BoxTmp 可作为自家服务测试中的短时收件辅助：页面提供可直接使用的临时收件地址和收件箱。它只能帮助记录邮件抵达这一环，不能赋予 Microsoft 365 测试用户资格，也不能证明 Entra 令牌或动作端点通过验证。需要执行上述认证验收时，仍应使用组织授权的测试邮箱；若只是临时注册、试用或收一次验证码，可从 BoxTmp 临时收件页面开始，避免把主邮箱暴露给短期任务。
常见问题
旧 EAT 集成现在应该从哪里开始调整？
先在 Actionable Message Developer Dashboard 核实提供方当前认证类型，再盘点应用注册、动作 URL 和令牌处理逻辑。EAT 已不再受支持；不要只改邮件模板或继续用旧令牌测试。先建立独立的 Entra 认证提供方，在受控环境验证通过后再逐步切换流量。
怎样确认测试用户范围里的 Entra 令牌链路有效？
使用符合组织要求的 Microsoft 365 测试邮箱，并确认它已列入 Test Users 范围。检查应用注册、API 标识和所需权限，再用迁移后的提供方发送自家服务邮件。最终要同时通过服务端令牌验证与动作结果检查；临时收件地址不能代替组织测试用户资格。
邮件已经收到，卡片却没有出现时该查什么？
先核对收件人是否属于当前获准范围、提供方注册是否已生效，以及发件身份和卡片标记是否符合要求。再确认所用 Outlook 客户端支持 Actionable Messages，并检查客户端的下载设置；桌面端与网页版表现不同时，先排除客户端支持和邮件处理差异，不要直接判定为收件地址故障。
按钮发出请求就能说明服务端认证成功吗？
不能。按钮可见只说明客户端呈现了卡片，请求到达也只说明网络路径已触发。服务端仍须按当前 Entra 配置验证令牌的签名、有效性、受众和适用权限，并单独验证业务授权与操作结果；无效令牌或权限不足的请求不得执行实际业务操作。