亚马逊是如何QLDB与之合作的 IAM - 亚马逊 Quantum Ledger 数据库(亚马逊QLDB)

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

亚马逊是如何QLDB与之合作的 IAM

在使用管理IAM访问权限之前QLDB,请先了解哪些IAM功能可供使用QLDB。

重要

终止支持通知:现有客户可以在2025年7月31日终止支持QLDB之前使用亚马逊。有关更多详细信息,请参阅将亚马逊QLDB账本迁移到亚马逊 Aurora Postgr SQL e。

IAM您可以在 Amazon 上使用的功能 QLDB
IAM特征 QLDB支持

基于身份的策略

基于资源的策略

策略操作

策略资源

策略条件键

ACLs

ABAC(策略中的标签)

临时凭证

主体权限

服务角色

服务相关角色

要全面了解大多数IAM功能的使用 AWS 服务 方式QLDB和其他功能 AWS 服务 ,请参阅《IAM用户指南》IAM中的使用方法。

适用于 QLDB 的基于身份的策略

支持基于身份的策略:

基于身份的策略是可以附加到身份(例如IAM用户、用户组或角色)的JSON权限策略文档。这些策略控制用户和角色可在何种条件下对哪些资源执行哪些操作。要了解如何创建基于身份的策略,请参阅IAM用户指南中的使用客户托管策略定义自定义IAM权限

使用IAM基于身份的策略,您可以指定允许或拒绝的操作和资源,以及允许或拒绝操作的条件。您无法在基于身份的策略中指定主体,因为它适用于其附加的用户或角色。要了解可以在JSON策略中使用的所有元素,请参阅IAM用户指南中的IAMJSON策略元素参考

适用于 QLDB 的基于身份的策略示例

要查看QLDB基于身份的策略的示例,请参阅。Amazon 基于身份的政策示例 QLDB

QLDB 内基于资源的策略

支持基于资源的策略:

基于资源的JSON策略是您附加到资源的策略文档。基于资源的策略的示例包括IAM角色信任策略和 Amazon S3 存储桶策略。在支持基于资源的策略的服务中,服务管理员可以使用它们来控制对特定资源的访问。对于在其中附加策略的资源,策略定义指定主体可以对该资源执行哪些操作以及在什么条件下执行。您必须在基于资源的策略中指定主体。委托人可以包括账户、用户、角色、联合用户或 AWS 服务。

要启用跨账户访问权限,您可以将整个账户或另一个账户中的IAM实体指定为基于资源的策略中的委托人。将跨账户主体添加到基于资源的策略只是建立信任关系工作的一半而已。当委托人和资源处于不同位置时 AWS 账户,可信账户中的IAM管理员还必须向委托人实体(用户或角色)授予访问资源的权限。他们通过将基于身份的策略附加到实体以授予权限。但是,如果基于资源的策略向同一个账户中的主体授予访问权限,则不需要额外的基于身份的策略。有关更多信息,请参阅《IAM用户指南》IAM中的跨账户资源访问权限

适用于 QLDB 的策略操作

支持策略操作:

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

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

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

要查看QLDB操作列表,请参阅《服务授权参考》QLDB中的 Amazon 定义的操作

正在执行的策略操作在操作前QLDB使用以下前缀:

qldb

要在单个语句中指定多项操作,请使用逗号将它们隔开。

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

您也可以使用通配符(*)指定多个操作。例如,要指定以单词 Describe 开头的所有操作,包括以下操作:

"Action": "qldb:Describe*"

要通过在账本上运行 PartiQL 语句与QLDB交易数据API(QLDB会话)进行交互,必须按如下方式授予操作权限。SendCommand

"Action": "qldb:SendCommand"

有关 STANDARD 权限模式下的分类账,请参阅 PartiQL 权限参考,了解每个 PartiQL 命令所需的其他权限。

要查看QLDB基于身份的策略的示例,请参阅。Amazon 基于身份的政策示例 QLDB

的政策资源 QLDB

支持策略资源:

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

ResourceJSON策略元素指定要应用操作的一个或多个对象。语句必须包含 ResourceNotResource 元素。最佳做法是,使用资源的 Amazon 资源名称 (ARN) 来指定资源。对于支持特定资源类型(称为资源级权限)的操作,您可以执行此操作。

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

"Resource": "*"

要查看QLDB资源类型及其列表ARNs,请参阅《服务授权参考》QLDB中的 Amazon 定义的资源。要了解您可以为每种资源指定哪些操作,请参阅 Amazon 定义的操作QLDB。ARN

在中QLDB,主要资源是账本。QLDB还支持其他资源类型:。但是,只能在现有的分类账范围内创建索引和流。

QLDB表格是账本日记账中无序文档修订集合的实体化视图。在账本的STANDARD权限模式下,您必须创建IAM策略来授予在此表资源上运行 PartiQL 语句的权限。凭借对表资源的权限,您可以运行访问表当前状态的语句。您也可以使用内置 history() 函数查询表的修订历史记录。要了解更多信息,请参阅 开始使用 Amazon 中的标准权限模式 QLDB

注意

CREATE TABLE 语句创建一个具有唯一 ID 和所提供的表名的表。提供的表名称在所有活动表中必须是唯一的。但是,QLDB允许您停用表,因此可能会有多个非活动表共享相同的表名。因此,表资源ARNs指的是系统分配的唯一 ID,而不是用户定义的表名。

每个分类账还提供系统定义的目录资源,您可通过查询该资源列出分类账中的所有表和索引。有关QLDB数据对象模型的更多信息,请参阅Amazon 中的核心概念和术语 QLDB

这些资源具有与其ARNs关联的唯一性,如下表所示。

资源类型 ARN
ledger arn:${Partition}:qldb:${Region}:${Account}:ledger/${LedgerName}
table arn:${Partition}:qldb:${Region}:${Account}:ledger/${LedgerName}/table/${TableId}
catalog arn:${Partition}:qldb:${Region}:${Account}:ledger/${LedgerName}/information_schema/user_tables
stream arn:${Partition}:qldb:${Region}:${Account}:stream/${LedgerName}/${StreamId}

例如,要在语句中指定myExampleLedger资源,请使用以下内容ARN。

"Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger"

要在单个语句中指定多个资源,请ARNs用逗号分隔。

"Resource": [ "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger1", "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger2" ]

要查看QLDB基于身份的策略的示例,请参阅。Amazon 基于身份的政策示例 QLDB

QLDB 的策略条件键

支持特定于服务的策略条件键:

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

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

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

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

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

要查看QLDB条件密钥列表,请参阅《服务授权参考》QLDB中的 Amazon 条件密钥。要了解您可以使用条件键的操作和资源,请参阅 Amazon 定义的操作QLDB

PartiQLDropIndexPartiQLDropTable 操作支持 qldb:Purge 条件键。该条件键根据 PartiQL DROP 语句中指定的purge值过滤访问。但是,QLDB目前仅purge = true支持DROP INDEX语句和purge = falseDROP TABLE语句。其他QLDB操作支持一些全局条件键。

要查看QLDB基于身份的策略的示例,请参阅。Amazon 基于身份的政策示例 QLDB

中的访问控制列表 (ACLs) QLDB

支持ACLs:

访问控制列表 (ACLs) 控制哪些委托人(账户成员、用户或角色)有权访问资源。ACLs与基于资源的策略类似,尽管它们不使用JSON策略文档格式。

基于属性的访问控制 () ABAC QLDB

支持ABAC(策略中的标签):

基于属性的访问控制 (ABAC) 是一种基于属性定义权限的授权策略。在中 AWS,这些属性称为标签。您可以为IAM实体(用户或角色)和许多 AWS 资源附加标签。为实体和资源添加标签是的第一步。ABAC然后,您可以设计ABAC策略,允许在委托人的标签与他们尝试访问的资源上的标签匹配时进行操作。

ABAC在快速增长的环境中很有用,也有助于解决策略管理变得繁琐的情况。

要基于标签控制访问,您需要使用 aws:ResourceTag/key-nameaws:RequestTag/key-nameaws:TagKeys 条件键在策略的条件元素中提供标签信息。

如果某个服务对于每种资源类型都支持所有这三个条件键,则对于该服务,该值为。如果某个服务仅对于部分资源类型支持所有这三个条件键,则该值为部分

有关更多信息ABAC,请参阅《IAM用户指南》中的使用ABAC授权定义权限。要查看包含设置步骤的教程ABAC,请参阅IAM用户指南中的使用基于属性的访问控制 (ABAC)

有关为QLDB资源添加标签的更多信息,请参阅为 Amazon QLDB 资源添加标签

要查看基于身份的策略(用于根据资源上的标签来限制对该资源的访问)的示例,请参阅根据QLDB标签更新账本

在 QLDB 中使用临时凭证

支持临时凭证:

当你使用临时凭证登录时,有些 AWS 服务 不起作用。有关其他信息,包括哪些 AWS 服务 适用于临时证书 AWS 服务 ,请参阅《IAM用户指南》IAM中的 “适用于临时证书”。

如果您使用除用户名和密码之外的任何方法登录,则 AWS Management Console 使用的是临时证书。例如,当您 AWS 使用公司的单点登录 (SSO) 链接进行访问时,该过程会自动创建临时证书。当您以用户身份登录控制台,然后切换角色时,您还会自动创建临时凭证。有关切换角色的更多信息,请参阅《用户指南》中的从IAM用户切换到IAM角色(控制台)

您可以使用 AWS CLI 或手动创建临时证书 AWS API。然后,您可以使用这些临时证书进行访问 AWS。 AWS 建议您动态生成临时证书,而不是使用长期访问密钥。有关更多信息,请参阅中的临时安全证书IAM

QLDB 的跨服务主体权限

支持转发访问会话 (FAS):

当您使用IAM用户或角色在中执行操作时 AWS,您被视为委托人。使用某些服务时,您可能会执行一个操作,然后此操作在其他服务中启动另一个操作。FAS使用调用委托人的权限 AWS 服务以及 AWS 服务 向下游服务发出请求的请求。FAS只有当服务收到需要与其他 AWS 服务 或资源交互才能完成的请求时,才会发出请求。在这种情况下,您必须具有执行这两个操作的权限。有关提出FAS请求时的政策详情,请参阅转发访问会话

QLDB 的服务角色

支持服务角色:

服务IAM角色是服务代替您执行操作的角色。IAM管理员可以在内部创建、修改和删除服务角色IAM。有关更多信息,请参阅《IAM用户指南》 AWS 服务中的创建角色以向委派权限

警告

更改服务角色的权限可能会中断QLDB功能。只有在QLDB提供操作指导时才编辑服务角色。

QLDB支持ExportJournalToS3StreamJournalToKinesisAPI操作的服务角色,如下一节所述。

在中选择IAM角色 QLDB

在导出或流式传输日记区块时QLDB,必须选择一个角色QLDB以允许代表您向给定目标写入对象。如果您之前创建过服务角色,则会QLDB为您提供可供选择的角色列表。请务必选择一个角色,该角色允许访问您指定的 Amazon S3 存储桶进行导出,或者允许访问您指定的 Amazon Kinesis Data Streams 资源进行数据流。有关更多信息,请参阅 中的日记导出权限 QLDB直播权限在 QLDB

注意

要在请求日记导出或直播QLDB时将角色传递给,您必须拥有对IAM角色资源执行iam:PassRole操作的权限。这是对QLDB账本资源或QLDB流子资源执行操作qldb:ExportJournalToS3的权限qldb:StreamJournalToKinesis的补充。

QLDB 的服务相关角色

支持服务相关角色:

服务相关角色是一种与服务相关联的 AWS 服务服务角色。服务可以代入代表您执行操作的角色。服务相关角色出现在您的中 AWS 账户 ,并且归服务所有。IAM管理员可以查看但不能编辑服务相关角色的权限。

有关创建或管理服务相关角色的详细信息 AWS 服务 ,请参阅与一起使用IAM。在表中查找服务相关角色列中包含 Yes 的表。选择链接以查看该服务的服务相关角色文档。