View a markdown version of this page

教程:设置基本的 Transfer Family 网络应用程序 - AWS Transfer Family

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

教程:设置基本的 Transfer Family 网络应用程序

本教程介绍如何设置 Transfer Family 网络应用程序。Transfer Family Web 应用程序提供了一个简单的界面,可通过网络浏览器将数据传输到 Amazon S3 或从中传输数据。有关此功能的详细文档,请参阅 转移家庭 Web 应用程序。

Web 应用程序教程:先决条件

注意

本教程假设您使用的是身份提供商的 IAM 身份中心目录,如果不是这样,请参阅 为 Transfer Family Web 应用程序配置您的身份提供商 在继续本教程之前。

完成本教程后,您的用户可以登录并与您创建的 Web 应用程序进行交互。

第 1 步:创建必要的支持资源

您需要将用户添加到 IAM 身份中心目录中。您还需要两个角色:一个用作 Web 应用程序的身份持有者角色,另一个用于配置 Amazon S3 访问授权。对于本教程,我们允许 AWS 为我们创建这些角色的服务。

如何添加用户
  1. 登录 AWS 管理控制台 然后打开 AWS IAM Identity Center 控制台在 https://console.aws.amazon.com/singlesignon/。

  2. 在左侧导航窗格中,选择 用户。

  3. 选择 添加用户 并指定用户的详细信息。

    指定用户名、电子邮件地址和其他必填信息。您可以选择向用户发送一封包含设置密码说明的电子邮件,也可以生成一次性密码与他们共享。

  4. 选择 下一步 并可选择将新用户分配到一个或多个群组。

  5. 选择 下一步 并查看您的选择。

    如果一切看起来都不错,请选择 添加用户 使用您指定的详细信息创建新用户。

    在本教程中,示例用户是 鲍勃·斯蒂尔斯,用户名 bobstiles 和电子邮件地址 bobstiles@example.com。

第 2 步:创建 Transfer Family 网络应用程序

创建 Transfer Family 网络应用程序
  1. 登录 AWS 管理控制台 然后打开 AWS Transfer Family 控制台在 https://console.aws.amazon.com/transfer/。

  2. 在左侧导航窗格中,选择 网络应用程序。

  3. 选择 创建 Web 应用程序。

    对于身份验证访问,请注意,该服务会自动查找 AWS IAM Identity Center 您设置为先决条件的实例。

  4. 在 权限类型 窗格,选择 创建和使用新的服务角色。该服务为您创建身份持有者角色。身份持有者角色在其会话中包括经过身份验证的用户的身份。

  5. 在 Web 应用程序单元 窗格,接受默认值 1,或根据需要调整到更高的值。

  6. 添加标签以帮助您整理 Web 应用程序。要查看教程,请输入 姓名 为了钥匙和 教程 Web 应用程序 为了价值。

    提示

    您可以直接从中编辑 Web 应用程序名称 网络应用程序 创建后的列表页面。

  7. 选择 下一步 打开 设计 Web 应用程序 页面。在此屏幕上,提供以下信息。

    您可以选择为您的 Web 应用程序提供标题。您还可以上传徽标和网站图标的图像文件。

    • 对于页面标题,自定义用户连接到 Web 应用程序时看到的浏览器选项卡的标题。如果您没有为页面标题输入任何内容,则默认为 传输 Web 应用程序。

    • 对于徽标,请上传图像文件。您的徽标图片的最大上传大小为 2 MB。

    • 对于网站图标,请上传图片文件。您的网站图标的最大上传大小为 2 MB。

  8. 选择 下一步,然后选择 创建 Web 应用程序。

为了提供品牌体验,您可以为用户提供自定义网址,以访问您的 Transfer Family 网络应用程序。有关更多信息,请参阅 使用自定义 URL 更新您的访问终端节点。

第 3 步:配置 Cross-origin 存储桶的资源共享 (CORS)

您必须为 Web 应用程序使用的所有存储分区设置跨源资源共享 (CORS)。一个 CORS 配置 是一份定义规则的文档,用于识别允许您访问存储桶的来源。有关 CORS 的更多信息,请参阅 配置跨源资源共享 (CORS)。

进行设置 Cross-origin 您的 Amazon S3 存储桶的资源共享 (CORS)
  1. 登录 AWS 管理控制台 然后在以下位置打开 Amazon S3 控制台 https://console.aws.amazon.com/s3/。

  2. 选择 水桶 从左侧导航面板中,在搜索对话框中搜索您的存储桶,然后选择 权限 选项卡。

  3. 在 Cross-origin 资源共享 (CORS),选择 编辑 然后粘贴以下代码。替换 AccessEndpoint 使用您的 Web 应用程序的实际访问端点。确保不要输入末尾的斜杠,因为这样做会在用户尝试登录您的 Web 应用程序时出错。

    • 不正确的例子: https://webapp-c7bf3423.transfer-webapp.us-east-2.on.aws/

    • 正确的例子: https://webapp-c7bf3423.transfer-webapp.us-east-2.on.aws

    如果您为多个 Web 应用程序重复使用存储桶,请将其 Web 应用程序访问端点附加到 AllowedOrigins 清单。

    [ { "AllowedHeaders": [ "*" ], "AllowedMethods": [ "GET", "PUT", "POST", "DELETE", "HEAD" ], "AllowedOrigins": [ "https://AccessEndpoint" ], "ExposeHeaders": [ "last-modified", "content-length", "etag", "x-amz-version-id", "content-type", "x-amz-request-id", "x-amz-id-2", "date", "x-amz-cf-id", "x-amz-storage-class", "access-control-expose-headers" ], "MaxAgeSeconds": 3000 } ]
  4. 选择 保存更改 更新 CORS。

第 4 步:将用户添加到 Transfer Family 网络应用程序

添加您之前在 IAM 身份中心创建的用户。

将用户分配给 Transfer Family Web 应用程序
  1. 导航到您之前创建的 Web 应用程序。

  2. 选择分配用户和组。

    屏幕显示所选 Web 应用程序的详细信息。
  3. 要分配您之前在 IAM 身份中心创建的用户,请选择 分配现有用户和群组 然后选择 下一步。

    1. 按显示名称搜索用户。请注意,在您开始输入搜索条件之前,不会出现任何用户。要添加 Bob Stiles,输入 鲍勃 在搜索框中。如果您找不到您的用户,请导航到 IAM Identity Center 管理控制台,找到该用户,然后将他们的显示名称复制并粘贴到此处。

    2. 选择 Bob Stiles 用户,然后选择 分配。

第 5 步:在 Amazon S3 中注册位置并创建访问授权

将用户分配给您的 Web 应用程序后,您需要注册一个存储桶并为该用户创建访问授权。

注意

您必须拥有 S3 访问授权实例,然后才能继续。有关详细信息,请参见 创建 S3 访问授权实例 在 亚马逊简单存储服务用户指南。

注册位置并创建访问授权
  1. 登录 AWS 管理控制台 然后在以下位置打开 Amazon S3 控制台 https://console.aws.amazon.com/s3/。

  2. 选择 访问补助 从左侧导航窗格中。

  3. 选择 查看详情 查看您的 S3 访问授权实例的详细信息。

  4. 选择 地点 选项卡,然后选择 注册地点。

  5. 提供以下信息:

    • 对于 范围,浏览存储桶或输入存储桶的名称,以及可选的前缀。请注意,范围以字符串开头 s3://。

    • 对于 IAM 角色,选择 创建新角色 让 Amazon S3 创建角色。此角色允许 S3 访问授权访问您指定的位置范围。

    显示亚马逊 S3 的屏幕 将 S3 存储桶或前缀注册为位置 使用默认对话框 范围 和 创建新角色 设置。

    选择 注册地点 继续。

  6. 选择 补助金 选项卡,然后选择 创建补助金 并提供以下详细信息。

    • 对于 地点,选择 浏览地点 然后选择您在上一步中注册的位置。

    • 对于 子前缀,输入 * 以表明访问权限适用于整个存储桶。

    • 对于 权限,选择 阅读 和 写作。

    • 对于 受赠者类型,选择 来自 IAM 身份中心的目录身份。

    • 对于 目录标识类型,选择 用户。

    • 在 IAM 身份中心用户/ ID,复制并粘贴的用户 ID Bob Stiles。此 ID 位于 用户 Transfer Family 网络应用程序中的窗格。

  7. 选择 创建补助金。

访问权限已创建。

第 6 步:以用户身份访问您的 Transfer Family 网络应用程序

现在,我们导航到 Web 应用程序的 URL 并以之前分配的用户身份登录。

登录 Transfer Family 网络应用程序
  1. 导航到您的 Web 应用程序

  2. 选择 访问端点 来自 Web 应用程序详细信息 窗格。

    屏幕显示了教程期间创建的 Web 应用程序的详细信息。
  3. 在登录屏幕上,输入您创建的用户, bobstiles,然后选择 下一步。

  4. 输入系统在创建时分配给该用户的密码,然后选择 下一步。

  5. 如果您的组织需要多因素身份验证 (MFA),则需要立即进行设置。如果没有,请直接跳到步骤 6。

    1. 您将看到一个注册您的 MFA 设备的屏幕。选择一个可用选项并选择 下一步。

    2. 执行必要的步骤为该用户配置 MFA:这些步骤取决于您选择的 MFA 选项。

    3. 您可能需要为用户设置新密码:如果需要,请立即设置。系统可能还要求您使用您配置的新 MFA 凭证再次登录。

您的用户应该看到类似于以下内容的屏幕。请注意,此屏幕截图包括对网站图标和徽标的自定义。

Transfer Family 网络应用程序示例,带有自定义标题、网站图标和徽标。

后续步骤

您已成功设置了具有标准 S3 存储桶访问权限的基本 Transfer Family Web 应用程序。如果您需要对存储桶权限进行更精细的控制,例如允许用户从一个存储桶下载并上传到另一个存储桶,请参阅 教程:设置 AWS Transfer Family 具有选择性多存储桶访问权限的 Web 应用程序。

将 Okta 集成为 Web 应用程序的身份提供商

您可以将外部身份提供商与 Transfer Family 网络应用程序集成。本节介绍如何将 Okta 设置为您的身份提供商。

  1. 在 Okta 中,创建用户、群组和应用程序。有关如何执行此操作的详细信息,请参阅 使用 Okta 和 IAM 身份中心配置 SAML 和 SCIM。

    与 Transfer Family Web 应用程序教程一起使用的 Okta 应用程序示例
  2. 连接 Okta 并将用户和群组从 Okta 导入到 AWS IAM Identity Center。按照中的步骤 1—4 进行操作 使用 Okta 和 IAM 身份中心配置 SAML 和 SCIM。

    IAM 身份中心显示了从 Okta 集成的示例用户
    IAM 身份中心显示了从 Okta 集成的示例群组
  3. 确认 IAM 身份中心中的身份源是 SAML 2.0。

    显示身份源为 SAML 2.0 的 IAM 身份中心
  4. 分配您的用户和群组,如中所述 第 4 步:将用户添加到 Transfer Family 网络应用程序。

  5. 为避免用户在登录您的 Web 应用程序时需要使用 MFA,请在 Okta 中执行以下步骤。

    1. 从 Okta 管理员控制台访问 [应用程序]-[应用程序],然后选择 AWS IAM Identity Center 应用程序。

    2. 在 登录 选项卡,选择 [用户认证]-编辑。

    3. 选择 仅限密码。

在您执行本教程的所有其他步骤后,您的用户应该能够通过在 Web 浏览器中导航到 Web 应用程序的访问端点来访问您的 Transfer Family 网络应用程序。