Amazon CloudTrail 如何使用 Amazon KMS

本节介绍 Amazon KMS 如何与使用 SSE-KMS 密钥加密的 CloudTrail 跟踪配合使用。

重要

Amazon CloudTrail 和 Amazon S3 仅支持对称 Amazon KMS keys。不能使用非对称 KMS 密钥来加密您的 CloudTrail 日志。如需帮助确定 KMS 密钥是对称的还是非对称的，请参阅《Amazon Key Management Service 开发人员指南》中的识别不同的密钥类型。

当 CloudTrail 读取或写入使用 SSE-KMS 密钥加密的日志文件时，您无需支付密钥使用费。但是，当您访问使用 SSE-KMS 密钥加密的 CloudTrail 日志文件时，您需要支付密钥使用费。有关 Amazon KMS 定价的信息，请参阅 Amazon Key Management Service 定价。有关 CloudTrail 定价的信息，请参阅 Amazon CloudTrail 定价。

了解何时对跟踪使用 KMS 密钥

“使用 Amazon S3 上的 Amazon KMS 构建加密 CloudTrail 日志文件”功能，称为“使用 Amazon KMS key 的服务器端加密 (SSE-KMS)”。要了解有关 SSE-KMS 的更多信息，请参阅《Amazon Simple Storage Service 用户指南》中的使用具有 Amazon KMS 密钥的服务器端加密 (SSE-KMS)。

当您将 Amazon CloudTrail 配置为使用 SSE-KMS 加密您的日志文件时，CloudTrail 和 Amazon S3 会在您借助这些服务执行特定操作时使用 Amazon KMS keys。以下部分说明了这些服务将何时以及如何使用您的 KMS 密钥，并提供了您可以用于验证此说明的其他信息。

导致 CloudTrail 和 Amazon S3 使用您的 KMS 密钥的操作

您可以将 CloudTrail 配置为使用 Amazon KMS key 加密日志文件

当您更新您的 CloudTrail 配置以使用您的 KMS 密钥时，CloudTrail 会发送一个 GenerateDataKey 请求到 Amazon KMS 以验证该 KMS 密钥是否存在以及 CloudTrail 是否有权使用该 KMS 密钥进行加密。CloudTrail 不使用生成的数据密钥。

GenerateDataKey 请求包括加密上下文的以下信息：

CloudTrail 跟踪的 Amazon Resource Name (ARN)
S3 存储桶的 ARN 和 CloudTrail 日志文件的传输路径

GenerateDataKey 请求会在您的 CloudTrail 日志中生成一个与以下示例类似的条目。当您看到与此类似的日志条目时，便可以确定 CloudTrail 调用了特定跟踪的 Amazon KMS GenerateDataKey 操作。Amazon KMS 使用特定 KMS 密钥创建了数据密钥。


{
    "eventVersion": "1.09",
    "userIdentity": {
        "type": "AWSService",
        "invokedBy": "cloudtrail.amazonaws.com"
    },
    "eventTime": "2024-12-06T20:14:46Z",
    "eventSource": "kms.amazonaws.com",
    "eventName": "GenerateDataKey",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "cloudtrail.amazonaws.com",
    "userAgent": "cloudtrail.amazonaws.com",
    "requestParameters": {
        "keySpec": "AES_256",
        "keyId": "arn:aws:kms:us-east-1:123456789012:key/example1-6736-4661-bf00-exampleeb770",
        "encryptionContext": {
            "aws:cloudtrail:arn": "arn:aws:cloudtrail:us-east-1:123456789012:trail/management-events",
            "aws:s3:arn": "arn:aws:s3:::amzn-s3-demo-logging-bucket-123456789012-9af1fb49/AWSLogs/123456789012/CloudTrail/us-east-1/2024/12/06/123456789012_CloudTrail_us-east-1_20241206T2010Z_TO50OLMG1hIQ1png.json.gz"
        }
    },
    "responseElements": null,
    "requestID": "a0555e85-7e8a-4765-bd8f-2222295558e1",
    "eventID": "e4f3557e-7dbd-4e37-a00a-d86c137d1111",
    "readOnly": true,
    "resources": [
        {
            "accountId": "123456789012",
            "type": "AWS::KMS::Key",
            "ARN": "arn:aws:kms:us-east-1:123456789012:key/example1-6736-4661-bf00-exampleeb770"
         }],
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "123456789012",
    "sharedEventID": "ce71d6be-0846-498e-851f-111a1af9078f",
    "eventCategory": "Management"
}

CloudTrail 将日志文件放入您的 S3 存储桶中

每次 CloudTrail 将日志文件放入 S3 存储桶中时，Amazon S3 会代表 CloudTrail 将 GenerateDataKey 请求发送到 Amazon KMS。为了响应该请求，Amazon KMS 会生成一个唯一的数据密钥，然后将该数据密钥的两个副本发送给 Amazon S3，一个为明文，另一个则使用指定的 KMS 密钥进行了加密。Amazon S3 使用明文数据密钥为 CloudTrail 日志文件加密，并在使用后尽快从内存中删除该明文数据密钥。Amazon S3 将加密的数据密钥与加密的日志文件一起存储为元数据。CloudTrail

GenerateDataKey 请求包括加密上下文的以下信息：

CloudTrail 跟踪的 Amazon Resource Name (ARN)
S3 对象的 ARN（CloudTrail 日志文件）

每个 GenerateDataKey 请求会在您的 CloudTrail 日志中生成一个与以下示例类似的条目。当您看到与此类似的日志条目时，便可以确定 CloudTrail 调用了特定跟踪的 Amazon KMS GenerateDataKey 操作来保护特定日志文件。Amazon KMS 使用指定的 KMS 密钥创建了数据密钥，该数据密钥在同一日志条目中显示了两次。


{
    "eventVersion": "1.09",
    "userIdentity": {
        "type": "AWSService",
        "invokedBy": "cloudtrail.amazonaws.com"
    },
    "eventTime": "2024-12-06T21:49:28Z",
    "eventSource": "kms.amazonaws.com",
    "eventName": "GenerateDataKey",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "cloudtrail.amazonaws.com",
    "userAgent": "cloudtrail.amazonaws.com",
    "requestParameters": {
        "encryptionContext": {
            "aws:cloudtrail:arn": "arn:aws:cloudtrail:us-east-1::trail/insights-trail",
            "aws:s3:arn": "arn:aws:s3:::amzn-s3-demo-logging-bucket1-123456789012-7867ab0c/AWSLogs/123456789012/CloudTrail/us-east-1/2024/12/06/123456789012_CloudTrail_us-east-1_20241206T2150Z_hVXmrJzjZk2wAM2V.json.gz"
        },
        "keySpec": "AES_256",
        "keyId": "arn:aws:kms:us-east-1:123456789012:key/example9-16ef-48ba-9163-example67a5a"
    },
    "responseElements": null,
    "requestID": "11117d14-9232-414a-b3d1-01bab4dc9f99",
    "eventID": "999e9a50-512c-4e2a-84a3-111a5f511111",
    "readOnly": true,
    "resources": [
        {
            "accountId": "123456789012",
            "type": "AWS::KMS::Key",
            "ARN": "arn:aws:kms:us-east-1:123456789012:key/example9-16ef-48ba-9163-example67a5a"
        }
    ],
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "123456789012",
    "sharedEventID": "5e663acc-b7fd-4cdd-8328-0eff862952fa",
    "eventCategory": "Management"
}

从 S3 存储桶中获得加密的日志文件

每次当您从您的 S3 存储桶中获得加密的 CloudTrail 日志文件时，Amazon S3 会代表您将 Decrypt 请求发送到 Amazon KMS 以将日志文件的加密数据密钥解密。为了响应该请求，Amazon KMS 使用您的 KMS 密钥将数据密钥解密，然后将明文数据密钥发送到 Amazon S3。Amazon S3 使用明文数据密钥为 CloudTrail 日志文件解密，并在使用后尽快从内存中删除该明文数据密钥。

Decrypt 请求包括加密上下文的以下信息：

CloudTrail 跟踪的 Amazon Resource Name (ARN)
S3 对象的 ARN（CloudTrail 日志文件）

每个 Decrypt 请求会在您的 CloudTrail 日志中生成一个与以下示例类似的条目。当您看到与此类似的日志条目时，便可以确定代入角色调用了特定跟踪和特定日志文件的 Amazon KMS Decrypt 操作。Amazon KMS 使用特定 KMS 密钥解密了数据密钥。


{
    "eventVersion": "1.09",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "AIDACKCEVSQ6C2EXAMPLE",
        "arn": "arn:aws:sts::123456789012:assumed-role/Admin",
        "accountId": "123456789012",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "AIDACKCEVSQ6C2EXAMPLE",
                "arn": "arn:aws:iam::123456789012:role/Admin",
                "accountId": "123456789012",
                "userName": "Admin"
            },
            "attributes": {
                "creationDate": "2024-12-06T22:04:04Z",
                "mfaAuthenticated": "false"
            }
        },
        "invokedBy": "AWS Internal"
    },
    "eventTime": "2024-12-06T22:26:34Z",
    "eventSource": "kms.amazonaws.com",
    "eventName": "Decrypt",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "AWS Internal",
    "userAgent": "AWS Internal",
    "requestParameters": {
        "encryptionContext": {
            "aws:cloudtrail:arn": "arn:aws:cloudtrail:us-east-1:123456789012:trail/insights-trail",
            "aws:s3:arn": "arn:aws:s3:::amzn-s3-demo-logging-bucket1-123456789012-7867ab0c/AWSLogs/123456789012/CloudTrail/us-east-1/2024/12/06/123456789012_CloudTrail_us-east-1_20241206T0000Z_aAAsHbGBdye3jp2R.json.gz"
        },
        "encryptionAlgorithm": "SYMMETRIC_DEFAULT"
    },
    "responseElements": null,
    "requestID": "1ab2d2d2-111a-2222-a59b-11a2b3832b53",
    "eventID": "af4d4074-2849-4b3d-1a11-a1aaa111a111",
    "readOnly": true,
    "resources": [
        {
            "accountId": "123456789012",
            "type": "AWS::KMS::Key",
            "ARN": "arn:aws:kms:us-east-1:123456789012:key/example9-16ef-48ba-9163-example67a5a"
        }
    ],
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "123456789012",
    "eventCategory": "Management",
    "sessionCredentialFromConsole": "true"
}

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

使用 Amazon CLI 为 CloudTrail 日志文件、摘要文件和事件数据存储启用和禁用加密

文档历史记录