View a markdown version of this page

联合事件数据存储 - Amazon CloudTrail
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

联合事件数据存储

注意

Amazon CloudTrail 从2026年5月31日起,Lake将不再向新客户开放。如果你想使用 CloudTrail Lake,在该日期之前注册。现有客户可以继续正常使用该服务。有关更多信息,请参阅 CloudTrail 湖泊可用性变更。

联合事件数据存储允许您在中查看与事件数据存储相关的元数据 Amazon Glue 数据目录,将数据目录注册到 Amazon Lake Formation,并允许您使用亚马逊 Athena 对事件数据运行 SQL 查询。表元数据存储在 Amazon Glue 数据目录让 Athena 查询引擎知道如何查找、读取和处理要查询的数据。

您可以使用启用联邦 CloudTrail 控制台, Amazon CLI,或 EnableFederation API 操作。当您启用 Lake 查询联盟时, CloudTrail 创建名为的托管数据库 aws:cloudtrail (如果数据库尚不存在)和中托管的联合表 Amazon Glue 数据目录。事件数据存储 ID 用作表名。 CloudTrail 注册联盟角色 ARN 和事件数据存储在中 Amazon Lake Formation,该服务负责允许对中的联合资源进行细粒度的访问控制 Amazon Glue 数据目录。

要启用 Lake 查询联合身份验证,您必须创建新的 IAM 角色或选择现有角色。Lake Formation 使用此角色管理联合事件数据存储的权限。当您使用创建新角色时 CloudTrail 控制台, CloudTrail 自动为角色创建所需的权限。如果您选择现有角色,请确保该角色提供最低权限。

你可以使用禁用联邦 CloudTrail 控制台, Amazon CLI,或 DisableFederation API 操作。当你禁用联盟时, CloudTrail 禁用与的集成 Amazon Glue, Amazon Lake Formation,还有亚马逊雅典娜。禁用 Lake 查询联合身份验证后,您将无法再在 Athena 中查询事件数据。没有 CloudTrail 禁用联盟后,湖泊数据将被删除,您可以继续在中运行查询 CloudTrail 湖。

没有 CloudTrail 联邦 a 的费用 CloudTrail 湖泊事件数据存储。在 Amazon Athena 中运行查询将会产生费用。有关 Athena 定价的更多信息,请参阅 Amazon Athena 定价。

注意事项

联合事件数据存储时,请考虑以下因素:

  • 没有 CloudTrail 联邦 a 的费用 CloudTrail 湖泊事件数据存储。在 Amazon Athena 中运行查询将会产生费用。有关 Athena 定价的更多信息,请参阅 Amazon Athena 定价。

  • Lake Formation 用于管理联合资源的权限。如果您从 Lake Formation 中删除联盟角色或撤消对资源的权限,或 Amazon Glue,你无法运行来自 Athena 的查询。有关使用 Lake Formation 的更多信息,请参阅 管理 CloudTrail 湖泊联邦资源包括 Amazon Lake Formation。

  • 使用 Amazon Athena 查询向 Lake Formation 注册的数据的任何人都必须有一个 IAM 权限策略,此权限允许执行 lakeformation:GetDataAccess 操作。这个 Amazon 管理策略: AmazonAthenaFullAccess 允许此操作。如果您使用内联策略,请务必更新权限策略以允许此操作。有关更多信息,请参阅管理 Lake Formation 和 Athena 用户权限。

  • 要在 Athena 中的联合表上创建视图,您需要一个除 aws:cloudtrail 之外的目标数据库。这是因为 aws:cloudtrail 数据库由管理 CloudTrail。

  • 要在中创建数据集 Amazon Quick,你必须选择 使用自定义 SQL 选项。有关更多信息,请参阅使用 Amazon Athena 数据创建数据集。

  • 如果启用了联合身份验证,则无法删除事件数据存储。要删除联合事件数据存储,必须先禁用联合身份验证和终止保护(如果已启用)。

  • 以下注意事项适用于组织事件数据存储:

    • 只有一个委托管理员账户或管理账户才能在组织事件数据存储上启用联合身份验证。其他委托管理员账户仍可以使用 Lake Formation 数据共享功能查询和共享信息。

    • 任何委托管理员账户或组织的管理账户都可以禁用联合身份验证。

联合身份验证所需的权限

在联合事件数据存储之前,请确保您拥有联合身份验证角色以及启用和禁用联合身份验证所需的所有权限。如果您选择现有 IAM 角色来启用联合身份验证,则只需要更新联合身份验证角色权限。如果您选择使用创建新的 IAM 角色 CloudTrail 控制台, CloudTrail 为角色提供所有必需的权限。

联合事件数据存储的 IAM 权限

启用联合身份验证时,您可以选择创建新的 IAM 角色,也可以使用现有 IAM 角色。当您选择新的 IAM 角色时, CloudTrail 创建具有所需权限的 IAM 角色,您无需采取进一步的操作。

如果您选择现有角色,请确保 IAM 角色的策略提供启用联合身份验证所需的权限。此部分提供所需 IAM 角色权限和信任策略的示例。

以下示例提供联合身份验证角色的权限策略。在第一个声明中,请提供 Resource 的事件数据存储的完整 ARN。

本策略的第二个声明允许 Lake Formation 解密使用 KMS 密钥加密的事件数据存储的数据。替换 key-region, account-id,以及 key-id 使用您的 KMS 密钥的值。如果事件数据存储未使用 KMS 密钥进行加密,则可省略此声明。

JSON
{ "Version":"2012-10-17", "Statement": [ { "Sid": "LakeFederationEDSDataAccess", "Effect": "Allow", "Action": "cloudtrail:GetEventDataStoreData", "Resource": "arn:aws:cloudtrail:us-east-1:111111111111:eventdatastore/eds-id" }, { "Sid": "LakeFederationKMSDecryptAccess", "Effect": "Allow", "Action": [ "kms:Decrypt", "kms:GenerateDataKey" ], "Resource": "arn:aws:kms:us-east-1:111111111111:key/key-id" } ] }

以下示例提供了 IAM 信任策略,该策略允许 Amazon Lake Formation 代入 IAM 角色以管理联合事件数据存储的权限。

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

启用联合身份验证所需的权限

以下示例策略提供了在事件数据存储上启用联合身份验证所需的最低权限。此政策允许 CloudTrail 要在事件数据存储上启用联邦, Amazon Glue 在中创建联合资源 Amazon Glue 数据目录,以及 Amazon Lake Formation 管理资源注册。

JSON
{ "Version":"2012-10-17", "Statement": [ { "Sid": "CloudTrailEnableFederation", "Effect": "Allow", "Action": "cloudtrail:EnableFederation", "Resource": "arn:aws:cloudtrail:us-east-1:111111111111:eventdatastore/eds-id" }, { "Sid": "FederationRoleAccess", "Effect": "Allow", "Action": [ "iam:PassRole", "iam:GetRole" ], "Resource": "arn:aws:iam::111122223333:role/federation-role-name" }, { "Sid": "GlueResourceCreation", "Effect": "Allow", "Action": [ "glue:CreateDatabase", "glue:CreateTable", "glue:PassConnection" ], "Resource": [ "arn:aws:glue:us-east-1:111111111111:catalog", "arn:aws:glue:us-east-1:111111111111:database/aws:cloudtrail", "arn:aws:glue:us-east-1:111111111111:table/aws:cloudtrail/eds-id", "arn:aws:glue:us-east-1:111111111111:connection/aws:cloudtrail" ] }, { "Sid": "LakeFormationRegistration", "Effect": "Allow", "Action": [ "lakeformation:RegisterResource", "lakeformation:DeregisterResource" ], "Resource": "arn:aws:lakeformation:region:111111111111:catalog:111111111111" } ] }

禁用联合身份验证所需的权限

以下示例策略提供了在事件数据存储上禁用联合身份验证所需的最低资源。此政策允许 CloudTrail 要在事件数据存储上禁用联邦, Amazon Glue 删除中托管的联合表 Amazon Glue 数据目录和 Lake Formation 用于注销联合资源。

JSON
{ "Version":"2012-10-17", "Statement": [ { "Sid": "CloudTrailDisableFederation", "Effect": "Allow", "Action": "cloudtrail:DisableFederation", "Resource": "arn:aws:cloudtrail:us-east-1:111111111111:eventdatastore/eds-id" }, { "Sid": "GlueTableDeletion", "Effect": "Allow", "Action": "glue:DeleteTable", "Resource": [ "arn:aws:glue:us-east-1:111111111111:catalog", "arn:aws:glue:us-east-1:111111111111:database/aws:cloudtrail", "arn:aws:glue:us-east-1:111111111111:table/aws:cloudtrail/eds-id" ] }, { "Sid": "LakeFormationDeregistration", "Effect": "Allow", "Action": "lakeformation:DeregisterResource", "Resource": "arn:aws:lakeformation:us-east-1:111111111111:catalog:111111111111" } ] }