配置电子邮件资产

概述

在 Control Hub 中使用数字资产来配置 Webex 服务用于电子邮件交互的邮箱和 OAuth 2.0 身份验证。您可以在 Control Hub 中管理资产，经批准的 Webex 工作负载通过共享数字资产服务访问该资产。

创建资产时，将其分配给将使用它的 Webex 服务。身份验证成功后，Control Hub 会为入站电子邮件生成转发地址。对于 Webex 联络中心，您可以随后将资产与电子邮件入口点关联起来。对于另一个 Webex 工作负载，请在创建资产后继续在该工作负载中进行设置。

准备工作

以正式管理员、客户管理员或合作伙伴管理员身份登录 Control Hub，他们可以为您的组织管理数字资产。
使用支持的电子邮件提供商。对于 Webex 联络中心与的集成Webex Connect，Gmail 和 Microsoft 365 是支持的提供商。有关提供商的特定详细信息，请参阅电子邮件- WXCC。
准备要配置的邮箱。如果您使用服务帐号，请确保它可以发送电子邮件和访问该邮箱。
与您的身份提供商管理员合作，注册 OAuth 应用程序，授予同意，并开启提供商设置，例如 SMTP AUTH 或外部转发。
准备好将回拨网址从 Control Hub 复制到 OAuth 应用程序的重定向 URL 中，并配置自动转发到为电子邮件资产生成的地址。

为 Gmail 准备 OAuth 2.0

要为电子邮件资产准备 Gmail 帐户，请执行以下操作：

1	登录 Google Cloud 控制台并创建项目或选择现有项目。
2	前往 API 和服务 > OAuth 同意屏幕，选择外部，然后输入应用程序名称、用户支持电子邮件和开发者联系信息。
3	如果应用程序仍处于测试状态，请将邮箱或令牌生成身份添加为测试用户。一个项目最多可以有 100 个测试用户。
4	前往 API 和服务 > 证书，为 Web 应用程序创建 OAuth 客户端 ID，然后复制客户端 ID 和客户端密钥。
5	当 Control Hub 显示回拨网址时，返回到 OAuth 客户端，并将该值添加为授权重定向 URI。
6	对于生产用途，请发布 OAuth 应用程序并完成所请求范围所需的所有 Google 验证。
7	记录控制中心配置的以下提供商值： SMTP 服务器：smtp.gmail.com 端口：587 授权网址：https://accounts.google.com/o/oauth2/v2/auth 范围：https://mail.google.com/ 访问令牌网址：https://oauth2.googleapis.com/token 刷新代币网址：https://oauth2.googleapis.com/token 对于处于测试阶段的外部 Google OAuth 应用程序，测试用户授权和刷新令牌将在同意后的七天后过期。发布应用程序以供生产使用。如果 Google 未返回刷新令牌，请再次运行同意流程并选择 “我想明确审核”，然后在该选项可用时提供身份验证同意。谷歌的 SMTP OAuth 文档解释了 Gmail SMTP OAuth 的范围。Google 的 OAuth 受众指南解释了内部和外部受众以及发布状态行为。

为 OAuth 2.0 做好微软 365 的准备

要为电子邮件资产准备 Microsoft 365 邮箱，请执行以下操作：

1	在 Microsoft Entra 管理中心中，转到应用程序注册，选择新注册，然后使用您的组织允许的帐户类型注册应用程序。
2	记录应用程序（客户端）ID 和目录（租户）ID。
3	在身份验证中，添加 Web 平台。当 Control Hub 显示回调 URL 时，将该值添加为重定向 URI。
4	在证书和密钥中，创建客户端密钥并在离开页面之前复制其值。
5	对于选择 “生成令牌” 时使用的交互式授权码流程，添加委托的 Office 365 Exchange Online Smtp.send 权限 (https://outlook.office.com/SMTP.Send) 并申请 offline_access 范围。如果贵组织的同意政策要求，请授予管理员同意。
6	在 Microsoft 365 管理中心中，转至 “用户” > “活跃用户”，选择邮箱用户，选择 “邮件” > “管理电子邮件应用程序”，为该邮箱启用 “经过身份验证的 SMTP”，然后保存您的更改。
7	记录以下提供商值。将 {tenant-id} 替换为应用程序注册中的目录（租户）ID： SMTP 服务器：smtp.office365.com 端口：587 授权网址：https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize 范围：offline_access https://outlook.office.com/SMTP.Send 访问令牌网址：https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token 刷新代币网址：https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token 使用委托的 https://outlook.office.com/SMTP.Send 范围和 offline_access 来实现这个交互式代币流。仅为需要 SMTP 身份验证的邮箱启用 SMTP 身份验证。如果你的组织最近更改了 Microsoft Entra 同意设置，请等待更改生效后再生成令牌。微软的 SMTP OAuth 指南涵盖了委托的 SMTP.Send 和 offline_access。微软的 SMTP 身份验证配置解释了如何为特定邮箱启用 SMTP 身份验证。

在 Control Hub 中配置电子邮件资产

要配置电子邮件资产，请执行以下操作：

1	登录到 Control Hub。
2	转至 “服务” > “数字资产”。
3	选择 “创建资产”。
4	在配置资产详细信息部分中，在以下字段中输入值：名称：输入资产的字母数字名称。不要使用空格或特殊字符。描述：可选。输入简短的描述，以帮助管理员识别资产。渠道：选择电子邮件。创建资产后，您无法更改分配的服务或渠道。分配给：选择将使用该资产的 Webex 服务。例如，如果联系中心将使用资产，请选择 Webex 联系中心。
5	在电子邮件提供商 > 邮箱中，输入资产使用的邮箱的电子邮件地址。
6	在 OAuth 2.0 身份验证部分中，在以下字段中输入值： SMTP 服务器：对于 Gmail，请输入 smtp.gmail.com。对于微软 365，请输入 smtp.office365.com。用户名：输入用于 SMTP 身份验证的邮箱或服务帐户电子邮件地址。端口：为 Gmail 或 Microsoft 365 输入 587。提供商连接使用 STARTTLS/TLS。客户端 ID：输入提供商的 OAuth 应用程序中的客户端 ID。客户端密钥：输入来自提供商的 OAuth 应用程序的客户端密钥值。授权网址：Gmail：https://accounts.google.com/o/oauth2/v2/auth；微软 365：https://login.microsoftonline.com/%7Btenant-id%7D/oauth2/v2.0/authorize。范围：Gmail：https://mail.google.com/；微软 365：offline_ access https://outlook.office.com/SMTP.Send。对于使用转发的入站邮件，您不需要邮箱读取权限。访问令牌网址：Gmail：https://oauth2.googleapis.com/token；微软 365：https://login.microsoftonline.com/%7Btenant-id%7D/oauth2/v2.0/token。刷新令牌 URL：使用为访问令牌 URL 输入的相同提供商 URL。回调 URL：复制此只读网址并将其作为重定向或回调 URI 添加到提供商的 OAuth 应用程序中。
7	在您的身份提供商中，将来自 Control Hub 的回调 URL 添加到 OAuth 应用程序，保存提供商配置，并确认重定向 URI 完全匹配。
8	如果授予同意的人使用与邮箱不同的电子邮件地址，请选择 “使用与邮箱地址不同的电子邮件地址生成令牌”，然后输入该身份。共享邮箱：共享邮箱没有自己的登录凭据。向可以访问共享邮箱并拥有 “代理发送” 权限的用户生成令牌；该用户不需要管理员访问权限。选择当用户的地址与邮箱地址不同时，使用与邮箱地址不同的电子邮件地址生成令牌。
9	选择生成令牌，完成身份提供商登录和同意流程，然后返回 Control Hub。令牌生成成功后，将自动填写访问令牌、刷新令牌和有效性字段。同意限制：如果您的提供商阻止用户同意，请先清除 “我想明确审查”，然后再提供身份验证许可。该选项可能导致身份验证失败，因为用户无法授予所请求的同意。改为要求提供商管理员授予所需的同意。如果令牌生成不起作用：对于 Gmail，请确保用户可以授权该应用程序，并且该应用程序的发布状态正确。对于微软 365，请检查 offline_access 范围、同意政策、重定向 URI 和 SMTP 身份验证设置。修复提供商配置，然后再次生成令牌。令牌续订：该服务会在令牌到期之前刷新令牌。如果租户所有者收到要求重新生成令牌的自动电子邮件，请打开资产并再次选择生成令牌。
10	代币生成成功后，选择创建。如果资产分配给 Webex 联系中心，请选择前往入口点并继续配置联系中心。对于另一个 Webex 工作负载，请关闭确认页面并继续在该工作负载中进行设置。

配置入站电子邮件转发

首先，复制为资产生成的转发地址：

1	在 “数字资产” 中，打开电子邮件资产并选择 “设置”。
2	在电子邮件提供商 > 邮箱中，复制与邮箱电子邮件地址关联的转发地址。

在 Gmail 中配置转发

要将收到的 Gmail 邮件转发到电子邮件资产，请执行以下操作：

1	如果您使用 Google Workspace，请确保管理员在 “应用程序” > “谷歌工作空间” > “Gmail” > “最终用户访问权限” 下允许自动转发邮箱的组织单位。
2	登录 Gmail 中的支持邮箱，然后前往 “设置” > “查看所有设置” > “转发” 和 POP/ IMAP。
3	选择 “添加转发地址”，粘贴 Control Hub 中的转发地址，然后完成确认提示。 Gmail 向生成的地址发送验证链接或验证码。
4	在电子邮件资产的解密调试日志中，从出站 Webhook 负载中检索入站电子邮件的验证链接Webex Connect或代码，或从电子邮件资产的完整电子邮件正文中检索验证链接或代码。然后完成 Gmail 验证。
5	返回 Gmail 转发设置，刷新页面，选择 “将收到的邮件副本转发至”，选择 Gmail 应如何处理其副本，然后选择 “保存更改”。

在微软 365 中配置转发

要将收到的微软 365 邮件转发到电子邮件资产，请执行以下操作：

1	为支持邮箱配置邮箱转发或收件箱规则，以便将新邮件从 Control Hub 发送到转发地址。
2	在 Microsoft Defender 门户中，查看适用于该邮箱的出站垃圾邮件政策。将自动转发规则设置为开启-在安全管理员批准的范围狭窄的策略中启用转发功能。
3	在 Exchange Online 中，确保适用的远程域设置允许自动转发到转发地址域。
4	查看 Exchange 邮件流规则，确保没有规则阻止自动转发的邮件。如果您需要例外，请将其限制为支持邮箱和批准的目的地。
5	保存转发配置，留出时间让 Microsoft 365 策略更改生效。必需：启用转发功能后，入站电子邮件将无法到达分配的 Webex 工作负载。在 Microsoft 365 中，阻止出站垃圾邮件策略、远程域设置或邮件流规则优先于允许转发的设置。附件限制：入站电子邮件附件限制为 25 MB。如果邮件因附件过大而失败，则发件人会收到一封传送失败的邮件，必须使用较小的附件重新发送。嵌入式图像：嵌入式图像作为附件到达代理桌面。如果启用 PCI 扫描，则这些图像将被屏蔽。 Microsoft Outlook附件：由于限制，带有 .msg 附件的入站电子邮件在到达时可能没有在该.msg 中嵌入文件。Microsoft Outlook

测试电子邮件资产

要验证完整的电子邮件路径，请执行以下操作：

1	从外部电子邮件帐户向已配置的支持邮箱发送消息，并确保该消息到达分配的 Webex 工作负载。
2	在分配的 Webex 工作负载中，发送新消息或回复入站消息，并确保外部收件人收到该消息。传送状态：通过 SMTP 渠道发送的电子邮件不包括配送跟踪，该服务不会收到配送失败通知。在测试期间确认从收件人邮箱发货。
3	如果入站配送不起作用，请查看提供商的转发地址确认、转发规则和组织转发政策。
4	如果出站发送不起作用，请检查 SMTP 服务器和端口、提供商权限、客户端凭证、同意、Microsoft 365 SMTP 身份验证设置和令牌状态。修复问题并在需要时再次生成令牌。

Cisco AI Assistant

感谢您的反馈。

概述