Amazon QLDB 基于身份的策略示例 - Amazon Quantum Ledger Database (Amazon QLDB)

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

Amazon QLDB 基于身份的策略示例

默认情况下,用户和角色没有创建或修改 资源的权限。他们也无法使用 AWS Management Console、 AWS Command Line Interface (AWS CLI) 或 AWS API 执行任务。要授予用户对所需资源执行操作的权限,IAM 管理员可以创建 IAM 策略。管理员随后可以向角色添加 IAM 策略,用户可以代入角色。

要了解如何使用这些示例 JSON 策略文档创建基于 IAM 身份的策略,请参阅《IAM 用户指南》中的 创建 IAM policy

有关 QLDB 定义的操作和资源类型的详细信息,包括每种资源类型的 ARN 格式,请参阅《服务授权参考》 中的 Amazon QLDB 的操作、资源和条件密钥

策略最佳实践

基于身份的策略确定某个人是否可以创建、访问或删除您账户中的 资源。这些操作可能会使 AWS 账户产生成本。创建或编辑基于身份的策略时,请遵循以下准则和建议:

  • 开始使用 AWS 托管策略并转向最低权限权限 — 要开始向用户和工作负载授予权限,请使用为许多常见用例授予权限的AWS 托管策略。它们在你的版本中可用 AWS 账户。我们建议您通过定义针对您的用例的 AWS 客户托管策略来进一步减少权限。有关更多信息,请参阅《IAM 用户指南》中的 AWS 托管策略工作职能的AWS 托管策略

  • 应用最低权限 – 在使用 IAM 策略设置权限时,请仅授予执行任务所需的权限。为此,您可以定义在特定条件下可以对特定资源执行的操作,也称为最低权限许可。有关使用 IAM 应用权限的更多信息,请参阅《IAM 用户指南》中的 IAM 中的策略和权限

  • 使用 IAM 策略中的条件进一步限制访问权限 – 您可以向策略添加条件来限制对操作和资源的访问。例如,您可以编写策略条件来指定必须使用 SSL 发送所有请求。如果服务操作是通过特定的方式使用的,则也可以使用条件来授予对服务操作的访问权限 AWS 服务,例如 AWS CloudFormation。有关更多信息,请参阅《IAM 用户指南》中的 IAM JSON 策略元素:条件

  • 使用 IAM Access Analyzer 验证您的 IAM 策略,以确保权限的安全性和功能性 – IAM Access Analyzer 会验证新策略和现有策略,以确保策略符合 IAM 策略语言 (JSON) 和 IAM 最佳实践。IAM Access Analyzer 提供 100 多项策略检查和可操作的建议,以帮助您制定安全且功能性强的策略。有关更多信息,请参阅《IAM 用户指南》中的 IAM Acess Analyzer 策略验证

  • 需要多重身份验证 (MFA)-如果 AWS 账户您的场景需要 IAM 用户或根用户,请启用 MFA 以提高安全性。若要在调用 API 操作时需要 MFA,请将 MFA 条件添加到您的策略中。有关更多信息,请参阅《IAM 用户指南》中的 配置受 MFA 保护的 API 访问

有关 IAM 中的最佳实践的更多信息,请参阅《IAM 用户指南》中的 IAM 中的安全最佳实践

使用 QLDB 控制台

要访问 Amazon MQ 控制台,您必须具有一组最低的权限。这些权限必须允许您列出和查看有关您的 QLDB 资源的详细信息。 AWS 账户如果创建比必需的最低权限更为严格的基于身份的策略,对于附加了该策略的实体(用户或角色),控制台将无法按预期正常运行。

对于仅调用 AWS CLI 或 AWS API 的用户,您无需为其设置最低控制台权限。相反,只允许访问与其尝试执行的 API 操作相匹配的操作。

为确保用户和角色拥有对 QLDB 控制台及其所有功能的完全访问权限,请将 AWS 以下托管策略附加到实体。有关更多信息,请参阅 IAM 用户指南 中的 AWS 亚马逊 QLDB 的托管策略为用户添加权限

AmazonQLDBConsoleFullAccess

查询历史权限

除了 QLDB 权限外,某些控制台功能还需要 Database Query Metadata Service 的权限(服务前缀:dbqms)。这是一项仅限内部访问的服务,可在 QLDB 和其他 AWS 服务的控制台查询编辑器上管理您最近和保存的查询。有关DBQMS API操作的完整列表,请参阅 Service Authorization Reference 中的 Database Query Metadata Service

要允许查询历史记录权限,您可以使用 AWS 托管策略 AmazonQLDB ConsoleFullAccess。此策略使用通配符(dbqms:*)允许对所有资源执行所有 DBQMS 操作。

或者,您也可以创建自定义 IAM policy 并添加以下 DBQMS 操作。QLDB 控制台上的 PartiQL 查询编辑器需要具备使用这些操作的权限以支持查询历史功能。

dbqms:CreateFavoriteQuery dbqms:CreateQueryHistory dbqms:DeleteFavoriteQueries dbqms:DeleteQueryHistory dbqms:DescribeFavoriteQueries dbqms:DescribeQueryHistory dbqms:UpdateFavoriteQuery

没有查询历史记录的完全访问控制台权限

要允许在 QLDB 控制台上完全访问而需任何查询历史权限,您可以创建一个自定义 IAM policy,将所有 DBQMS 操作排除在外。例如,以下策略文档允许的权限与 AWS 托管策略 AmazonQLDB 授予的权限相同ConsoleFullAccess,但以服务前缀开头的操作除外dbqms

{ "Version": "2012-10-17", "Statement": [ { "Action": [ "qldb:CreateLedger", "qldb:UpdateLedger", "qldb:UpdateLedgerPermissionsMode", "qldb:DeleteLedger", "qldb:ListLedgers", "qldb:DescribeLedger", "qldb:ExportJournalToS3", "qldb:ListJournalS3Exports", "qldb:ListJournalS3ExportsForLedger", "qldb:DescribeJournalS3Export", "qldb:CancelJournalKinesisStream", "qldb:DescribeJournalKinesisStream", "qldb:ListJournalKinesisStreamsForLedger", "qldb:StreamJournalToKinesis", "qldb:GetBlock", "qldb:GetDigest", "qldb:GetRevision", "qldb:TagResource", "qldb:UntagResource", "qldb:ListTagsForResource", "qldb:SendCommand", "qldb:ExecuteStatement", "qldb:ShowCatalog", "qldb:InsertSampleData", "qldb:PartiQLCreateIndex", "qldb:PartiQLDropIndex", "qldb:PartiQLCreateTable", "qldb:PartiQLDropTable", "qldb:PartiQLUndropTable", "qldb:PartiQLDelete", "qldb:PartiQLInsert", "qldb:PartiQLUpdate", "qldb:PartiQLSelect", "qldb:PartiQLHistoryFunction" ], "Effect": "Allow", "Resource": "*" }, { "Action": [ "kinesis:ListStreams", "kinesis:DescribeStream" ], "Effect": "Allow", "Resource": "*" }, { "Effect": "Allow", "Action": "iam:PassRole", "Resource": "*", "Condition": { "StringEquals": { "iam:PassedToService": "qldb.amazonaws.com" } } } ] }

允许用户查看他们自己的权限

该示例说明了您如何创建策略,以允许 IAM 用户查看附加到其用户身份的内联和托管式策略。此策略包括在控制台上或使用 AWS CLI 或 AWS API 以编程方式完成此操作的权限。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "ViewOwnUserInfo", "Effect": "Allow", "Action": [ "iam:GetUserPolicy", "iam:ListGroupsForUser", "iam:ListAttachedUserPolicies", "iam:ListUserPolicies", "iam:GetUser" ], "Resource": ["arn:aws:iam::*:user/${aws:username}"] }, { "Sid": "NavigateInConsole", "Effect": "Allow", "Action": [ "iam:GetGroupPolicy", "iam:GetPolicyVersion", "iam:GetPolicy", "iam:ListAttachedGroupPolicies", "iam:ListGroupPolicies", "iam:ListPolicyVersions", "iam:ListPolicies", "iam:ListUsers" ], "Resource": "*" } ] }

正在运行数据事务

要通过在分类账上运行 PartiQL 语句与 QLDB 事务数据 API(QLDB 会话)交互,您必须按照以下方式授予 SendCommand API 操作​​的权限。以下 JSON 文档是一个策略示例,该策略仅向分类账 SendCommand 上的 myExampleLedger API 操作授予权限。

要使用此政策,请将 us-ea st-1 123456789012 和示例中的信息替换为你自己的信息。myExampleLedger

{ "Version": "2012-10-17", "Statement": [ { "Sid": "QLDBSendCommandPermission", "Effect": "Allow", "Action": "qldb:SendCommand", "Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger" } ] }

如果 myExampleLedger 使用 ALLOW_ALL 权限模式,则此策略授予在分类账中的任何表上运行所有 PartiQL 命令的权限。

您也可以使用 AWS 托管策略授予对所有 QLDB 资源的完全访问权限。有关更多信息,请参阅 AWS 亚马逊 QLDB 的托管策略

PartiQL 操作和表资源的标准权限

对于 STANDARD 权限模式下的分类账,您可以参考以下 IAM policy 文档作为授予相应的 PartiQL 权限的示例。有关每个 PartiQL 命令所需权限的列表,请参阅 PartiQL 权限参考

允许对所有 操作的完全访问

以下 JSON 策略文档授予对 myExampleLedger 中的 所有 表使用所有 PartiQL 命令的完全访问权限。此策略产生的效果与对分类账使用 ALLOW_ALL 权限模式相同。

要使用此政策,请将 us-ea st-1 123456789012 和示例中的信息替换为你自己的信息。myExampleLedger

{ "Version": "2012-10-17", "Statement": [ { "Sid": "QLDBSendCommandPermission", "Effect": "Allow", "Action": "qldb:SendCommand", "Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger" }, { "Sid": "QLDBPartiQLFullPermissions", "Effect": "Allow", "Action": [ "qldb:PartiQLCreateIndex", "qldb:PartiQLDropIndex", "qldb:PartiQLCreateTable", "qldb:PartiQLDropTable", "qldb:PartiQLUndropTable", "qldb:PartiQLDelete", "qldb:PartiQLInsert", "qldb:PartiQLUpdate", "qldb:PartiQLRedact", "qldb:PartiQLSelect", "qldb:PartiQLHistoryFunction" ], "Resource": [ "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger/table/*", "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger/information_schema/user_tables" ] } ] }

基于表格标签对所有操作的完全访问权限

以下 JSON 策略文档授予对 myExampleLedger 中的 所有 表使用基于表资源标签的条件来授予 所有 PartiQL 命令的完全访问权限。只有当表标签 environment 具有值 development 时,才会授予权限。

警告

这是使用通配符(*)允许全部 PartiQL 操作的示例,包括对 QLDB 分类账中的所有表的管理和读/写操作。相反,最佳实践是明确指定要授予的每个操作以及仅指定该用户、角色或组需要的操作。

要使用此政策,请将 us-ea st-1 123456789012 和示例中的信息替换为你自己的信息。myExampleLedger

{ "Version": "2012-10-17", "Statement": [ { "Sid": "QLDBSendCommandPermission", "Effect": "Allow", "Action": "qldb:SendCommand", "Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger" }, { "Sid": "QLDBPartiQLFullPermissionsBasedOnTags", "Effect": "Allow", "Action": [ "qldb:PartiQL*" ], "Resource": [ "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger/table/*", "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger/information_schema/user_tables" ], "Condition": { "StringEquals": { "aws:ResourceTag/environment": "development" } } } ] }

读/写入权限

以下 JSON 策略文档授予选择、插入、更新和删除 myExampleLedger 中所有表的数据的权限。此策略不授予密文数据或更改架构的权限,例如,创建和删除表和索引。

注意

一个 UPDATE 语句需要对正在修改的表执行的 qldb:PartiQLUpdateqldb:PartiQLSelect 操作都具有权限。运行 UPDATE 语句时,除了更新操作外,它还会执行读取操作。要求这两个操作可以确保只有被允许读取表格内容的用户才会被授予 UPDATE 权限。

同样,一个 DELETE 语句需要同时具有 qldb:PartiQLDeleteqldb:PartiQLSelect 操作的权限。

要使用此政策,请将 us-ea st-1 123456789012 和示例中的信息替换为你自己的信息。myExampleLedger

{ "Version": "2012-10-17", "Statement": [ { "Sid": "QLDBSendCommandPermission", "Effect": "Allow", "Action": "qldb:SendCommand", "Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger" }, { "Sid": "QLDBPartiQLReadWritePermissions", "Effect": "Allow", "Action": [ "qldb:PartiQLDelete", "qldb:PartiQLInsert", "qldb:PartiQLUpdate", "qldb:PartiQLSelect", "qldb:PartiQLHistoryFunction" ], "Resource": [ "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger/table/*", "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger/information_schema/user_tables" ] } ] }

只读访问权限

以下 JSON 策略文档授予对 myExampleLedger 中所有表的只读权限。要使用此政策,请将 us-ea st-1 123456789012 和示例中的信息替换为你自己的信息。myExampleLedger

{ "Version": "2012-10-17", "Statement": [ { "Sid": "QLDBSendCommandPermission", "Effect": "Allow", "Action": "qldb:SendCommand", "Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger" }, { "Sid": "QLDBPartiQLReadOnlyPermissions", "Effect": "Allow", "Action": [ "qldb:PartiQLSelect", "qldb:PartiQLHistoryFunction" ], "Resource": [ "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger/table/*", "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger/information_schema/user_tables" ] } ] }

对特定表的只读访问

以下 JSON 策略文档授予对 myExampleLedger 中特定表的只读权限。在此示例中,ID 为Au1EiThbt8s0z9wM26REZN

要使用此政策,请用您自己的信息替换示例中的 us-east-1 123456789012 和 Au1 8s0z9wm26Rez myExampleLedgern。EiThbt

{ "Version": "2012-10-17", "Statement": [ { "Sid": "QLDBSendCommandPermission", "Effect": "Allow", "Action": "qldb:SendCommand", "Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger" }, { "Sid": "QLDBPartiQLReadOnlyPermissionsOnTable", "Effect": "Allow", "Action": [ "qldb:PartiQLSelect", "qldb:PartiQLHistoryFunction" ], "Resource": [ "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger/table/Au1EiThbt8s0z9wM26REZN" ] } ] }

允许访问创建表

以下 JSON 策略文档授予在 myExampleLedger 中创建表的权限。qldb:PartiQLCreateTable 操作需要对表资源类型的权限。但是,在运行一个 CREATE TABLE 语句时,新表的表 ID 尚不清楚。因此,授予 qldb:PartiQLCreateTable 权限的策略必须在表 ARN 中使用通配符(*)来指定资源。

要使用此政策,请将 us-ea st-1 123456789012 和示例中的信息替换为你自己的信息。myExampleLedger

{ "Version": "2012-10-17", "Statement": [ { "Sid": "QLDBSendCommandPermission", "Effect": "Allow", "Action": "qldb:SendCommand", "Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger" }, { "Sid": "QLDBPartiQLCreateTablePermission", "Effect": "Allow", "Action": [ "qldb:PartiQLCreateTable" ], "Resource": [ "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger/table/*" ] } ] }

允许访问基于请求标签创建表

以下 JSON 策略文档使用基于 aws:RequestTag 上下文密钥的条件来授予在中创建表的权限 myExampleLedger。只有当请求标签 environment 具有值时,才会授予权限 development。在创建时为表添加标签,需要同时访问 qldb:PartiQLCreateTableqldb:TagResource 操作。要了解如何在创建表时标记表,请参阅 为表格添加标签

要使用此政策,请将 us-ea st-1 123456789012 和示例中的信息替换为你自己的信息。myExampleLedger

{ "Version": "2012-10-17", "Statement": [ { "Sid": "QLDBSendCommandPermission", "Effect": "Allow", "Action": "qldb:SendCommand", "Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger" }, { "Sid": "QLDBPartiQLCreateTablePermission", "Effect": "Allow", "Action": [ "qldb:PartiQLCreateTable", "qldb:TagResource" ], "Resource": [ "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger/table/*" ], "Condition": { "StringEquals": { "aws:RequestTag/environment": "development" } } } ] }

将快照导出到 Amazon S3 存储桶

步骤 1:QLDB 日记账导出权限

在以下示例中,您授予用户对 QLDB 账本资源执行qldb:ExportJournalToS3操作的 AWS 账户 权限。您还可以授予对要传递给 QLDB 服务的 IAM 角色资源执行 iam:PassRole 操作的权限。这是所有日记账流请求所必需的。

要使用此政策,请将示例中的 us-ea st-1、123456789012 myExampleLedger和 ql d b-s3-export 替换为你自己的信息。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "QLDBJournalExportPermission", "Effect": "Allow", "Action": "qldb:ExportJournalToS3", "Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger" }, { "Sid": "IAMPassRolePermission", "Effect": "Allow", "Action": "iam:PassRole", "Resource": "arn:aws:iam::123456789012:role/qldb-s3-export", "Condition": { "StringEquals": { "iam:PassedToService": "qldb.amazonaws.com" } } } ] }

步骤 3:设置 Amazon S3 存储桶上的权限

在以下示例中,您使用 IAM 角色向 QLDB 授予写入您的 Amazon S3 存储桶 DOC-EXAMPLE-BUCKET 的访问权限。所有 QLDB 日记账导出也是必需的。

除了授予 s3:PutObject 权限外,该策略还授予 s3:PutObjectAcl 权限以设置对对象的访问控制列表(ACL)权限。

要使用此策略,请将 DOC-EXAMPLE-BUCKET 替换为 Amazon S3 存储桶的名称。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "QLDBJournalExportS3Permissions", "Effect": "Allow", "Action": [ "s3:PutObject", "s3:PutObjectAcl" ], "Resource": "arn:aws:s3:::DOC-EXAMPLE-BUCKET/*" } ] }

然后,将此权限策略附加到 QLDB 可代入您的 Amazon S3 存储桶的 IAM 角色。以下 JSON 文档是信任策略的示例,该策略仅允许 QLDB 为账户 123456789012 中的任何 QLDB 资源担任 IAM 角色。

要使用此策略,请将示例中的 us-east-1123456789012 12 替换为您自己的信息。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "qldb.amazonaws.com" }, "Action": [ "sts:AssumeRole" ], "Condition": { "ArnEquals": { "aws:SourceArn": "arn:aws:qldb:us-east-1:123456789012:*" }, "StringEquals": { "aws:SourceAccount": "123456789012" } } } ] }

将日记账流式传输到 Kinesis Data Streams

第 1 步:QLDB 日记账流权限

在以下示例中,您授予用户对 AWS 账户 账本中的所有 QLDB 流子资源执行qldb:StreamJournalToKinesis操作的权限。您还可以授予对要传递给 QLDB 服务的 IAM 角色资源执行 iam:PassRole 操作的权限。这是所有日记账流请求所必需的。

要使用此政策,请使用您自己的信息替换示例中的 us-east-1 1234567890 myExampleLedger12 和。qldb-kinesis-stream

{ "Version": "2012-10-17", "Statement": [ { "Sid": "QLDBJournalStreamPermission", "Effect": "Allow", "Action": "qldb:StreamJournalToKinesis", "Resource": "arn:aws:qldb:us-east-1:123456789012:stream/myExampleLedger/*" }, { "Sid": "IAMPassRolePermission", "Effect": "Allow", "Action": "iam:PassRole", "Resource": "arn:aws:iam::123456789012:role/qldb-kinesis-stream", "Condition": { "StringEquals": { "iam:PassedToService": "qldb.amazonaws.com" } } } ] }

第 2 步:Kinesis Data Streams 权限

在以下示例中,您使用 IAM 角色向 QLDB 授予向您的 Amazon Kinesis 数据流写入数据记录的权限。stream-for-qldb这是所有日记账流请求所必需的。

要使用此政策,请将 us-ea st-1 123456789012 和示例中的信息替换为你自己的信息。stream-for-qldb

{ "Version": "2012-10-17", "Statement": [ { "Sid": "QLDBStreamKinesisPermissions", "Action": [ "kinesis:PutRecord*", "kinesis:DescribeStream", "kinesis:ListShards" ], "Effect": "Allow", "Resource": "arn:aws:kinesis:us-east-1:123456789012:stream/stream-for-qldb" } ] }

然后,您将此权限策略附加到 QLDB 可以代入的 IAM 角色来访问您的 Kinesis 数据流。以下 JSON 文档是信任策略的示例,该策略允许 QLDB 仅为分类账 myExampleLedger 账户 123456789012 中的任何 QLDB 流担任 IAM 角色。

要使用此政策,请将 us-ea st-1 123456789012 和示例中的信息替换为你自己的信息。myExampleLedger

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "qldb.amazonaws.com" }, "Action": [ "sts:AssumeRole" ], "Condition": { "ArnEquals": { "aws:SourceArn": "arn:aws:qldb:us-east-1:123456789012:stream/myExampleLedger/*" }, "StringEquals": { "aws:SourceAccount": "123456789012" } } } ] }

根据标签更新 QLDB 分类账

您可以在基于身份的策略中使用条件,以便基于标签控制对 资源的访问。该示例说明了如何创建策略以允许查看队组。不过,只有在事物标签 Owner 具有该用户的用户名值时,才会授予权限。此策略还授予在控制台上完成此操作的必要权限。

{ "Version": "2012-10-17", "Statement": [ { "Sid": "ListLedgersInConsole", "Effect": "Allow", "Action": "qldb:ListLedgers", "Resource": "*" }, { "Sid": "UpdateLedgerIfOwner", "Effect": "Allow", "Action": "qldb:UpdateLedger", "Resource": "arn:aws:qldb:*:*:ledger/*", "Condition": { "StringEquals": {"aws:ResourceTag/Owner": "${aws:username}"} } } ] }

您可以将此策略附加到您账户中的用户。如果名为 richard-roe 的用户尝试更新 QLDB 分类账,则必须对该分类账进行标记 Owner=richard-roeowner=richard-roe。否则,他将被拒绝访问。条件标签键 Owner 匹配 Ownerowner,因为条件键名称不区分大小写。有关更多信息,请参阅《IAM 用户指南》中的 IAM JSON 策略元素:条件