Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

旋转 Amazon KMS keys

要为客户托管的密钥创建新的加密材料，您可以创建新的 KMS 密钥，然后更改您的应用程序或别名来使用新的 KMS 密钥。或者，您可以通过启用自动密钥轮换或按需轮换来轮换与现有 KMS 密钥关联的密钥材料。

默认情况下，当您为 KMS 密钥启用自动密钥轮换时，每年会为 KMS 密钥 Amazon KMS 生成新的加密材料。您还可以指定自定义，rotation-period以定义启用自动密钥轮换以轮换密钥材料后的天数，以及此后每次自动轮换之间的天数。 Amazon KMS 如果您需要立即启动密钥材料轮换，则无论是否启用了自动密钥轮换，都可以按需轮换。按需轮换不会更改现有的自动轮换计划。

Amazon KMS 永久保存所有先前版本的加密材料，因此您可以解密使用该 KMS 密钥加密的任何数据。 Amazon KMS 在您删除 KMS 密钥之前，不会删除任何轮换的密钥材料。您可以在 Amazon CloudWatch 和 Amazon Key Management Service 控制台中跟踪 KMS 密钥的密钥材料的轮换情况。 Amazon CloudTrail您还可以使用GetKeyRotationStatus操作来验证 KMS 密钥是否启用了自动轮换，并识别任何正在进行的按需轮换。您可以使用ListKeyRotations操作来查看已完成旋转的详细信息。

当您使用轮换的 KMS 密钥加密数据时， Amazon KMS 使用当前的密钥材料。当您使用轮换的 KMS 密钥解密密文时，将 Amazon KMS 使用用于加密密文的密钥材料的版本。您无法为解密操作选择特定版本的密钥材料，而是 Amazon KMS 会自动选择正确的版本。由于使用适当的密钥材料进行 Amazon KMS 透明解密，因此您可以安全地在应用程序中使用轮换的 KMS 密钥，而 Amazon Web Services 无需更改代码。

然而，自动密钥轮换对 KMS 密钥所保护的数据无效。它不会轮换 KMS 密钥生成的数据密钥，也不会对任何受 KMS 密钥保护的数据重新加密，并且它无法减轻数据密钥泄露的影响。

Amazon KMS 仅支持对称加密 KMS 密钥使用 Amazon KMS 创建的密钥材料进行自动和按需密钥轮换。对于客户托管式 KMS 密钥，自动轮换是可选项。 Amazon KMS 始终坚持每年轮换一次 Amazon 托管式 KMS 密钥的密钥材料。所Amazon 拥有的 KMS 密钥的轮换由拥有该密钥的 Amazon 服务管理。

密钥轮换只会更改密钥材料，即加密操作中所使用的加密密钥。不管密钥材料有没有变更或变更了多少次，该 KMS 密钥仍是相同的逻辑资源。KMS 密钥的属性不会发生变化，如下图所示。

您可能决定创建新的 KMS 密钥来替代原有的 KMS 密钥。这跟轮换现有 KMS 密钥的密钥材料具有相同效果，因此这通常被视为手动轮换密钥。如果您想要轮换不符合自动密钥轮换条件的 KMS 密钥，包括非对称 KMS 密钥、HMAC KMS 密钥、自定义密钥存储中的 KMS 密钥以及带有导入密钥材料的 KMS 密钥，则手动轮换是一个不错的选择。

密钥轮换和定价

Amazon KMS 对为您的 KMS 密钥维护的密钥材料的第一次和第二次轮换收取月费。此次涨价以第二次轮换为上限，后续的任何轮换均不计费。有关详细信息，请参阅 Amazon Key Management Service 定价。

密钥轮换和配额

在计算密钥资源配额时，无论轮换密钥材料版本的数量如何，每个 KMS 密钥均算作一个密钥。

有关密钥材料和轮换的详细信息，请参阅《Amazon Key Management Service 加密详细信息》。

为什么要轮换 KMS 密钥？

加密最佳实践不鼓励大量重复使用直接加密数据的密钥，例如生成的数据密钥。 Amazon KMS 当 256 位数据密钥加密数百万条消息时，它们可能会耗尽并开始生成带有细微模式的加密文字，聪明的操作者可以利用这些密文来发现密钥中的位。为避免密钥耗尽，数据密钥最好仅使用一次或几次，这样可以有效地轮换密钥材料。

但是，KMS 密钥最常用作“包装密钥”，也称为“密钥加密密钥”。包装密钥不是加密数据，而是对加密数据的数据密钥进行加密。因此，其使用频率远低于数据密钥，并且几乎从未被重复使用到足以出现密钥耗尽的风险。

尽管耗尽风险非常低，但由于业务或合同规则或政府法规，您可能需要轮换 KMS 密钥。当您被迫轮换 KMS 密钥时，我们建议您在支持自动密钥轮换的情况下使用自动密钥轮换，在不支持自动密钥轮换时使用手动密钥轮换。

您可以考虑按需轮换，以演示关键材料轮换功能或验证自动化脚本。我们建议对计划外轮换使用按需轮换，并尽可能使用带有自定义轮换周期的自动密钥轮换。

密钥轮换的工作原理

密钥轮换设计 Amazon KMS 为透明且易于使用。 Amazon KMS 仅支持客户托管密钥的可选自动和按需密钥轮换。

如何启用和禁用自动密钥轮换

默认情况下，当您为 KMS 密钥启用自动密钥轮换时，每年会为 KMS 密钥 Amazon KMS 生成新的加密材料。您还可以指定自定义，rotation-period以定义启用自动密钥轮换以轮换密钥材料后的天数，以及此后每次自动轮换之间的天数。 Amazon KMS

自动密钥轮换具有以下优点：

授权用户可以使用 Amazon KMS 控制台和 Amazon KMS API 来启用和禁用自动密钥轮换，并查看密钥轮换状态。

启用和禁用自动密钥轮换（控制台）

启用和禁用自动密钥轮换 (Amazon KMS API)

您可以使用 Amazon Key Management Service (Amazon KMS) API 启用和禁用自动密钥轮换，并查看任何客户托管密钥的当前轮换状态。这些示例使用 Amazon Command Line Interface (Amazon CLI)，但您可以使用任何受支持的编程语言。

该EnableKeyRotation操作可为指定的 KMS 密钥启用自动密钥轮换。该DisableKeyRotation操作将其禁用。要在这些操作中标识 KMS 密钥，请使用其密钥 ID 或密钥 ARN。在默认情况下，客户托管密钥的密钥轮换处于禁用状态。

您可以使用 k ms: RotationPeriodInDays 条件键来限制委托人可以为EnableKeyRotation请求的RotationPeriodInDays参数指定的值。

以下示例在指定的对称加密 KMS 密钥上启用密钥轮换，轮换周期为 180 天，并使用该GetKeyRotationStatus操作来查看结果。然后，它禁用了密钥轮换，并使用 GetKeyRotationStatus 查看更改。

$ aws kms enable-key-rotation \
    --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \
    --rotation-period-in-days 180

$ aws kms get-key-rotation-status --key-id 1234abcd-12ab-34cd-56ef-1234567890ab
{
    "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "KeyRotationEnabled": true,
    "RotationPeriodInDays": 180,
    "NextRotationDate": "2024-02-14T18:14:33.587000+00:00"
}

$ aws kms disable-key-rotation --key-id 1234abcd-12ab-34cd-56ef-1234567890ab

$ aws kms get-key-rotation-status --key-id 1234abcd-12ab-34cd-56ef-1234567890ab
{
    "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "KeyRotationEnabled": false
}
            

如何执行按需密钥轮换

无论是否启用了自动密钥轮换，您都可以按需轮换客户托管的 KMS 密钥中的密钥材料。禁用自动轮换 (DisableKeyRotation) 不会影响您执行按需轮换的能力，也不会取消任何正在进行的按需轮换。按需轮换不会更改现有的自动轮换计划。例如，假设一个启用了自动密钥轮换、轮换周期为 730 天的 KMS 密钥。如果密钥计划在 2024 年 4 月 14 日自动轮换，而您在 2024 年 4 月 10 日按需轮换，则密钥将按计划在 2024 年 4 月 14 日自动轮换，此后每 730 天自动轮换一次。

每个 KMS 密钥最多可以按需轮换 10 次。您可以使用 Amazon KMS 控制台查看 KMS 密钥的剩余按需轮换次数。

仅对称加密 KMS 密钥支持按需密钥轮换。您无法按需轮换非对称 KMS 密钥、HMAC KMS 密钥、带有导入密钥材料的 KMS 密钥或自定义密钥存储中的 KMS 密钥。要按需轮换一组相关的多区域密钥，请调用主密钥的按需轮换。

授权用户可以使用 Amazon KMS 控制台和 Amazon KMS API 启动按需密钥轮换并查看密钥轮换状态。

启动按需密钥轮换（控制台）

启动按需密钥轮换 (Amazon KMS API)

您可以使用 Amazon Key Management Service (Amazon KMS) API 启动按需密钥轮换，并查看任何客户托管密钥的当前轮换状态。这些示例使用 Amazon Command Line Interface (Amazon CLI)，但您可以使用任何受支持的编程语言。

该RotateKeyOnDemand操作会立即启动指定的 KMS 密钥的按需密钥轮换。要在这些操作中标识 KMS 密钥，请使用其密钥 ID 或密钥 ARN。

以下示例在指定的对称加密 KMS 密钥上启动按需密钥轮换，并使用该GetKeyRotationStatus操作验证按需轮换是否正在进行中。kms:GetKeyRotationStatus响应OnDemandRotationStartDate中的标识了启动正在进行的按需轮换的日期和时间。

$ aws kms rotate-key-on-demand --key-id 1234abcd-12ab-34cd-56ef-1234567890ab
{
    "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"    
}

$ aws kms get-key-rotation-status --key-id 1234abcd-12ab-34cd-56ef-1234567890ab
{
    "KeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "KeyRotationEnabled": true,
    "NextRotationDate": "2024-03-14T18:14:33.587000+00:00",
    "OnDemandRotationStartDate": "2024-02-24T18:44:48.587000+00:00"
    "RotationPeriodInDays": 365    
}

手动轮换密钥

您可能希望创建一个新的 KMS 密钥，并使用它替代当前的 KMS 密钥，而不启用自动密钥轮换。当新的 KMS 密钥使用的加密材料与当前 KMS 密钥使用的加密材料不相同时，使用新的 KMS 密钥与更改现有 KMS 密钥的密钥材料具有相同的效果。使用一个 KMS 密钥替换另一个 KMS 密钥的过程被称为手动密钥轮换。

如果您想要轮换不符合自动密钥轮换条件的 KMS 密钥，例如非对称 KMS 密钥、HMAC KMS 密钥、自定义密钥存储中的 KMS 密钥以及带有导入密钥材料的 KMS 密钥，则手动轮换是一个不错的选择。

当您手动轮换 KMS 密钥时，您还需要更新应用程序中对 KMS 密钥 ID 或密钥 ARN 的引用。将友好名称与 KMS 密钥关联的别名，可以使得这个过程变得更容易。使用别名来引用应用程序中的 KMS 密钥。之后，当您想更改应用程序所使用的 KMS 密钥（而不是编辑应用程序代码）时，更改别名的目标 KMS 密钥即可。有关更多信息，请参阅 在应用程序中使用别名。

要更改别名的目标 KMS 密钥，请使用 Amazon KMS API 中的UpdateAlias操作。例如，此命令会更新 alias/TestKey 别名以指向新 KMS 密钥。由于该操作不返回任何输出，因此该示例使用该ListAliases操作来显示别名现在已与其他 KMS 密钥相关联，并且该LastUpdatedDate字段已更新。这些 ListAliases 命令使用中的query参数仅 Amazon CLI 获取alias/TestKey别名。

$ aws kms list-aliases --query 'Aliases[?AliasName==`alias/TestKey`]'
{
    "Aliases": [
        {
            "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/TestKey",
            "AliasName": "alias/TestKey",
            "TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
            "CreationDate": 1521097200.123,
            "LastUpdatedDate": 1521097200.123
        },
    ]
}


$ aws kms update-alias --alias-name alias/TestKey --target-key-id 0987dcba-09fe-87dc-65ba-ab0987654321
            
$ aws kms list-aliases --query 'Aliases[?AliasName==`alias/TestKey`]'
{
    "Aliases": [
        {
            "AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/TestKey",
            "AliasName": "alias/TestKey",
            "TargetKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321",
            "CreationDate": 1521097200.123,
            "LastUpdatedDate": 1604958290.722
        },
    ]
}