管理 Amazon DocumentDB 资源的访问权限概述

管理 Amazon DocumentDB 资源的访问权限概述

每个 AWS 资源都归某个 AWS 账户所有，创建和访问资源的权限由权限策略进行管理。账户管理员可以向 IAM 身份（即：用户、组和角色）附加权限策略，某些服务（如 AWS Lambda）也支持向资源附加权限策略。

注意

账户管理员 (或管理员用户) 是具有管理员权限的用户。有关更多信息，请参阅 IAM 用户指南 中的 IAM 最佳实践。

在授予权限时，您要决定谁获得权限，获得对哪些资源的权限，以及您允许对这些资源执行的具体操作。

Amazon DocumentDB 的资源和操作

在 Amazon DocumentDB中，主要资源为集群。Amazon DocumentDB支持可与主要资源配合使用的其他资源，如实例、参数组 和事件订阅。这些资源称作子资源。

这些资源和子资源具有与其关联的唯一 Amazon 资源名称 (ARN)，如下表所示。

资源类型	ARN 格式
Cluster	`arn:aws:rds:region:account-id:cluster:db-cluster-name`
集群参数组	`arn:aws:rds:region:account-id:cluster-pg:cluster-parameter-group-name`
集群快照	`arn:aws:rds:region:account-id:cluster-snapshot:cluster-snapshot-name`
实例	`arn:aws:rds:region:account-id:db:db-instance-name`
安全组	`arn:aws:rds:region:account-id:secgrp:security-group-name`
子网组	`arn:aws:rds:region:account-id:subgrp:subnet-group-name`

Amazon DocumentDB 提供一组操作用来处理 Amazon DocumentDB 资源。有关可用操作的列表，请参阅操作。

了解资源所有权

资源所有者 是创建资源的 AWS 账户。也就是说，资源所有者是委托人实体（根账户、IAM 用户或 IAM 角色）的 AWS 账户。以下示例说明了它的工作原理：

如果您使用 AWS 账户的根账户凭证来创建 Amazon DocumentDB 资源（如实例），则您的 AWS 账户就是该 Amazon DocumentDB资源的所有者。
如果您在您的 AWS 账户中创建 IAM 用户并对该用户授予创建 Amazon DocumentDB 资源的权限，则该用户可以创建 Amazon DocumentDB 资源。但是，该用户所属的 AWS 账户拥有这些 Amazon DocumentDB 资源。
如果您在您的 AWS 账户中创建具有创建 Amazon DocumentDB 资源的权限的 IAM 角色，则能够担任该角色的任何人都可以创建 Amazon DocumentDB 资源。该角色所属的 AWS 账户拥有这些 Amazon DocumentDB 资源。

管理对资源的访问

权限策略 规定谁可以访问哪些内容。下一节介绍创建权限策略时的可用选项。

注意

本节介绍如何在 Amazon DocumentDB 范围内使用 IAM。它不提供有关 IAM 服务的详细信息。有关完整的 IAM 文档，请参阅 IAM 用户指南 中的什么是 IAM？有关 IAM 策略语法和说明的信息，请参阅 IAM 用户指南中的 AWS IAM 策略参考。

附加到 IAM 身份的策略称作基于身份的 策略（IAM 策略）。附加到资源的策略称作基于资源 的策略。Amazon DocumentDB 仅支持基于身份的策略（IAM 策略）。

基于身份的策略 (IAM 策略)

您可以向 IAM 身份挂载策略。例如，您可以执行以下操作：

将权限策略附加到您的账户中的用户或组 – 账户管理员可以使用与特定用户关联的权限策略授予该用户创建 Amazon DocumentDB 资源（如实例）的权限。
向角色附加权限策略（授予跨账户权限）– 您可以向 IAM 角色附加基于身份的权限策略，以授予跨账户的权限。例如，账户 A 中的管理员可以创建一个角色，以向其他 AWS 账户（如账户 B）或某项 AWS 服务授予跨账户权限，如下所述：
1. 账户 A 管理员创建一个 IAM 角色，向该角色挂载授权其访问账户 A 中资源的权限策略。
2. 账户 A 管理员可以向将账户 B 标识为能够代入该角色的委托人的角色附加信任策略。
3. 之后，账户 B 管理员可以委派权限，以指派账户 B 中的任何用户担任该角色。这样，账户 B 中的用户便可以创建或访问账户 A 中的资源。如果您需要向 AWS 服务授予相应的权限来担任该角色，则信任策略中的委托人还必须是 AWS 服务委托人。
有关使用 IAM 委派权限的更多信息，请参阅 https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html 中的IAM 用户指南访问权限管理。

以下是允许 ID 为 123456789012 的用户为您的 AWS 账户创建实例的示例策略。新实例必须使用以 default 开头的选项组和参数组，并且它必须使用 default 子网组。


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowCreateDBInstanceOnly",
            "Effect": "Allow",
            "Action": [
                "rds:CreateDBInstance"
            ],
            "Resource": [
                "arn:aws:rds:*:123456789012:db:test*",
                "arn:aws:rds:*:123456789012:pg:cluster-pg:default*",
                "arn:aws:rds:*:123456789012:subgrp:default"
            ]
        }
    ]
}

有关对 Amazon DocumentDB使用基于身份的策略的更多信息，请参阅为 Amazon DocumentDB使用基于身份的策略（IAM 策略）。有关用户、组、角色和权限的更多信息，请参阅 IAM 用户指南中的身份（用户、组和角色）。

基于资源的策略

其他服务（如 Amazon Simple Storage Service (Amazon S3)）也支持基于资源的权限策略。例如，您可以将基于资源的策略附加到 S3 存储桶以管理对该存储桶的访问权限。Amazon DocumentDB 不支持基于资源的策略。

指定策略元素: 操作、效果、资源和委托人

对于每种 Amazon DocumentDB 资源（请参阅 Amazon DocumentDB 的资源和操作），该服务都定义了一组 API 操作。有关更多信息，请参阅操作。为了授予执行这些 API 操作的权限，Amazon DocumentDB 定义了一组您可以在策略中指定的操作。执行一个 API 操作可能需要多个操作的权限。

以下是基本的策略元素：

Resource – 在策略中，您可以使用 Amazon 资源名称 (ARN) 标识策略应用到的资源。
操作 – 您可以使用操作关键字标识要允许或拒绝的资源操作。例如，rds:DescribeDBInstances 权限允许用户执行 DescribeDBInstances 操作。
Effect – 您可以指定当用户请求特定操作（可以是允许或拒绝）时的效果—。如果没有显式授予（允许）对资源的访问权限，则隐式拒绝访问。您也可显式拒绝对资源的访问，这样可确保用户无法访问该资源，即使有其他策略授予了访问权限的情况下也是如此。
Principal – 在基于身份的策略（IAM 策略）中，附加了策略的用户是隐式委托人。对于基于资源的策略，您可以指定要接收权限的用户、账户、服务或其他实体（仅适用于基于资源的策略）。Amazon DocumentDB 不支持基于资源的策略。

要了解 IAM 策略语法和说明的更多信息，请参阅 IAM 中的 AWS IAM 用户指南策略参考。

有关显示所有 Amazon DocumentDB API 操作及其适用的资源的表，请参阅 Amazon DocumentDB API 权限: 操作、资源和条件参考。

在策略中指定条件

当您授予权限时，可使用 IAM 策略语言来指定规定策略何时生效的条件。例如，您可能希望策略仅在特定日期后应用。有关使用策略语言指定条件的更多信息,请参阅 https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html#Condition 中的条件IAM 用户指南。

要表示条件，您可以使用预定义的条件键。Amazon DocumentDB没有可在 IAM 策略中使用的服务特定上下文键。有关适用于所有服务的全局条件上下文键的列表,请参阅 IAM 用户指南中的可用的条件键。

访问管理概述