将 Amazon QuickSight 与 IAM 结合使用 - Amazon QuickSight
亚马逊 QuickSight 政策亚马逊 QuickSight政策（基于资源）基于亚马逊 QuickSight标签的授权亚马逊 QuickSight IAM 角色将 IAM 角色传递给 QuickSight
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

将 Amazon QuickSight 与 IAM 结合使用

   适用于：企业版和标准版 
   目标受众：系统管理员 

在使用 IAM 管理对亚马逊的访问权限之前 QuickSight，您应该了解亚马逊可以使用哪些 IAM 功能 QuickSight。要全面了解亚马逊 QuickSight 和其他 Amazon 服务如何与 IAM 配合使用，请参阅 IAM 用户指南中的与 IAM 配合使用的Amazon 服务。

亚马逊 QuickSight 政策（基于身份）

通过使用 IAM 基于身份的策略，您可以指定允许或拒绝的操作和资源以及允许或拒绝操作的条件。Amazon QuickSight 支持特定的操作、资源和条件键。要了解在 JSON 策略中使用的所有元素，请参阅《IAM 用户指南》 中的 IAM JSON 策略元素参考。

您可以使用 Amazon 根证书或 IAM 用户证书创建 Amazon QuickSight 账户。 Amazon root 和管理员凭证已经拥有管理 Amazon Amazon 资源 QuickSight 访问权限所需的所有权限。

不过，我们强烈建议您保护根凭证，因此请使用 IAM 用户凭证。为此，您可以创建策略并将其附加到您计划在 Amazon 上使用的 IAM 用户和角色 QuickSight。该政策必须包括您需要执行的 Amazon QuickSight 管理任务的相应声明，如以下各节所述。

重要

在使用 Amazon QuickSight 和 IAM 政策时，请注意以下几点：

  • 避免直接修改由 Amazon 创建的政策 QuickSight。当你自己修改时，Amazon QuickSight 无法对其进行编辑。无法编辑可能会导致策略出现问题。要修复此问题，请删除之前修改过的策略。

  • 如果您在尝试创建亚马逊 QuickSight 账户时遇到权限错误，请参阅 IAM 用户指南 QuickSight中的亚马逊定义的操作。

  • 在某些情况下，您可能有一个即使从根 QuickSight 账户也无法访问的Amazon账户（例如，如果您不小心删除了其目录服务）。在这种情况下，您可以删除旧的Amazon QuickSight 帐户，然后重新创建。有关更多信息，请参阅 删除您的亚马逊 QuickSight 订阅并关闭账户。

操作

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么。也就是说，哪个主体 可以对什么资源 执行操作，以及在什么 条件 下执行。

JSON 策略的 Action 元素描述可用于在策略中允许或拒绝访问的操作。策略操作通常与关联的 Amazon API 操作同名。有一些例外情况，例如没有匹配 API 操作的仅限权限 操作。还有一些操作需要在策略中执行多个操作。这些附加操作称为相关操作。

在策略中包含操作以授予执行关联操作的权限。

Amazon中的策略操作在操作前 QuickSight 使用以下前缀:quicksight:. 例如，要授予某人使用 Amazon EC2 RunInstances API 操作运行 Amazon EC2 实例的权限，您应将 ec2:RunInstances 操作纳入其策略。策略语句必须包含 Action 或 NotAction 元素。Amazon QuickSight 定义了自己的一组操作，这些操作描述了您可以使用此服务执行的任务。

要在单个语句中指定多项操作，请使用逗号将它们隔开，如下所示：

"Action": [
	      "quicksight:action1",
	      "quicksight:action2"]

您也可以使用通配符 （*) 指定多个操作。例如，要指定以单词 Create 开头的所有操作，包括以下操作：

"Action": "quicksight:Create*"

亚马逊 QuickSight 提供了许多 Amazon Identity and Access Management (IAM) 操作。所有 Amazon QuickSight 操作都带有前缀quicksight:，例如。quicksight:Subscribe有关在 IAM 策略中使用 Amazon QuickSight 操作的信息，请参阅Amazon 的 IAM 政策示例 QuickSight。

要查看最多的亚马逊 QuickSight 操作 up-to-date 列表，请参阅 IAM 用户指南 QuickSight中的亚马逊定义的操作。

资源

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么。也就是说，哪个主体 可以对什么资源 执行操作，以及在什么条件 下执行。

Resource JSON 策略元素指定要向其应用操作的一个或多个对象。语句必须包含 Resource 或 NotResource 元素。作为最佳实践，请使用其 Amazon 资源名称（ARN）指定资源。对于支持特定资源类型（称为资源级权限）的操作，您可以执行此操作。

对于不支持资源级权限的操作（如列出操作），请使用通配符 (*) 指示语句应用于所有资源。

"Resource": "*"

下面是一个示例策略。这意味着只要添加到组中的用户名不是 user1，附加该策略的调用方就能够在任意组上调用 CreateGroupMembership 操作。

{
    "Effect": "Allow",
    "Action": "quicksight:CreateGroupMembership",
    "Resource": "arn:aws:quicksight:us-east-1:aws-account-id:group/default/*",
    "Condition": {
        "StringNotEquals": {
            "quicksight:UserName": "user1"
        }
    }
}

某些 Amazon QuickSight 操作（例如创建资源的操作）无法对特定资源执行。在这些情况下，您必须使用通配符 （*)。

"Resource": "*"

一些 API 操作涉及多种资源。要在单个语句中指定多个资源，请使用逗号分隔 ARN。

"Resource": [
	      "resource1",
	      "resource2"

要查看亚马逊 QuickSight 资源类型及其亚马逊资源名称 (ARN) 的列表，请参阅 IAM 用户指南 QuickSight中的亚马逊定义的资源。要了解您可以使用哪些操作来指定每种资源的 ARN，请参阅 Amazon 定义的操作。 QuickSight

条件键

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么。也就是说，哪个主体可以对什么资源执行操作，以及在什么条件下执行。

在 Condition 元素（或 Condition 块）中，可以指定语句生效的条件。Condition 元素是可选的。您可以创建使用条件运算符（例如，等于或小于）的条件表达式，以使策略中的条件与请求中的值相匹配。

如果您在一个语句中指定多个 Condition 元素，或在单个 Condition 元素中指定多个键，则 Amazon 使用逻辑 AND 运算评估它们。如果您为单个条件键指定多个值，则使用逻辑OR运算来 Amazon 评估条件。在授予语句的权限之前必须满足所有的条件。

在指定条件时，您也可以使用占位符变量。例如，只有在使用 IAM 用户名标记 IAM 用户时，您才能为其授予访问资源的权限。有关更多信息，请参阅《IAM 用户指南》中的 IAM 策略元素：变量和标签。

Amazon 支持全局条件密钥和特定于服务的条件密钥。要查看所有 Amazon 全局条件键，请参阅 IAM 用户指南中的Amazon 全局条件上下文密钥。

Amazon QuickSight 不提供任何特定于服务的条件密钥，但它支持使用一些全局条件密钥。要查看所有 Amazon 全局条件键，请参阅 IAM 用户指南中的Amazon 全局条件上下文密钥。

示例

要查看 Amazon QuickSight 基于身份的政策示例，请参阅。适用于亚马逊的 IAM 基于身份的政策 QuickSight

亚马逊 QuickSight政策（基于资源）

Amazon QuickSight 不支持基于资源的政策。但是，您可以使用 Amazon QuickSight 控制台来配置对您中其他 Amazon 资源的访问权限 Amazon Web Services 账户。

基于亚马逊 QuickSight标签的授权

Amazon QuickSight 不支持为资源添加标签或根据标签控制访问权限。

亚马逊 QuickSight IAM 角色

IAM 角色是 Amazon 账户中具有特定权限的实体。您可以使用 IAM 角色对权限进行分组，以便更轻松地管理用户对 Amazon QuickSight 操作的访问权限。

Amazon QuickSight 不支持以下角色功能：

  • 服务相关角色。

  • 服务角色。

  • 临时证书（直接使用）：但是，Amazon QuickSight 使用临时证书允许用户担任 IAM 角色来访问嵌入式控制面板。有关更多信息，请参阅 使用嵌入式分析。

有关 Amazon 如何 QuickSight 使用 IAM 角色的更多信息，请参阅将 Amazon QuickSight 与 IAM 结合使用和Amazon 的 IAM 政策示例 QuickSight。

将 IAM 角色传递给亚马逊 QuickSight

 适用于：企业版 

当您的 IAM 用户注册 Amazon 时 QuickSight，他们可以选择使用 QuickSight托管角色（这是默认角色）。或者他们可以将现有 IAM 角色传递给 QuickSight。

先决条件

要向您的用户传递 IAM 角色 QuickSight，您的管理员需要完成以下任务：

  • 创建一个 IAM 角色。有关创建 IAM 角色的更多信息，请参阅《IAM 用户指南》中的创建 IAM 角色。

  • 为您的 IAM 角色附加 QuickSight 允许代入该角色的信任策略。使用以下示例为角色创建信任策略。以下示例信任策略允许 Amazon QuickSight 委托人担任其所关联的 IAM 角色。

    有关创建 IAM 信任策略并将其附加到角色的详细信息，请参阅《IAM 用户指南》中的修改角色（控制台）。

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "quicksight.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

  • 向您的管理员（IAM 用户或角色）分配以下 IAM 权限：

    • quicksight:UpdateResourcePermissions— 这会向身为 QuickSight 管理员的 IAM 用户授予在中更新资源级权限的权限。 QuickSight有关由定义的资源类型的更多信息 QuickSight，请参阅 IAM 用户指南 QuickSight中的 A mazon 操作、资源和条件键。

    • iam:PassRole— 这授予用户将角色传递给的权限 QuickSight。有关更多信息，请参阅 IAM 用户指南中的向用户授予将角色传递给 Amazon 服务的权限。

    • iam:ListRoles—（可选）这授予用户查看中现有角色列表的权限 QuickSight。如果未提供此权限，则他们可以通过 ARN 来使用现有 IAM 角色。

    以下是 IAM 权限策略示例，该策略允许在 Amazon 中管理资源级权限、列出 IAM 角色和传递 IAM 角色。 QuickSight

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iam:ListRoles",
            "Resource": "arn:aws:iam::account-id:role:*"
        },
        {
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": "arn:aws:iam::account-id:role/path/role-name",
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": [
                        "quicksight.amazonaws.com"
                    ]
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "quicksight:UpdateResourcePermissions",
            "Resource": "*"
        }
    ]
}

    有关可与配合使用的 IAM 策略的更多示例 QuickSight，请参阅Amazon 的 IAM 政策示例 QuickSight。

有关为用户或用户组分配权限策略的详细信息，请参阅《IAM 用户指南》中的更改 IAM 用户的权限。

管理员完成先决条件后，您的 IAM 用户可以将 IAM 角色传递给 QuickSight。他们通过在注册时选择 IAM 角色或在他们的 “ QuickSight安全和权限” 页面switching to an IAM role上选择一个 IAM 角色来完成此操作。 QuickSight要了解如何切换到中的现有 IAM 角色 QuickSight，请参阅以下部分。

附加其他策略

如果您使用的是其他 Amazon 服务，例如 Amazon Athena 或 Amazon S3，则可以创建权限策略来授 QuickSight 予执行特定操作的权限。然后，您可以将该策略附加到稍后传递给的 IAM 角色 QuickSight。以下是如何设置其他权限策略并将其附加到您的 IAM 角色的示例。

有关 Athena QuickSight 中的托管策略示例，AWSQuicksightAthenaAccess 请参阅 Amazon A thena 用户指南中的托管策略。IAM 用户 QuickSight 可以使用以下 ARN 访问此角色：。arn:aws:iam::aws:policy/service-role/AWSQuicksightAthenaAccess

以下是 Amazon S3 QuickSight 中的权限策略示例。有关在 Amazon S3 中使用 IAM 的更多信息，请参阅《Amazon S3 用户指南》中的 Amazon S3 中的身份和访问管理。

有关如何创建跨账户访问另一个账户中的 Amazon S3 存储桶的信息，请参阅如何设置从 QuickSight亚马逊 QuickSight 到另一个账户中的 Amazon S3 存储桶的跨账户访问权限？ 在 Amazon 知识中心中。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "s3:ListAllMyBuckets",
            "Resource": "arn:aws:s3:::*"
        },
        {
            "Action": [
                "s3:ListBucket"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:s3:::aws-athena-query-results-us-west-2-123456789"
            ]
        },
        {
            "Action": [
                "s3:GetObject",
                "s3:GetObjectVersion"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:s3:::aws-athena-query-results-us-west-2-123456789/*"
            ]
        },
        {
            "Action": [
                "s3:ListBucketMultipartUploads",
                "s3:GetBucketLocation"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:s3:::aws-athena-query-results-us-west-2-123456789"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:AbortMultipartUpload",
                "s3:ListMultipartUploadParts"
            ],
            "Resource": [
                "arn:aws:s3:::aws-athena-query-results-us-west-2-123456789/*"
            ]
        }
    ]
}

使用亚马逊中的现有 IAM 角色 QuickSight

如果您是 QuickSight 管理员并且有权更新 QuickSight 资源和传递 IAM 角色，则可以在中使用现有 IAM 角色 QuickSight。要详细了解传入 IAM 角色的先决条件 QuickSight，请参阅前面列表中prerequisites概述的。

使用以下过程来学习如何传入 IAM 角色 QuickSight。

在中使用现有 IAM 角色 QuickSight

  1. 在中 QuickSight，在右上角的导航栏中选择您的账户名，然后选择管理 QuickSight。

  2. 在打开的 “管理 QuickSight” 页面上，在左侧菜单中选择 “安全与权限”。

  3. 在打开的 “安全与权限” 页面中，在 “ Amazon 服务QuickSight 访问权限” 下，选择 “管理”。

  4. 对于 IAM 角色，选择使用现有角色，然后执行以下操作之一：

    • 从列表中选择要使用的角色。

    • 或者，如果您没有看到现有 IAM 角色的列表，则可以按以下格式输入角色的 IAM ARN：arn:aws:iam::account-id:role/path/role-name。

  5. 选择保存。