EWS API 弃用常见问题解答
- Updated: 2025/04/18
Microsoft 宣布用于连接到 Exchange Online 的 EWS API 的生命周期终止。 此弃用可能会改变使用 EWS 选项的自动化 (bots),包括 Email package 或 Email 触发器。 查看常见问题解答,获取有关 EWS API 弃用的详细信息。
- EWS API 弃用是什么?
- 自 2022 年 3 月 31 日起,Microsoft 已弃用 25 个使用率最低的 EWS API。 这是一项持续性的弃用工作,当相应的 Graph API 可用时,Microsoft 将继续弃用其他 EWS API。
要了解有关 EWS API 弃用的更多信息,请参阅 Upcoming API Deprecations in Exchange Web Services for Exchange Online。
- 为什么会有此改变?
- EWS 是一个旧版 API,安全性较低,无法满足现代应用程序开发的安全性和可管理性需求。 根据 Microsoft 的要求,如果客户端或应用程序使用 EWS API 通过 Exchange Online 连接到 Exchange 服务器,则需要将基于 SOAP 的 EWS API 切换为基于 REST 的 Graph API。Microsoft Graph 相较于 EWS 具有以下优势:
- 安全性: 与 EWS 中的 全部或无访问模式相比,Microsoft Graph 更为安全,具有更严格的 OAuth 治理策略,并能限制邮箱中的数据访问。
- 简洁: Microsoft Graph 提供用于轻松快速地发现和测试 API 的 Graph Explorer、不同编程语言的 SDK 以及活跃的开发人员社区。
- 效率: Microsoft Graph API 基于 REST,而 EWS API 基于 SOAP。 使用基于 REST 协议的优势包括更快的 JSON 序列化和更低的网络使用量。
注: EWS API 的弃用仅适用于 Exchange Online,不适用于本地版本的 Exchange。
- 这次弃用对我有什么影响?
- 目前,您不会受到影响,因为 Automation 360 没有使用任何被 Microsoft 弃用的 EWS API。 根据 Microsoft 的说法,未弃用的 EWS API 将继续支持在实际正式环境中使用,我们尚未确定这些 API 未来何时会被弃用的固定时间表。
如果将来用于 Automation 360 的特定 EWS API 被弃用,并且您使用 Email package 和 Email 触发器 actions 与 EWS 选项自动处理电子邮件,则由于与 Exchange Online 的连接失败,这些自动化将会中断。
- Automation 360 在哪里使用 EWS API?
- Automation 360 在 Email package 中使用 EWS API,并在 Email 中触发 EWS 选项,这使您能够连接到在 Azure 云上托管的 Exchange Online,并访问 Microsoft 365 的电子邮件。
- 如何识别使用 Email EWS 选项的受影响 bots?
- 您可以使用 Automation 360 Bot Scanner 实用工具扫描和识别使用 EWS 的受影响 bots。 请参阅 扫描机器人以进行基本身份验证。
- Automation 360 客户从 EWS API 切换到 Graph API 可以参考什么指导?
- 我们发布了一个新的 Microsoft 365 Outlook package,其中包含基于最新版本的 Graph API 的 Automation 360 v.29 版本。 您可以使用此 package 自动处理 Exchange Online 的 Outlook 电子邮件。 此 package 包含所有类似于 Email package 中提供的 actions。 您可以通过 EWS 选项从 EWS API 切换到 Graph API,使用 Microsoft 365 Outlook package 替代 Email package。
- 如何将现有的 bots 更新为 Microsoft 365 Outlook package?
- 要将您现有的受影响 bots 更新为 Microsoft 365 Outlook package,请参阅 Exchange Online 中 EWS API 的弃用。
- Automation Anywhere 是否会为 Automation 360 客户提供任何工具,以便将他们的 bots 从 EWS API 更新到 Graph API?
- 不。您必须手动更新受影响的 bots 以切换到 Graph API (Microsoft 365 Outlook package)。
- Email 和 Microsoft 365 Outlook packages 之间是否存在一对一映射,还是有任何差异?
-
Email
package 中的所有 actions 在 Microsoft 365 Outlook
package 中也包含。 但是,当您使用新的 Microsoft 365 Outlook
package 构建机器人时,必须考虑以下差异:
- 在 Email package 中,发送、转发、回复和全部回复 actions具有连接参数,因此当您创建自动化时,可以独立于连接 action使用这些 actions。 但是,在 Microsoft 365 Outlook package 的情况下,您必须在每个 actions 之前使用连接 action 操作,因为它们指的是由连接 action 创建的会话,请参见 Microsoft 365 Outlook package。
- 新的 Microsoft 365 Outlook
package 支持两种身份验证模式: 使用 PKCE 和客户端凭据的授权码。 带有 EWS 选项的 Email
package 支持四种身份验证模式: ROPC、隐式、带有 PKCE 的授权码和客户端凭据。注: ROPC 和隐式身份验证模式已弃用,因此在 Microsoft 365 Outlook package 中不受支持。 您必须使用更安全的授权码,使用 PKCE 流程进行有人值守的自动化,使用客户凭据流程进行无人值守的自动化。