本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 在 Amazon Connect 座席工作区中集成第三方应用程序（第三方应用程序）
Amazon Connect 座席工作区是一个单一、直观的应用程序，可为您的客服提供所需的工具和 step-by-step指导，帮助他们高效地解决问题、改善客户体验和加快入职速度。除了在客服工作区中使用第一方应用程序（例如客户档案、案例和 Connect AI 代理）外，您还可以集成第三方应用程序。
**注意**
此功能仅在默认座席工作区中受支持；使用自定义 CCP 时不支持此功能。
例如，您可以将专有的预订系统或供应商提供的指标控制面板集成到客服工作区中 Amazon Connect 。
如果您是有意构建第三方应用程序的开发人员，请参阅[《座席工作区开发人员指南》](https://docs.aws.amazon.com/agentworkspace/latest/devguide/getting-started.html)。
**Topics**
+ [要求](#onboard-3p-apps-requirements)
+ [如何添加集成](#onboard-3p-apps-how-to-integrate)
+ [删除集成](#delete-3p-apps)
+ [分配权限](assign-security-profile-3p-apps.md)
+ [向第三方应用程序授予访问权限时的 Iframe 权限](3p-apps-iframe-permissions.md)
+ [集成 MCP 服务器](3p-apps-mcp-server.md)
+ [事件和请求](3p-apps-events-requests.md)
+ [访问 Agent Workspace 中的第三方应用程序](3p-apps-agent-workspace.md)
+ [访问 Worklist 应用程序](worklist-app.md)
+ [第三方应用程序 SSO 联合身份验设置](3p-apps-sso.md)
+ [在 Amazon Connect 座席工作区使用第三方应用程序的屏幕弹出功能](no-code-ui-builder-app-integration.md)
+ [构建第三方应用程序的研讨会](https://catalog.workshops.aws/amazon-connect-agent-empowerment/en-US/third-party-applications/test)
## 要求
如果您使用自定义 IAM 策略来管理对第三方应用程序的访问权限，则您的用户需要以下 IAM 权限，才能使用 AWS 管理控制台集成第三方应用程序。除了 `AmazonConnect_FullAccess` 之外，用户还需要：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"app-integrations:CreateApplication",
"app-integrations:GetApplication",
"iam:GetRolePolicy",
"iam:PutRolePolicy",
"iam:DeleteRolePolicy"
],
"Resource": "arn:aws:app-integrations:us-east-1:111122223333:application/*",
"Effect": "Allow"
}
]
}
```
------
## 集成
**注意**
要向您的实例添加集成，请确保您的实例使用服务相关角色 (SLR)。如果您的实例目前不使用 SLR，但您希望添加集成，则需要迁移到 SLR。只能将集成添加到使用 SLR 的实例。有关更多信息，请参阅 [适用于 2018 年 10 月之前创建的实例](connect-slr.md#migrate-slr)。
1. 打开 Amazon Connect [控制台](https://console.aws.amazon.com/connect/) (https://console.aws.amazon.com/connect/)。
1. 在左侧导航窗格中，选择**集成。**如果您没有看到此菜单，那是因为该菜单在您所在的区域中不可用。要查看此功能可用的地区，请参阅[按地区划分的 Amazon Connect 功能可用性](regions.md)。
1. 在**集成**页面上，选择**添加集成**。
![\[“设置联系属性”数据块的属性页面。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/integrations-list.png)
1. 在**添加集成**页面上，输入：
1. **基本信息**
1. **显示名称**：集成的友好名称。此名称显示在安全配置文件上，并在座席工作区中的选项卡上向座席显示。您可以回来更改此名称。
1. **描述（可选）**：您可以选择为此集成提供任何描述。此描述不会向座席显示。
1. **集成类型**：表示集成是标准 Web 应用程序、服务还是 MCP 服务器。这决定了如何在系统内访问集成。
1. **集成标识符**：正式名称，对于标准应用程序或服务类型的集成来说是唯一的。如果每个访问 URL 只有一个应用程序，建议您使用该访问 URL 的来源。您无法更改此名称。
1. **初始化超时**：与工作区建立连接所支持的最长时间。支持的时间以毫秒为单位。此设置有助于管理连接问题并确保应用程序及时启动。
1. **应用程序详细信息**
1. **联系人范围**：指示 Web 应用程序是针对每位联系人刷新，还是仅在每次新的浏览器会话时刷新。此设置会影响应用程序更新其数据的频率。
1. **初始化超时**：与工作区建立连接所支持的最长时间。支持的时间以毫秒为单位。此设置有助于管理连接问题并确保应用程序及时启动。
1. **访问**
1. **访问 URL**：这是托管应用程序的 URL。除非是本地主机，否则 URL 必须是安全的，以 https 开头。
**注意**
并非所有人都 URLs 可使用内嵌框架。以下是两种检查 URL 是否可以使用内嵌框架的方法：
有一种名为 [Iframe Tester](http://iframetester.com/) 的第三方工具可以帮助检查 URL 是否可以使用内嵌框架。
如果 URL 可以使用内嵌框架，它将在此页面的预览中呈现。
如果 URL 不能使用内嵌框架，它将在此页面的预览中显示错误。
此网站可能显示错误，并且该应用程序仍可以在 Agent Workspace 中使用内嵌框架。这是因为应用程序开发者可以锁定他们的应用程序，使其只能嵌入到 Workspace 中，而不能嵌入到其他任何地方。如果您从应用程序开发者那里收到此应用程序，建议您仍然尝试将此应用程序集成到 Agent Workspace 中。
对于技术用户：请检查您正在尝试集成的应用程序的安全策略内容。
Firefox：汉堡菜单 > 更多工具 > Web 开发人员工具 > 网络
Chrome：3 点菜单 > 更多工具 > 开发人员工具 > 网络
其他浏览器：在开发人员工具中查找网络设置。
Content-Security-Policy帧祖先指令应该是。`https://your-instance.my.connect.aws`
如果指令为`same origin`或`deny`，则 Connect 无法对此 URL 进行内建框架 AWS/Amazon
如果无法为应用程序建立内嵌框架，您可以执行以下操作：
+ 如果您控制应用程序/URL，则可以更新应用程序的内容安全策略。遵循应用程序开发人员的最佳实践/确保应用程序只能嵌入[此处](https://docs.aws.amazon.com/agentworkspace/latest/devguide/recommendations-and-best-practices.html)的 Amazon Connect 座席工作区部分。
+ 如果您无法控制应用程序/URL，可以尝试联系应用程序开发人员，要求他们更新应用程序的内容安全策略。
1. **已批准的来源（可选）**：如果与访问网址不同，则应允许的允许名单 URLs 。除非是本地主机，否则 URL 必须是安全的，以 https 开头。
1. 为[事件和请求](3p-apps-events-requests.md)添加权限。
以下示例演示了如何使用 AWS 管理控制台载入新应用程序并为其分配权限。在此示例中，系统为应用程序分配了六种不同的权限。
**提供基本信息和访问详细信息**
1. **实例关联**
1. 您可以授予该账户区域内的任何实例访问此应用程序的权限。
1. 虽然将集成与实例关联是可选的，但在将其与实例关联之前，您将无法使用该应用程序。
**注意**
对于 MCP 服务器，您只能选择使用所选网关的发现 URL 配置的实例。
![\[提供基本信息和访问详细信息。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/integrations-add-basic-info.png)
**向应用程序授予工作区数据集成权限**
![\[向应用程序授予工作区数据集成权限。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/integrations-add-permissions.png)
**Iframe 配置**
![\[Iframe 配置。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/integrations-add-iframe-config.png)
1. 选择**添加集成**。
1. 如果集成已成功创建，您将被发送到**集成详细信息**页面，并会看到成功横幅。
![\[向应用程序授予工作区数据集成权限。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/integrations-view.png)
您可以编辑现有应用程序的某些属性，例如其显示名称、访问网址和权限。
1. 如果在创建应用程序或将应用程序与实例关联时出错，则会看到一条错误消息，您可以采取相应的措施来纠正问题。
## 删除集成
如果您不想在可预见的将来再使用集成，则可以将其删除。如果您想暂时停止使用它，但在可预见的将来可能会再次使用它，建议您将其与实例解除关联，以避免再次添加它。要删除集成，请导航到 AWS 管理控制台，选择一个集成，然后选择**删除**。
**故障排查**
+ 如果集成与任何实例关联，则操作将失败。您首先必须取消集成与任何实例的关联。然后你可以回来删除它。
**提示**
如果您在 2023 年 12 月 15 日之前创建了集成，则在更新集成与实例的关联时可能会遇到问题。这是因为您需要更新您的 IAM 策略。
![\[由于权限不足，尝试删除集成时出现 IAM 错误\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/delete-3p-apps.png)
需要更新您的 IAM 策略，以包含以下权限：
+ `app-integrations:CreateApplicationAssociation`
+ `app-integrations:DeleteApplicationAssociation`
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"app-integrations:CreateApplication",
"app-integrations:GetApplication"
],
"Resource": "arn:aws:app-integrations:us-east-1:111122223333:application/*",
"Effect": "Allow"
},
{
"Action": [
"app-integrations:CreateApplicationAssociation",
"app-integrations:DeleteApplicationAssociation"
],
"Resource": "arn:aws:app-integrations:us-east-1:111122223333:application-association/*",
"Effect": "Allow"
},
{
"Action": [
"iam:GetRolePolicy",
"iam:PutRolePolicy",
"iam:DeleteRolePolicy"
],
"Resource": "arn:aws:iam::111122223333:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_*",
"Effect": "Allow"
}
]
}
```
------
# 在 Amazon Connect 中使用第三方应用程序的安全配置文件权限
本主题介绍访问您已加载并关联的第三方应用程序所需的安全配置文件权限。有关第三方应用程序权限及其 API 名称的列表，请参阅[Amazon Connect 中的安全配置文件权限列表](security-profile-list.md)。
## 第三方应用程序权限
**注意**
将应用程序与实例关联后，您可能必须等待 10 分钟，才能看到该应用程序出现在**安全配置文件**页面的**座席应用程序**部分。
您已加载到 Amazon Connect 实例 AWS 并与其关联的所有应用程序都将显示在**安全配置文件**页面的**代理应用程序**部分，如下图所示。
![\[“安全配置文件”页面的“座席应用程序”部分。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/assign-security-profile-3p-apps-displayed.png)
您还需要授予对 CCP 的访问权限，才能显示应用程序启动程序菜单。
![\[应用了 CCP 访问联系人控制面板的访问权限。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/assign-security-profile-3p-apps-ccp-permissions.png)
分配权限后，请查看如何[访问 Amazon Connect 座席工作区中的第三方应用程序](3p-apps-agent-workspace.md)。
# 向第三方应用程序授予访问 Amazon Connect 的权限时的 Iframe 权限
通过 AWS 管理控制台的 `onboarding` UI 或 API 配置第三方应用程序时，您可以指定 `iframe` 权限设置。即使在设置了应用程序之后，也可以修改这些权限。
默认情况下，向所有第三方应用程序授予四种基本 `iframe` 权限：`allow-forms`、`allow-popups`、`allow-same-origin` 和 `allow-scripts`。由于某些应用程序可能需要增强功能，因此可以在应用程序注册过程中请求其它 `iframe` 权限。
**注意**
以下权限的浏览器兼容性可能因不同的浏览器实现而异。
| 权限 | 说明 |
| --- | --- |
| 允许 | |
| clipboard-read | 控制是否支持应用程序从剪贴板读取数据。Chrome 目前支持此权限，但 Firefox 和 Safari 不支持。 |
| clipboard-write | 控制是否支持应用程序将数据写入剪贴板。Chrome 目前支持此权限，但 Firefox 和 Safari 不支持。 |
| microphone | 控制是否支持应用程序使用音频输入设备。 |
| camera | 控制是否支持应用程序使用视频输入设备。 |
| 沙箱 | |
| allow-forms | 支持页面提交表单。默认情况下支持此权限。 |
| allow-popups | 支持应用程序打开弹出窗口。默认情况下支持此权限。 |
| allow-same-origin | 如果不使用此令牌，则该资源将被视为来自特殊来源，该来源总是不符合同源策略（可能会阻止访问数据 storage/cookies 等 JavaScript APIs）。默认情况下支持此权限。 |
| allow-scripts | 支持页面运行脚本。默认情况下支持此权限。 |
| allow-downloads | 支持通过具有下载属性的 或 元素下载文件，以及通过导航引导至下载文件 |
| allow-modal | 支持页面通过 Window.alert()、Window.confirm()、Window.print() 和 Window.prompt() 打开模态窗口，同时支持打开