使用 Secrets Manager 保护敏感数据 - Amazon ECS
有关使用 Secrets Manager 指定敏感数据的注意事项密钥 Amazon ECS 机密所需的 IAM 权限让您的应用程序以编程方式检索 Secrets Manager 密钥在任务定义中引用 Secrets Manager 密钥注入日志配置中的敏感数据创建 Amazon Secrets Manager 密钥在经典控制台中创建引用了敏感数据的任务定义
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

使用 Secrets Manager 保护敏感数据

Amazon ECS 使您能够向容器中注入敏感数据，方法是将您的敏感数据存储在 Amazon Secrets Manager 密钥中，然后在容器定义中引用它们。存储在 Secrets Manager 密钥中的敏感数据可以作为环境变量或作为日志配置的一部分提供给容器。

将密钥注入为环境变量时，可以指定密钥的完整内容、密钥中的特定 JSON 密钥或要注入的密钥的特定版本。这将帮助您控制提供给容器的敏感数据。有关密钥版本控制的更多信息，请参阅 Amazon Secrets Manager 用户指南中的 Amazon Secrets Manager 主要术语和概念。

有关使用 Secrets Manager 指定敏感数据的注意事项

在使用 Secrets Manager 指定容器的敏感数据时，请考虑以下事项。

  • 对于 Amazon Fargate 上的 Amazon ECS 任务，请考虑以下事项：

    • 要将密钥的完整内容注入为环境变量或注入到日志配置中，您必须使用版本 1.3.0 或更高版本的平台。有关信息，请参阅 Amazon Fargate 平台版本。

    • 要将特定 JSON 密钥或密钥版本注入为环境变量或注入到日志配置中，您必须使用平台版本 1.4.0 或更高版本（Linux）或者 1.0.0（Windows）。有关信息，请参阅 Amazon Fargate 平台版本。

  • 仅存储文本数据的机密，这些机密是使用 SecretString 参数 CreateSecret 支持 API。不支持存储二进制数据的密钥，这些数据是使用 CreateSecret API 的 SecretBinary 参数创建的密钥。

  • 当使用引用 Secrets Manager 密钥以检索容器的敏感数据的任务定义时，如果您还在使用接口 VPC 端点，则必须为 Secrets Manager 创建接口 VPC 端点。有关更多信息，请参阅 Amazon Secrets Manager 用户指南中的将 Secrets Manager 与 VPC 端点结合使用。

  • 最初启动容器时，会将敏感数据注入容器中。如果随后更新或轮换密钥，则容器将不会自动接收更新后的值。您必须启动新任务，或者如果您的任务是服务的一部分，则可以更新服务并使用 Force new deployment（强制新部署）选项来强制服务启动新任务。

  • 您的任务使用的 VPC 必须启用 DNS 解析。

密钥 Amazon ECS 机密所需的 IAM 权限

要使用此功能，您必须具有 Amazon ECS 任务执行角色，并在任务定义中引用它。这允许容器代理提取必要的 Secrets Manager 资源。有关更多信息，请参阅 Amazon ECS 任务执行 IAM 角色。

要提供对您创建的 Secrets Manager 密钥的访问权限，请将以下权限作为内联策略手动添加到任务执行角色。有关更多信息，请参阅添加和删除 IAM policy。

  • secretsmanager:GetSecretValue– 引用 Secrets Manager 密钥时的必填项。

  • kms:Decrypt - 仅当您的密钥使用自定义 KMS 密钥而不是原定设置密钥时才需要。您的自定义密钥的 ARN 必须添加为资源。

以下示例内联策略会添加所需权限。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "secretsmanager:GetSecretValue",
        "kms:Decrypt"
      ],
      "Resource": [
        "arn:aws:secretsmanager:<region>:<aws_account_id>:secret:<secret_name>",
        "arn:aws:kms:<region>:<aws_account_id>:key/<key_id>"
      ]
    }
  ]
}

让您的应用程序以编程方式检索 Secrets Manager 密钥

在任务定义中引用 Secrets Manager 密钥

在容器定义中，可以指定以下内容：

  • secrets 对象，该对象包含要在容器中设置的环境变量名称

  • Secrets Manager 密钥的 Amazon Resource Name (ARN)。

  • 其他参数，这些参数包含要提供给容器的敏感数据

以下示例显示必须为 Secrets Manager 密钥指定的完整语法。

arn:aws:secretsmanager:region:aws_account_id:secret:secret-name

下一部分介绍了其他参数。这些参数是可选的，但如果您不使用它们，则必须包含冒号 : 以使用默认值。下面提供了示例，以便您了解更多上下文。

json-key

使用要设置为环境变量值的值指定密钥-值对中密钥的名称。仅支持 JSON 格式的值。如果未指定 JSON 密钥，则使用密钥的完整内容。

version-stage

指定要使用的密钥版本的暂存标签。如果指定了版本的暂存标签，则无法指定版本 ID。如果未指定版本阶段，则默认行为是使用 AWSCURRENT 暂存标签检索密钥。

暂存标签用于在更新或轮换密钥的各个版本时对其进行跟踪。密钥的每个版本均有一个或多个暂存标签和一个 ID。有关更多信息，请参阅 Amazon Secrets Manager 用户指南中的 Amazon Secrets Manager 主要术语和概念。

version-id

指定要使用的密钥版本的唯一标识符。如果指定了版本 ID，则无法指定版本暂存标签。如果未指定版本 ID，则默认行为是使用 AWSCURRENT 暂存标签检索密钥。

版本 ID 用于在更新或轮换密钥的各个版本时对其进行跟踪。密码的每个版本均有一个 ID。有关更多信息，请参阅 Amazon Secrets Manager 用户指南中的 Amazon Secrets Manager 主要术语和概念。

有关如何创建 Secrets Manager 密钥并将其作为环境变量注入容器中的完整教程，请参阅教程：使用 Secrets Manager 密钥指定敏感数据。

示例容器定义

以下示例说明了可用于在容器定义中引用 Secrets Manager 密钥的方法。

例 引用完整密钥

以下是任务定义的片段，其中显示引用 Secrets Manager 密钥的完全文本时的格式。

{
  "containerDefinitions": [{
    "secrets": [{
      "name": "environment_variable_name",
      "valueFrom": "arn:aws:secretsmanager:region:aws_account_id:secret:secret_name-AbCdEf"
    }]
  }]
}
例 引用密钥中的特定密钥

下面显示了 get-secret-value 命令中的示例输出，其中显示了密钥的内容以及与之关联的版本暂存标签和版本 ID。

{
    "ARN": "arn:aws:secretsmanager:region:aws_account_id:secret:appauthexample-AbCdEf",
    "Name": "appauthexample",
    "VersionId": "871d9eca-18aa-46a9-8785-981ddEXAMPLE",
    "SecretString": "{\"username1\":\"password1\",\"username2\":\"password2\",\"username3\":\"password3\"}",
    "VersionStages": [
        "AWSCURRENT"
    ],
    "CreatedDate": 1581968848.921
}

通过在 ARN 的末尾指定密钥名称，引用容器定义中的上一个输出中的特定密钥。

{
  "containerDefinitions": [{
    "secrets": [{
      "name": "environment_variable_name",
      "valueFrom": "arn:aws:secretsmanager:region:aws_account_id:secret:appauthexample-AbCdEf:username1::"
    }]
  }]
}
例 引用特定的密钥版本

下面显示了 describe-secret 命令中的示例输出，其中显示了密钥的未加密内容以及密钥的所有版本的元数据。

{
    "ARN": "arn:aws:secretsmanager:region:aws_account_id:secret:appauthexample-AbCdEf",
    "Name": "appauthexample",
    "Description": "Example of a secret containing application authorization data.",
    "RotationEnabled": false,
    "LastChangedDate": 1581968848.926,
    "LastAccessedDate": 1581897600.0,
    "Tags": [],
    "VersionIdsToStages": {
        "871d9eca-18aa-46a9-8785-981ddEXAMPLE": [
            "AWSCURRENT"
        ],
        "9d4cb84b-ad69-40c0-a0ab-cead3EXAMPLE": [
            "AWSPREVIOUS"
        ]
    }
}

通过在 ARN 的末尾指定密钥名称，引用容器定义中的上一个输出中的特定版本暂存标签。

{
  "containerDefinitions": [{
    "secrets": [{
      "name": "environment_variable_name",
      "valueFrom": "arn:aws:secretsmanager:region:aws_account_id:secret:appauthexample-AbCdEf::AWSPREVIOUS:"
    }]
  }]
}

通过在 ARN 的末尾指定密钥名称，引用容器定义中的上一个输出中的特定版本 ID。

{
  "containerDefinitions": [{
    "secrets": [{
      "name": "environment_variable_name",
      "valueFrom": "arn:aws:secretsmanager:region:aws_account_id:secret:appauthexample-AbCdEf:::9d4cb84b-ad69-40c0-a0ab-cead3EXAMPLE"
    }]
  }]
}

注入日志配置中的敏感数据

在容器定义中，当指定 logConfiguration 时，您可以同时指定 secretOptions，方法是使用要在容器中设置的日志驱动程序选项的名称，以及包含要提供给容器的敏感数据的 Secrets Manager 密钥的完整 Amazon 资源名称（ARN）。

以下是任务定义的片段，其中显示引用 Secrets Manager 密钥时的格式。

{
  "containerDefinitions": [{
    "logConfiguration": [{
      "logDriver": "splunk",
      "options": {
        "splunk-url": "https://cloud.splunk.com:8080"
      },
      "secretOptions": [{
        "name": "splunk-token",
        "valueFrom": "arn:aws:secretsmanager:region:aws_account_id:secret:secret_name-AbCdEf"
      }]
    }]
  }]
}

创建 Amazon Secrets Manager 密钥

您可以使用 Secrets Manager 控制台为您的敏感数据创建密钥。有关更多信息，请参阅 Amazon Secrets Manager 用户指南中的创建基本密钥。

创建基本密钥

使用 Secrets Manager 为您的敏感数据创建密钥

  1. 在 https://console.aws.amazon.com/secretsmanager/ 打开 Secrets Manager 控制台

  2. 选择 Store a new secret (存储新密钥)。

  3. 对于选择密钥类型，选择其他密钥类型。

  4. 以 Key (键) 和 Value (值) 对的形式指定自定义密钥的详细信息。例如，您可以指定键 UserName，然后提供适当的用户名作为其值。添加名为 Password 的第二个键并将密码文本作为其值。您还可以为数据库名称、服务器地址以及 TCP 端口等添加条目。您可以添加所需数量的对以存储所需的信息。

    或者，您也可以选择 Plaintext (明文) 选项卡，并以所需的任何方式输入密钥值。

  5. 选择要用于加密密钥中的受保护文本的 Amazon KMS 加密密钥。如果您没有选择一个，则 Secrets Manager 会检查账户是否存在原定设置密钥并在存在时使用它。如果不存在原定设置密钥，则 Secrets Manager 将自动为您创建一个。您也可以选择添加新密钥以创建专用于该密钥的自定义 KMS 键。要创建您自己的 KMS 键，您必须具有在您的账户中创建 KMS 键的权限。

  6. 选择 Next（下一步）。

  7. 对于密钥名称，请键入可选的路径和名称，如 production/MyAwesomeAppSecret 或 development/TestSecret，然后选择下一步。您可以选择添加描述以帮助记住该密钥以后的用途。

    密钥名称应仅包含 ASCII 字母、数字或以下任意字符：/_+=.@-。

  8. (可选) 此时，您可以为密钥配置轮换。对于此程序，请将其保留为禁用自动轮换，然后选择下一步。

    有关如何为新的或现有的密钥配置轮换的信息，请参阅轮换 Amazon Secrets Manager 密钥。

  9. 检查您的设置，然后选择 Store secret（存储密钥）以将输入的所有内容作为新密钥保存在 Secrets Manager 中。

在经典控制台中创建引用了敏感数据的任务定义

可以使用 Amazon ECS 控制台创建引用了 Secrets Manager 密钥的任务定义。

创建指定密钥的任务定义

  1. 打开位于 https://console.aws.amazon.com/ecs/的 Amazon ECS 控制台。

  2. 在导航窗格中，依次选择 Task Definitions (任务定义) 和 Create new Task Definition (创建新任务定义)。

  3. 在 Select launch type compatibility (选择启动类型兼容性) 页面上，选择任务的启动类型，然后选择 Next step (下一步)。

  4. 在 task definition Name (任务定义名称) 中，为任务定义键入名称。最多能包含 255 个字母 (大写和小写字母)、数字、连字符和下划线。

  5. 对于 Task execution role (任务执行角色)，选择现有任务执行角色，或者选择 Create new role (创建新角色) 为您创建一个此类角色。此角色授权 Amazon ECS 提取任务的私有映像。有关更多信息，请参阅 私有注册表身份验证所需的 IAM 权限。

    重要

    如果 Task execution role（任务执行角色）字段未显示，请选择 Configure via JSON（通过 JSON 配置）并手动添加 executionRoleArn 字段来指定您的任务执行角色。以下代码显示语法：

    "executionRoleArn": "arn:aws:iam::aws_account_id:role/ecsTaskExecutionRole"

  6. 对于您的任务定义中要创建的每个容器，请完成以下步骤：

    1. 在 Container Definitions (容器定义) 下，选择 Add container (添加容器)。

    2. 对于 Container name (容器名称)，键入容器的名称。最多能包含 255 个字母 (大写和小写字母)、数字、连字符和下划线。

    3. 对于 Image (映像)，键入映像名称或到您私有映像的路径。最多能包含 255 个字母 (大写和小写字母)、数字、连字符和下划线。

    4. 展开 Advanced container configuration (高级容器配置)。

    5. 对于要注入为环境变量的敏感数据，请在 Environment (环境) 下，为 Environment variables (环境变量) 填写以下字段：

      1. 对于 Key (键)，输入要在容器中设置的环境变量的名称。此选项对应于容器定义的 secrets 部分中的 name 字段。

      2. 对于 Value (值)，选择 ValueFrom。对于Add value (添加值)，请输入包含要作为环境变量提供给容器的数据的 Secrets Manager 密钥 ARN。

    6. 对于在容器的日志配置中引用的敏感数据，请在 Storage and Logging（存储和日志记录）下，为 Log configuration（日志配置）填写以下字段：

      1. 清除 Auto-configure CloudWatch Logs 选项。

      2. 在 Log options (日志选项) 下，对于 Key (密钥)，输入要设置的日志配置选项。

      3. 对于 Value (值)，选择 ValueFrom。对于 Add value (添加值)，请输入包含要作为日志选项提供给日志配置的数据的 Secrets Manager 密钥的完整 ARN。

    7. 填写剩余的必填字段和要在您的容器定义中使用的任何可选字段。更多容器定义参数将可用于 Advanced container configuration (高级容器配置) 菜单中。有关更多信息，请参阅 任务定义参数。

    8. 选择 Add（添加）。

  7. 当添加您的容器时，请选择 Create (创建)。