本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 收件箱集成
<a name="dropbox-integration"></a>

使用 Dropbox 操作连接器，您可以直接在 Amazon Quick 中通过自然语言访问 Dropbox 平台。您无需离开 Amazon Quick 即可上传文件、管理文件夹结构、生成共享链接和搜索内容。

Amazon Quick 支持 Dropbox 的多种身份验证方法。选择最适合您组织安全要求的方法。
+ **默认 OAuth 应用程序**-使用 AWS由托管的 OAuth 应用程序。无需其他凭证。您可以直接使用自己的 Dropbox 帐户进行身份验证。
+ **自定义 OAuth 应用程序**-使用在 Dropbox 中注册的由客户管理的 OAuth 应用程序。此选项可让您的组织完全控制 OAuth 配置。
+ **API 密钥** — 使用 Dropbox 访问令牌进行身份验证。此方法适用于个人使用或测试。

有关 Amazon Quick 支持的身份验证方法的更多信息，请参阅[身份验证方法](quick-action-auth.md)。

## 开始前的准备工作
<a name="dropbox-integration-prerequisites"></a>

在设置集成之前，请确保您具备以下条件。
+ 一个有效的 Dropbox 帐户，可以访问您要使用的文件和文件夹。
+ 对于**自定义 OAuth 应用程序**：访问 Dropbox 网站上的 [Dropbox 应用程序控制台](https://www.dropbox.com/developers/apps)来创建应用程序。
+ 对于 **API 密钥**：从 Dropbox 网站上的 [Dropbox 应用控制台](https://www.dropbox.com/developers/apps)生成的访问令牌。
+ 有关 Amazon Quick 订阅要求，请参阅[在控制台中设置集成](integration-console-setup-process.md)。

## 配置保管箱
<a name="dropbox-source-setup"></a>

如果您使用**默认 OAuth 应用程序**身份验证，请跳过此部分并转至。[在 Amazon Quick 中设置连接器](#dropbox-quicksuite-setup)

要进行自定义 OAuth 应用程序或 API 密钥身份验证，请在配置 Amazon Quick 之前在 Dropbox 中完成相应的步骤。

### 为自定义 OAuth 应用程序创建 Dropbox 应用程序
<a name="dropbox-register-oauth"></a>

在 Dropbox 应用程序控制台中创建应用程序，以获取 Amazon Quick 所需的客户凭证。

1. 登录您的 Dropbox 帐户，然后前往 [Dropbox 网站上的 Dropbox 应用程序控制台](https://www.dropbox.com/developers/apps)。

1. 选择**创建应用程序**。

1. **在 “选择 API**” 中，选择 “**限定访问权限**”。

1. 选择您需要的访问类型：
   + **应用程序文件夹**-仅提供对特定文件夹的访问权限。
   + **完整版 Dropbox** — 提供对所有文件和文件夹的访问权限。

1. 输入应用程序名称并选择**创建应用程序**。

1. 在应用程序设置页面上，记录以下值。在配置 Amazon Quick 时，您需要它们。
   + **应用程序密钥**-这是您的客户端 ID。
   + **应用程序密钥** — 这是您的客户机密钥。

1. 在 **OAuth 2** 下的**重定向 URI** 部分，添加 Amazon Quick 回传网址：`https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

1. 选择 “**权限**” 选项卡，然后选择您的集成所需的范围。有关推荐的范围，请参阅[推荐瞄准镜](#dropbox-oauth-scopes)。

### 为 API 密钥生成访问令牌
<a name="dropbox-create-token"></a>

从 Dropbox 应用控制台生成访问令牌以进行 API 密钥身份验证。

1. 登录您的 Dropbox 帐户，然后前往 [Dropbox 网站上的 Dropbox 应用程序控制台](https://www.dropbox.com/developers/apps)。

1. 选择您的应用程序，或者根据需要创建一个新应用程序。

1. 在 **OAuth 2** 下，选择**生成**以创建访问令牌。

1. 复制并安全地存储生成的令牌。您在配置 Amazon Quick 时需要它。

### 推荐瞄准镜
<a name="dropbox-oauth-scopes"></a>

创建 Dropbox 应用时，请根据要使用的操作在 “**权限**” 选项卡上配置以下范围。


**Dropbox 推荐**  

| Scope | 说明 | 
| --- | --- | 
| account\_info.read | 读取账户信息。 | 
| account\_info.write | 更新账户信息。 | 
| contacts.read | 读取联系信息。 | 
| contacts.write | 更新联系人信息。 | 
| events.read | 读取事件日志条目。 | 
| events.write | 创建事件日志条目。 | 
| file\_requests.read | 读取文件请求。 | 
| file\_requests.write | 创建和管理文件请求。 | 
| files.content.read | 读取文件内容。 | 
| files.content.write | 创建、修改和删除文件。 | 
| files.metadata.read | 读取文件和文件夹的元数据。 | 
| files.metadata.write | 编辑文件和文件夹的元数据。 | 
| files.permanent\_delete | 永久删除文件。 | 
| files.team\_metadata.read | 读取团队文件元数据。 | 
| files.team\_metadata.write | 编辑团队文件元数据。 | 
| groups.read | 读取群组信息。 | 
| groups.write | 管理群组。 | 
| members.delete | 移除团队成员。 | 
| members.read | 读取团队成员信息。 | 
| members.write | 管理团队成员。 | 
| sessions.list | 列出活动会话。 | 
| sessions.modify | 修改活动会话。 | 
| sharing.read | 读取共享设置和共享链接。 | 
| sharing.write | 创建和管理共享链接和文件夹共享。 | 
| team\_data.content.read | 读取团队内容。 | 
| team\_data.content.write | 管理团队内容。 | 
| team\_data.governance.read | 读取团队数据治理设置。 | 
| team\_data.governance.write | 管理团队数据治理设置。 | 
| team\_data.team\_space | 访问团队空间数据。 | 
| team\_info.read | 读取团队信息。 | 
| team\_info.write | 更新团队信息。 | 

## 在 Amazon Quick 中设置连接器
<a name="dropbox-quicksuite-setup"></a>

### 从 “可用” 选项卡连接
<a name="dropbox-quick-connect"></a>

如果要使用默认 OAuth 应用程序身份验证，则无需额外配置即可直接从 “**可用**” 选项卡进行连接。

1. 在 Amazon Quick 控制台中，选择 “**连接器**”。

1. 在 “**可用**” 选项卡上找到 **Dropbox**，然后选择 **Connect**。

1. 完成 Dropbox 登录流程并授予所请求的权限。

要改为使用自定义 OAuth 应用程序或 API 密钥配置连接器，请使用**为团队创建**选项卡，如下所述。

### 从 “为你的团队创建” 选项卡中创建
<a name="dropbox-full-setup"></a>

完成所有必需的 Dropbox 配置后，请在 Amazon Quick 中创建连接器。

1. 在 Amazon Quick 控制台中，选择 “**连接器**”。

1. 选择 “**为你的团队创建**” 选项卡。

1. 找到并选择 **Dropbox**。
**注意**  
如果 Dropbox 连接器已存在，则会出现一个对话框，其中包含您现有的连接器。要使用现有的连接器，请选择它。要创建新的，请选择 “**否，新建**”。

1. 输入连接器的**名称**。（可选）选择 **\+ 添加描述**以添加描述。

1. 在 “**连接类型**” 中，选择 “**公共网络**”。

1. 对于 **OAuth 配置**，请选择以下身份验证方法之一并配置必填字段。

   1. 对于**默认 OAuth 应用程序：**

      无需其他凭证。选择**下一步**以继续。

   1. 对于**自定义 OAuth 应用程序**，请配置以下字段：
      + **基本网址**（可选）-Dropbox API 基础网址。示例：`https://api.dropboxapi.com`
      + **客户端 ID** — 您的 Dropbox 应用中的应用密钥。
      + **客户密钥**-来自 Dropbox 应用的应用密钥。
      + **令牌网址**-令牌端点。示例：`https://api.dropboxapi.com/oauth2/token`
      + **授权 URL**-授权端点。示例：`https://www.dropbox.com/oauth2/authorize`
      + **重定向 URL** — Pre-filled 使用 Amazon 快速回传网址。

   1. 对于 **API 密钥**，请配置以下字段：
      + **基本网址**（可选）-Dropbox API 基础网址。示例：`https://api.dropboxapi.com`
      + **API 密钥** — 您的 Dropbox 访问令牌。
      + **电子邮件**（可选）-与您的 Dropbox 帐户关联的电子邮件地址。

1. 选择**下一步**。

1. 如果您选择**默认 OAuth 应用程序或自定义 OAuth 应用程序****，则会打开** Dropbox 授权窗口。查看请求的权限，然后选择 “**允许**”。

1. 在 “**查看**” 页面上，查看连接器的可用操作。选择**下一步**。

1. 在 “**发布**” 页面上，选择谁可以访问连接器。您可以为组织中的所有人开启访问权限，也可以搜索特定的团队或群组。

1. 选择**发布**。

## 可用操作
<a name="dropbox-integration-actions"></a>

设置连接器后，可以执行以下操作。


**Dropbox 可用**  

| 类别 | 处理建议 | 说明 | 
| --- | --- | --- | 
| 文件 | 列出文件 | 列出文件夹中的文件。 | 
| 文件 | 获取文件 | 读取文件内容。 | 
| 文件 | 导入文件 | 将文件上传到 Dropbox。 | 
| 文件 | 搜索文件 | 按名称或内容搜索文件或文件夹。 | 
| 文件 | 更新文件位置 | 将文件或文件夹移动到其他位置。 | 
| 文件 | 获取临时链接 | 为文件生成临时下载链接。 | 
| 文件 | 获取元数据 | 检索文件或文件夹的元数据。 | 
| 文件 | 从 URL 保存文件 | 通过网址将文件保存到 Dropbox。 | 
| 文件夹 | Create Folder | 创建新文件夹 | 
| 文件夹 | 列出文件夹 | 用户有权访问的文件夹列表。 | 
| 分批操作 | 获取 Batch Move 状态 | 检查批量移动操作的状态。 | 
| 共享 | 创建共享链接 | 为文件或文件夹创建共享链接。 | 
| 共享 | 列出共享链接 | 列出文件或文件夹的共享链接。 | 
| 共享 | 更新文件夹共享 | 与其他用户共享文件夹。 | 
| 共享 | 列出已接收的文件 | 列出其他用户与您共享的文件。 | 
| 文件请求 | 创建文件请求 | 创建文件请求，供其他人上传文件。 | 
| Account | 获取用户 | 检索有关经过身份验证的用户的信息。 | 
| Account | 获取空间使用情况 | 检索账户的存储空间使用情况。 | 

**注意**  
您可以使用的操作取决于经过身份验证的用户可以访问的文件和文件夹。

## 管理和故障排除
<a name="dropbox-integration-troubleshooting"></a>

要编辑、共享或删除您的连接器，请参阅[管理现有集成](integration-workflows.md#managing-existing-integrations)。

### 身份验证问题
<a name="dropbox-troubleshooting-auth"></a>
+ **Sign-in 失败（默认 OAuth 应用程序或自定义 OAuth 应用程序）**[— 确认您的 Dropbox 帐户处于活动状态，并且您可以直接登录 Dropbox 网站。](https://www.dropbox.com)对于自定义 OAuth 应用程序，请确认您的 Dropbox 应用程序中的重定向网址是否与 Amazon Quick 回传网址相匹配。
+ **客户凭据无效（自定义 OAuth 应用程序）**-验证客户端 ID 和客户机密是否与 Dropbox 应用中的应用密钥和应用密钥值相匹配。如果您重新生成了应用程序密钥，请在 Amazon Quick 中更新该值。
+ **API 密钥被拒绝**-验证您的访问令牌是否处于活动状态。令牌可以在 Dropbox 应用控制台中过期或撤销。
+ **权限不足**-验证您的 Dropbox 应用是否具有您要使用的操作所需的权限范围。