本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 适用于亚马逊的身份和访问管理 ElastiCache Amazon Identity and Access Management(IAM)Amazon Web Services 服务可帮助管理员安全地控制对Amazon资源的访问权限。IAM 管理员控制谁可以*进行身份验证*（登录）和*授权*（拥有权限）使用 ElastiCache 资源。您可以使用 IAM Amazon Web Services 服务，无需支付额外费用。 **Topics** + [受众](#security_iam_audience) + [使用身份进行身份验证](#security_iam_authentication) + [使用策略管理访问](#security_iam_access-manage) + [亚马逊如何 ElastiCache 使用 IAM](security_iam_service-with-iam.md) + [Amazon 基于身份的政策示例 ElastiCache](security_iam_id-based-policy-examples.md) + [Amazon ElastiCache 身份和访问问题排查](security_iam_troubleshoot.md) + [访问控制](#iam.accesscontrol) + [管理 ElastiCache 资源访问权限概述](IAM.Overview.md) ## 受众 您的使用方式Amazon Identity and Access Management(IAM) 因您的角色而异： + **服务用户** – 如果您无法访问功能，请从管理员处请求权限（请参阅 [Amazon ElastiCache 身份和访问问题排查](security_iam_troubleshoot.md)） + **服务管理员** – 确定用户访问权限并提交权限请求（请参阅[亚马逊如何 ElastiCache 使用 IAM](security_iam_service-with-iam.md)） + **IAM 管理员** – 编写用于管理访问权限的策略（请参阅 [Amazon 基于身份的政策示例 ElastiCache](security_iam_id-based-policy-examples.md)） ## 使用身份进行身份验证 身份验证是您Amazon使用身份凭证登录的方式。您必须以 IAM 用户身份进行身份验证Amazon Web Services 账户根用户，或者通过担任 IAM 角色进行身份验证。 对于编程访问，Amazon提供 SDK 和 CLI 来对请求进行加密签名。有关更多信息，请参阅*《IAM 用户指南》*中的[适用于 API 请求的Amazon签名版本 4](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_sigv.html)。 ### Amazon Web Services 账户 root 用户 创建时Amazon Web Services 账户，首先会有一个名为Amazon Web Services 账户*root 用户的*登录身份，该身份可以完全访问所有资源Amazon Web Services 服务和资源。我们强烈建议不要使用根用户进行日常任务。有关需要根用户凭证的任务，请参阅《IAM 用户指南》**中的[需要根用户凭证的任务](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)。 ### 联合身份 作为最佳实践，要求人类用户使用与身份提供商的联合身份验证才能Amazon Web Services 服务使用临时证书进行访问。 *联合身份是指*来自您的企业目录、Web 身份提供商的用户Amazon Directory Service，或者Amazon Web Services 服务使用来自身份源的凭据进行访问的用户。联合身份代入可提供临时凭证的角色。 ### IAM 用户和群组 *[IAM 用户](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_users.html)*是对某个人员或应用程序具有特定权限的一个身份。我们建议使用临时凭证，而不是具有长期凭证的 IAM 用户。有关更多信息，请参阅 *IAM 用户指南*[中的要求人类用户使用身份提供商的联合身份验证才能Amazon使用临时证书进行访问](https://docs.amazonaws.cn/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp)。 [https://docs.amazonaws.cn/IAM/latest/UserGuide/id_groups.html](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_groups.html)指定一组 IAM 用户，便于更轻松地对大量用户进行权限管理。有关更多信息，请参阅*《IAM 用户指南》*中的 [IAM 用户使用案例](https://docs.amazonaws.cn/IAM/latest/UserGuide/gs-identities-iam-users.html)。 ### IAM 角色 *[IAM 角色](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_roles.html)*是具有特定权限的身份，可提供临时凭证。您可以通过[从用户切换到 IAM 角色（控制台）](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_roles_use_switch-role-console.html)或调用Amazon CLI或Amazon API 操作来代入角色。有关更多信息，请参阅《IAM 用户指南》**中的[担任角色的方法](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_roles_manage-assume.html)。 IAM 角色对于联合用户访问、临时 IAM 用户权限、跨账户访问、跨服务访问以及在 Amazon 上运行的应用程序非常有用。 EC2有关更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的跨账户资源访问](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)。 ## 使用策略管理访问 您可以Amazon通过创建策略并将其附加到Amazon身份或资源来控制中的访问权限。策略定义了与身份或资源关联时的权限。Amazon在委托人提出请求时评估这些政策。大多数策略都以 JSON 文档的Amazon形式存储在中。有关 JSON 策略文档的更多信息，请参阅*《IAM 用户指南》*中的 [JSON 策略概述](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies.html#access_policies-json)。 管理员使用策略，通过定义哪个**主体**可以在什么**条件**下对哪些**资源**执行哪些**操作**来指定谁有权访问什么。 默认情况下，用户和角色没有权限。IAM 管理员创建 IAM 策略并将其添加到角色中，然后用户可以担任这些角色。IAM 策略定义权限，与执行操作所用的方法无关。 ### 基于身份的策略 基于身份的策略是您附加到身份（用户、组或角色）的 JSON 权限策略文档。这些策略控制身份可以执行什么操作、对哪些资源执行以及在什么条件下执行。要了解如何创建基于身份的策略，请参阅《IAM 用户指南》**中的[使用客户管理型策略定义自定义 IAM 权限](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_create.html)。 基于身份的策略可以是*内联策略*（直接嵌入到单个身份中）或*托管策略*（附加到多个身份的独立策略）。要了解如何在托管策略和内联策略之间进行选择，请参阅*《IAM 用户指南》*中的[在托管策略与内联策略之间进行选择](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies-choosing-managed-or-inline.html)。 ### 基于资源的策略 基于资源的策略是附加到资源的 JSON 策略文档。示例包括 IAM *角色信任策略*和 Amazon S3 *存储桶策略*。在支持基于资源的策略的服务中，服务管理员可以使用它们来控制对特定资源的访问。您必须在基于资源的策略中[指定主体](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements_principal.html)。 基于资源的策略是位于该服务中的内联策略。您不能在基于资源的策略中使用 IAM 中的Amazon托管策略。 ### 其他策略类型 Amazon支持其他策略类型，这些策略类型可以设置更常见的策略类型授予的最大权限： + **权限边界** – 设置基于身份的策略可以授予 IAM 实体的最大权限。有关更多信息，请参阅《 IAM 用户指南》**中的 [IAM 实体的权限边界](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_boundaries.html)。 + **服务控制策略 (SCPs)**-在中指定组织或组织单位的最大权限Amazon Organizations。有关更多信息，请参阅《Amazon Organizations用户指南》**中的[服务控制策略](https://docs.amazonaws.cn/organizations/latest/userguide/orgs_manage_policies_scps.html)。 + **资源控制策略 (RCPs)**-设置账户中资源的最大可用权限。有关更多信息，请参阅《*Amazon Organizations用户指南》*中的[资源控制策略 (RCPs)](https://docs.amazonaws.cn/organizations/latest/userguide/orgs_manage_policies_rcps.html)。 + **会话策略** – 在为角色或联合用户创建临时会话时，作为参数传递的高级策略。有关更多信息，请参阅《IAM 用户指南》**中的[会话策略](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies.html#policies_session)。 ### 多个策略类型 当多个类型的策略应用于一个请求时，生成的权限更加复杂和难以理解。要了解在涉及多种策略类型时如何Amazon确定是否允许请求，请参阅 *IAM 用户指南*中的[策略评估逻辑](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_evaluation-logic.html)。 # 亚马逊如何 ElastiCache 使用 IAM 在使用 IAM 管理访问权限之前 ElastiCache，请先了解有哪些 IAM 功能可供使用 ElastiCache。 **您可以在 Amazon 上使用的 IAM 功能 ElastiCache** | IAM 功能 | ElastiCache 支持 | | --- | --- | | [基于身份的策略](#security_iam_service-with-iam-id-based-policies) | 是 | | [基于资源的策略](#security_iam_service-with-iam-resource-based-policies) | 否 | | [策略操作](#security_iam_service-with-iam-id-based-policies-actions) | 是 | | [策略资源](#security_iam_service-with-iam-id-based-policies-resources) | 是 | | [策略条件键](#security_iam_service-with-iam-id-based-policies-conditionkeys) | 支持 | | [ACLs](#security_iam_service-with-iam-acls) | 是 | | [ABAC（策略中的标签）](#security_iam_service-with-iam-tags) | 是 | | [临时凭证](#security_iam_service-with-iam-roles-tempcreds) | 是 | | [主体权限](#security_iam_service-with-iam-principal-permissions) | 是 | | [服务角色](#security_iam_service-with-iam-roles-service) | 是 | | [服务关联角色](#security_iam_service-with-iam-roles-service-linked) | 是 | 要全面了解 ElastiCache 以及其他Amazon服务如何与大多数 IAM 功能配合使用，请参阅 IAM *用户指南中的与 IAM* [配合使用的Amazon服务](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。 ## 基于身份的策略 ElastiCache **支持基于身份的策略：**是 基于身份的策略是可附加到身份（如 IAM 用户、用户组或角色）的 JSON 权限策略文档。这些策略控制用户和角色可在何种条件下对哪些资源执行哪些操作。要了解如何创建基于身份的策略，请参阅《IAM 用户指南》**中的[使用客户管理型策略定义自定义 IAM 权限](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_create.html)。 通过使用 IAM 基于身份的策略，您可以指定允许或拒绝的操作和资源以及允许或拒绝操作的条件。要了解可在 JSON 策略中使用的所有元素，请参阅《IAM 用户指南》**中的 [IAM JSON 策略元素引用](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements.html)。 ### ElastiCache 基于身份的策略示例 要查看 ElastiCache 基于身份的策略的示例，请参阅。[Amazon 基于身份的政策示例 ElastiCache](security_iam_id-based-policy-examples.md) ## ElastiCache 内基于资源的策略 **支持基于资源的策略：**否 基于资源的策略是附加到资源的 JSON 策略文档。基于资源的策略的示例包括 IAM *角色信任策略*和 Amazon S3 *存储桶策略*。在支持基于资源的策略的服务中，服务管理员可以使用它们来控制对特定资源的访问。对于在其中附加策略的资源，策略定义指定主体可以对该资源执行哪些操作以及在什么条件下执行。您必须在基于资源的策略中[指定主体](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements_principal.html)。委托人可以包括账户、用户、角色、联合用户或Amazon Web Services 服务。 要启用跨账户访问，您可以将整个账户或其他账户中的 IAM 实体指定为基于资源的策略中的主体。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的跨账户资源访问](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)。 ## 的政策行动 ElastiCache **支持策略操作：**是 管理员可以使用Amazon JSON 策略来指定谁有权访问什么。也就是说，哪个**主体**可以对什么**资源**执行**操作**，以及在什么**条件**下执行。 JSON 策略的 `Action` 元素描述可用于在策略中允许或拒绝访问的操作。在策略中包含操作以授予执行关联操作的权限。 要查看 ElastiCache 操作列表，请参阅《*服务授权参考*》 ElastiCache中的 [Amazon 定义的操作](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazonelasticache.html#amazonelasticache-actions-as-permissions)。 正在执行的策略操作在操作前 ElastiCache 使用以下前缀： ``` elasticache ``` 要在单个语句中指定多项操作，请使用逗号将它们隔开。 ``` "Action": [ "elasticache:action1", "elasticache:action2" ] ``` 您也可以使用通配符（\$1）指定多个操作。例如，要指定以单词 `Describe` 开头的所有操作，包括以下操作： ``` "Action": "elasticache:Describe*" ``` 要查看 ElastiCache 基于身份的策略的示例，请参阅。[Amazon 基于身份的政策示例 ElastiCache](security_iam_id-based-policy-examples.md) ## 的政策资源 ElastiCache **支持策略资源：**是 管理员可以使用Amazon JSON 策略来指定谁有权访问什么。也就是说，哪个**主体**可以对什么**资源**执行**操作**，以及在什么**条件**下执行。 `Resource` JSON 策略元素指定要向其应用操作的一个或多个对象。作为最佳实践，请使用其 [Amazon 资源名称（ARN）](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference-arns.html)指定资源。对于不支持资源级权限的操作，请使用通配符 (\$1) 指示语句应用于所有资源。 ``` "Resource": "*" ``` 要查看 ElastiCache 资源类型及其列表 ARNs，请参阅《*服务授权参考*》 ElastiCache中的 [Amazon 定义的资源](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazonelasticache.html#amazonelasticache-resources-for-iam-policies)。要了解您可以使用哪些操作来指定每种资源的 ARN，请参阅 [Amazon 定义的操作](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazonelasticache.html#amazonelasticache-actions-as-permissions)。 ElastiCache 要查看 ElastiCache 基于身份的策略的示例，请参阅。[Amazon 基于身份的政策示例 ElastiCache](security_iam_id-based-policy-examples.md) ## ElastiCache 的策略条件键 **支持特定于服务的策略条件键：**是 管理员可以使用Amazon JSON 策略来指定谁有权访问什么。也就是说，哪个**主体**可以对什么**资源**执行**操作**，以及在什么**条件**下执行。 `Condition` 元素根据定义的条件指定语句何时执行。您可以创建使用[条件运算符](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)（例如，等于或小于）的条件表达式，以使策略中的条件与请求中的值相匹配。要查看所有Amazon全局条件键，请参阅 *IAM 用户指南*中的[Amazon全局条件上下文密钥](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_condition-keys.html)。 要查看 ElastiCache 条件密钥列表，请参阅《*服务授权参考*》 ElastiCache中的 [Amazon 条件密钥](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazonelasticache.html#amazonelasticache-policy-keys)。要了解您可以使用条件键的操作和资源，请参阅 [Amazon 定义的操作 ElastiCache](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazonelasticache.html#amazonelasticache-actions-as-permissions)。 要查看 ElastiCache 基于身份的策略的示例，请参阅。[Amazon 基于身份的政策示例 ElastiCache](security_iam_id-based-policy-examples.md) ## 中的访问控制列表 (ACLs) ElastiCache **支持 ACLs：**是 访问控制列表 (ACLs) 控制哪些委托人（账户成员、用户或角色）有权访问资源。 ACLs 与基于资源的策略类似，尽管它们不使用 JSON 策略文档格式。 ## 基于属性的访问控制 (ABAC) ElastiCache **支持 ABAC（策略中的标签）：**是 基于属性的访问权限控制（ABAC）是一种授权策略，该策略基于称为标签的属性来定义权限。您可以将标签附加到 IAM 实体和Amazon资源，然后设计 ABAC 策略以允许在委托人的标签与资源上的标签匹配时进行操作。 要基于标签控制访问，您需要使用 `aws:ResourceTag/key-name``aws:RequestTag/key-name` 或 `aws:TagKeys` 条件键在策略的[条件元素](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements_condition.html)中提供标签信息。 如果某个服务对于每种资源类型都支持所有这三个条件键，则对于该服务，该值为**是**。如果某个服务仅对于部分资源类型支持所有这三个条件键，则该值为**部分**。 有关 ABAC 的更多信息，请参阅《IAM 用户指南》**中的[使用 ABAC 授权定义权限](https://docs.amazonaws.cn/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)。要查看设置 ABAC 步骤的教程，请参阅《IAM 用户指南》**中的[使用基于属性的访问权限控制（ABAC）](https://docs.amazonaws.cn/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html)。 ## 将临时凭证与配合使用 ElastiCache **支持临时凭证：**是 临时证书提供对Amazon资源的短期访问权限，并且是在您使用联合身份或切换角色时自动创建的。Amazon建议您动态生成临时证书，而不是使用长期访问密钥。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的临时安全凭证](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_credentials_temp.html)和[使用 IAM 的Amazon Web Services 服务](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。 ## ElastiCache 的跨服务主体权限 **支持转发访问会话（FAS）：**是 转发访问会话 (FAS) 使用调用主体的权限Amazon Web Services 服务，再加上Amazon Web Services 服务向下游服务发出请求的请求。有关发出 FAS 请求时的策略详情，请参阅[转发访问会话](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_forward_access_sessions.html)。 ## 的服务角色 ElastiCache **支持服务角色：**是 服务角色是由一项服务担任、代表您执行操作的 [IAM 角色](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_roles.html)。IAM 管理员可以在 IAM 中创建、修改和删除服务角色。有关更多信息，请参阅《IAM 用户指南》**中的[创建向Amazon Web Services 服务委派权限的角色](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_roles_create_for-service.html)。 **警告** 更改服务角色的权限可能会中断 ElastiCache 功能。只有在 ElastiCache 提供指导时，才能编辑服务角色。 ## 的服务相关角色 ElastiCache **支持服务关联角色：**是 服务相关角色是一种与服务相关联的Amazon Web Services 服务服务角色。服务可以代入代表您执行操作的角色。服务相关角色出现在您的中Amazon Web Services 账户，并且归服务所有。IAM 管理员可以查看但不能编辑服务关联角色的权限。 有关创建或管理服务相关角色的详细信息，请参阅[能够与 IAM 搭配使用的Amazon服务](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。在表中查找**服务相关角色**列中包含 `Yes` 的表。选择**是**链接以查看该服务的服务相关角色文档。 # Amazon 基于身份的政策示例 ElastiCache 默认情况下，用户和角色没有创建或修改 ElastiCache 资源的权限。要授予用户对所需资源执行操作的权限，IAM 管理员可以创建 IAM 策略。 要了解如何使用这些示例 JSON 策略文档创建基于 IAM 身份的策略，请参阅《IAM 用户指南》**中的[创建 IAM 策略（控制台）](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_create-console.html)。 有关由 ElastiCache定义的操作和资源类型（包括每种资源类型的格式）的详细信息，请参阅《*服务授权参考*》 ElastiCache中的 [Amazon 操作、资源和条件密钥](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazonelasticache.html)。 ARNs **Topics** + [策略最佳实践](#security_iam_service-with-iam-policy-best-practices) + [使用控制 ElastiCache 台](#security_iam_id-based-policy-examples-console) + [允许用户查看他们自己的权限](#security_iam_id-based-policy-examples-view-own-permissions) ## 策略最佳实践 基于身份的策略决定了某人是否可以在您的账户中创建、访问或删除 ElastiCache 资源。这些操作可能会使Amazon Web Services 账户产生成本。创建或编辑基于身份的策略时，请遵循以下指南和建议： + **开始使用Amazon托管策略并转向最低权限权限** — 要开始向用户和工作负载授予权限，请使用为许多常见用例授予权限的*Amazon托管策略*。它们在你的版本中可用Amazon Web Services 账户。我们建议您通过定义针对您的用例的Amazon客户托管策略来进一步减少权限。有关更多信息，请参阅《IAM 用户指南》**中的 [Amazon托管策略](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)或[工作职能的Amazon托管策略](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_job-functions.html)。 + **应用最低权限**：在使用 IAM 策略设置权限时，请仅授予执行任务所需的权限。为此，您可以定义在特定条件下可以对特定资源执行的操作，也称为*最低权限许可*。有关使用 IAM 应用权限的更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的策略和权限](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies.html)。 + **使用 IAM 策略中的条件进一步限制访问权限**：您可以向策略添加条件来限制对操作和资源的访问。例如，您可以编写策略条件来指定必须使用 SSL 发送所有请求。如果服务操作是通过特定Amazon Web Services 服务的（例如）使用的，则也可以使用条件来授予对服务操作的访问权限Amazon CloudFormation。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM JSON 策略元素：条件](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements_condition.html)。 + **使用 IAM Access Analyzer 验证您的 IAM 策略，以确保权限的安全性和功能性**：IAM Access Analyzer 会验证新策略和现有策略，以确保策略符合 IAM 策略语言（JSON）和 IAM 最佳实践。IAM Access Analyzer 提供 100 多项策略检查和可操作的建议，以帮助您制定安全且功能性强的策略。有关更多信息，请参阅《IAM 用户指南》**中的[使用 IAM Access Analyzer 验证策略](https://docs.amazonaws.cn/IAM/latest/UserGuide/access-analyzer-policy-validation.html)。 + **需要多重身份验证 (MFA**)-如果Amazon Web Services 账户您的场景需要 IAM 用户或根用户，请启用 MFA 以提高安全性。若要在调用 API 操作时需要 MFA，请将 MFA 条件添加到您的策略中。有关更多信息，请参阅《IAM 用户指南》**中的[使用 MFA 保护 API 访问](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html)。 有关 IAM 中的最佳实操的更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的安全最佳实践](https://docs.amazonaws.cn/IAM/latest/UserGuide/best-practices.html)。 ## 使用控制 ElastiCache 台 要访问 Amazon ElastiCache 控制台，您必须拥有一组最低权限。这些权限必须允许您列出和查看有关您的 ElastiCache 资源的详细信息Amazon Web Services 账户。如果创建比必需的最低权限更为严格的基于身份的策略，对于附加了该策略的实体（用户或角色），控制台将无法按预期正常运行。 对于仅调用Amazon CLI或Amazon API 的用户，您无需为其设置最低控制台权限。相反，只允许访问与其尝试执行的 API 操作相匹配的操作。 为确保用户和角色仍然可以使用 ElastiCache 控制台，还需要将 ElastiCache`ConsoleAccess`或`ReadOnly`Amazon托管策略附加到实体。有关更多信息，请参阅《IAM 用户指南》**中的[为用户添加权限](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)。 ## 允许用户查看他们自己的权限 该示例说明了您如何创建策略，以允许 IAM 用户查看附加到其用户身份的内联和托管式策略。此策略包括在控制台上或使用Amazon CLI或Amazon 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": "*" } ] } ``` # Amazon ElastiCache 身份和访问问题排查 使用以下信息可帮助您诊断和修复在使用 ElastiCache 和 IAM 时可能遇到的常见问题。 **Topics** + [我无权在 ElastiCache 中执行操作](#security_iam_troubleshoot-no-permissions) + [我无权执行 iam:PassRole](#security_iam_troubleshoot-passrole) + [我想要允许我的 Amazon 账户之外的用户访问我的 ElastiCache 资源](#security_iam_troubleshoot-cross-account-access) ## 我无权在 ElastiCache 中执行操作 如果Amazon Web Services 管理控制台告诉您，无权执行某个操作，则必须联系管理员寻求帮助。管理员是指提供用户名和密码的人员。 当 `mateojackson` 用户尝试使用控制台查看有关虚构 `my-example-widget` 资源的详细信息，但不拥有虚构 `elasticache:GetWidget` 权限时，会发生以下示例错误。 ``` User: arn:aws:iam::123456789012:user/mateojackson is not authorized to perform: elasticache:GetWidget on resource: my-example-widget ``` 在这种情况下，Mateo 请求他的管理员更新其策略，以允许他使用 `elasticache:GetWidget` 操作访问 `my-example-widget` 资源。 ## 我无权执行 iam:PassRole 如果收到表明您无权执行 `iam:PassRole` 操作的错误，则必须更新策略以允许您将角色传递给 ElastiCache。 有些 Amazon Web Services 服务 允许将现有角色传递到该服务，而不是创建新服务角色或服务相关角色。为此，您必须具有将角色传递到服务的权限。 当名为 `marymajor` 的 IAM 用户尝试使用控制台在 ElastiCache 中执行操作时，会发生以下示例错误。但是，服务必须具有服务角色所授予的权限才可执行此操作。Mary 不具有将角色传递到服务的权限。 ``` User: arn:aws:iam::123456789012:user/marymajor is not authorized to perform: iam:PassRole ``` 在这种情况下，必须更新 Mary 的策略以允许她执行 `iam:PassRole` 操作。 如果您需要帮助，请联系 Amazon 管理员。您的管理员是提供登录凭证的人。 ## 我想要允许我的 Amazon 账户之外的用户访问我的 ElastiCache 资源 您可以创建一个角色，以便其他账户中的用户或您组织外的人员可以使用该角色来访问您的资源。您可以指定谁值得信赖，可以代入角色。对于支持基于资源的策略或访问控制列表（ACL）的服务，您可以使用这些策略向人员授予对您的资源的访问权。 要了解更多信息，请参阅以下内容： + 要了解 ElastiCache 是否支持这些功能，请参阅[亚马逊如何 ElastiCache 使用 IAM](security_iam_service-with-iam.md)。 + 要了解如何为您拥有的 Amazon Web Services 账户中的资源提供访问权限，请参阅*《IAM 用户指南》*中的[为您拥有的另一个 Amazon Web Services 账户中的 IAM 用户提供访问权限](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_roles_common-scenarios_aws-accounts.html)。 + 要了解如何为第三方 Amazon Web Services 账户 提供您的资源的访问权限，请参阅*《IAM 用户指南》*中的[为第三方拥有的 Amazon Web Services 账户 提供访问权限](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html)。 + 要了解如何通过身份联合验证提供访问权限，请参阅《IAM 用户指南》**中的[为经过外部身份验证的用户（身份联合验证）提供访问权限](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_roles_common-scenarios_federated-users.html)。 + 要了解使用角色和基于资源的策略进行跨账户访问之间的差别，请参阅《IAM 用户指南》**中的 [IAM 中的跨账户资源访问](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)。 ## 访问控制 您可以拥有有效的凭证来验证您的请求，但是除非您拥有权限，否则您无法创建或访问 ElastiCache 资源。例如，您必须具有创建集 ElastiCache 群的权限。 以下各节介绍如何管理的权限 ElastiCache。我们建议您先阅读概述。 + [管理 ElastiCache 资源访问权限概述](IAM.Overview.md) + [使用适用于亚马逊的基于身份的政策（IAM 策略） ElastiCache](IAM.IdentityBasedPolicies.md) # 管理 ElastiCache 资源访问权限概述 每个Amazon资源都归一个Amazon账户所有，创建或访问资源的权限受权限策略的约束。账户管理员可以向 IAM 身份（即：用户、组和角色）附加权限策略。此外，Amazon ElastiCache 还支持为资源附加权限策略。 **注意** *账户管理员*（或管理员用户）是具有管理员权限的用户。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM 最佳实操](https://docs.amazonaws.cn/IAM/latest/UserGuide/best-practices.html)。 要提供访问权限，请为您的用户、组或角色添加权限： + 通过身份提供商在 IAM 中托管的用户： 创建适用于身份联合验证的角色。按照《IAM 用户指南》**中[针对第三方身份提供商创建角色（联合身份验证）](https://docs.amazonaws.cn//IAM/latest/UserGuide/id_roles_create_for-idp.html)的说明进行操作。 + IAM 用户： + 创建您的用户可以担任的角色。按照《IAM 用户指南》**中[为 IAM 用户创建角色](https://docs.amazonaws.cn//IAM/latest/UserGuide/id_roles_create_for-user.html)的说明进行操作。 + （不推荐使用）将策略直接附加到用户或将用户添加到用户组。按照《IAM 用户指南》**中[向用户添加权限（控制台）](https://docs.amazonaws.cn//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)中的说明进行操作。 **Topics** + [Amazon ElastiCache 资源和运营](#IAM.Overview.ResourcesAndOperations) + [了解资源所有权](#access-control-resource-ownership) + [管理对 资源的访问](#IAM.Overview.ManagingAccess) + [Amazon Amazon 的托管政策 ElastiCache](IAM.IdentityBasedPolicies.PredefinedPolicies.md) + [使用适用于亚马逊的基于身份的政策（IAM 策略） ElastiCache](IAM.IdentityBasedPolicies.md) + [资源级权限](IAM.ResourceLevelPermissions.md) + [使用条件键](IAM.ConditionKeys.md) + [将服务相关角色用于 Amazon ElastiCache](using-service-linked-roles.md) + [ElastiCache API 权限：操作、资源和条件参考](IAM.APIReference.md) ## Amazon ElastiCache 资源和运营 要查看 ElastiCache 资源类型及其列表 ARNs，请参阅《*服务授权参考*》 ElastiCache中的 [Amazon 定义的资源](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazonelasticache.html#amazonelasticache-resources-for-iam-policies)。要了解您可以使用哪些操作来指定每种资源的 ARN，请参阅 [Amazon 定义的操作](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazonelasticache.html#amazonelasticache-actions-as-permissions)。 ElastiCache ## 了解资源所有权 *资源所有者*是创建资源的Amazon账户。也就是说，资源所有者是对创建资源的请求进行身份验证的委托人实体的Amazon账户。*委托人实体*可以是根账户、IAM 用户或 IAM 角色。以下示例说明了它的工作原理： + 假设您使用账户的根账户凭证创建缓存集群。Amazon在这种情况下，您的Amazon账户就是资源的所有者。在中 ElastiCache，资源是群集。 + 假设您在Amazon账户中创建了一个 IAM 用户，并向该用户授予创建集群的权限。在这种情况下，用户可以创建集群。但是，该用户所属的您的Amazon账户拥有群集资源。 + 假设您在Amazon账户中创建了一个拥有创建集群权限的 IAM 角色。在这种情况下，任何可以代入该角色的人都可以创建集群。该角色所属的您的Amazon账户拥有缓存群集资源。 ## 管理对 资源的访问 *权限策略*规定谁可以访问哪些内容。下一节介绍创建权限策略时的可用选项。 **注意** 本节讨论在 Amazon 环境中使用 IAM ElastiCache。这里不提供有关 IAM 服务的详细信息。有关完整的 IAM 文档，请参阅《IAM 用户指南》中的[什么是 IAM？](https://docs.amazonaws.cn/IAM/latest/UserGuide/introduction.html)。有关 IAM 策略语法和说明的信息，请参阅《IAM 用户指南》中的 [Amazon IAM 策略参考](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies.html)。 附加到 IAM 身份的策略称为*基于身份*的策略（IAM 策略）。附加到资源的策略称为*基于资源的策略*。 **Topics** + [基于身份的策略（IAM 策略）](#IAM.Overview.ManagingAccess.IdentityBasedPolicies) + [指定策略元素：操作、效果、资源和主体](#IAM.Overview.PolicyElements) + [在策略中指定条件](#IAM.Overview.Conditions) ### 基于身份的策略（IAM 策略） 您可以向 IAM 身份附加策略。例如，您可以执行以下操作： + **向您账户中的用户或组附加权限策略** – 账户管理员可以使用与特定用户关联的权限策略来授予权限。在这种情况下，该用户拥有创建 ElastiCache 资源（例如群集、参数组或安全组）的权限。 + **向角色附加权限策略（授予跨账户权限）** – 您可以向 IAM 角色附加基于身份的权限策略，以授予跨账户的权限。例如，账户 A 中的管理员可以创建一个角色来向另一个Amazon账户（例如账户 B）或Amazon服务授予跨账户权限，如下所示： 1. 账户 A 管理员可以创建一个 IAM 角色，然后向该角色附加授予其访问账户 A 中资源的权限策略。 1. 账户 A 管理员可以把信任策略附加至用来标识账户 B 的角色，账户 B 由此可以作为主体代入该角色。 1. 然后，账户 B 管理员可以将代入该角色的权限委托给账户 B 中的任何用户。这样，账户 B 中的用户就可以创建或访问账户 A 中的资源。在某些情况下，您可能需要向Amazon服务授予代入该角色的权限。为支持此方法，信任策略中的委托人也可以是Amazon服务委托人。 有关使用 IAM 委托权限的更多信息，请参阅《IAM 用户指南》**中的[访问权限管理](https://docs.amazonaws.cn/IAM/latest/UserGuide/access.html)。 以下是允许用户对您的Amazon账户执行`DescribeCacheClusters`操作的策略示例。 ElastiCache 还支持使用 API 操作的资源 ARNs 来识别特定资源。（此方法也称为资源级权限。） ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "DescribeCacheClusters", "Effect": "Allow", "Action": [ "elasticache:DescribeCacheClusters" ], "Resource": "arn:aws:iam::*:role/*" } ] } ``` ------ 有关将基于身份的策略与配合使用的更多信息 ElastiCache，请参阅。[使用适用于亚马逊的基于身份的政策（IAM 策略） ElastiCache](IAM.IdentityBasedPolicies.md)有关用户、组、角色和权限的更多信息，请参阅 *IAM 用户指南*中的[身份（用户、组和角色）](https://docs.amazonaws.cn/IAM/latest/UserGuide/id.html)。 ### 指定策略元素：操作、效果、资源和主体 对于每个 Amazon ElastiCache 资源（参见[Amazon ElastiCache 资源和运营](#IAM.Overview.ResourcesAndOperations)），该服务都定义了一组 API 操作（参见[操作](https://docs.amazonaws.cn/AmazonElastiCache/latest/APIReference/API_Operations.html)）。要授予这些 API 操作的权限，请 ElastiCache 定义一组可在策略中指定的操作。例如，对于 ElastiCache群集资源，定义了以下操作：`CreateCacheCluster``DeleteCacheCluster`、和`DescribeCacheCluster`。执行一个 API 操作可能需要多个操作的权限。 以下是最基本的策略元素： + **资源**：在策略中，您可以使用 Amazon Resource Name（ARN）标识策略应用到的资源。有关更多信息，请参阅 [Amazon ElastiCache 资源和运营](#IAM.Overview.ResourcesAndOperations)。 + **操作** – 您可以使用操作关键字标识要允许或拒绝的资源操作。例如，根据指定的权限`Effect`，该`elasticache:CreateCacheCluster`权限允许或拒绝用户执行 Amazon ElastiCache `CreateCacheCluster` 操作的权限。 + **效果**：您可以指定当用户请求特定操作（可以是允许或拒绝）时的效果。如果没有显式授予（允许）对资源的访问权限，则隐式拒绝访问。您也可显式拒绝对资源的访问。例如，您可以执行此操作，以确保用户无法访问资源，即使有其他策略授予了访问权限也是如此。 + **主体** – 在基于身份的策略（IAM 策略）中，附加了策略的用户是隐式主体。对于基于资源的策略，您可以指定要接收权限的用户、账户、服务或其他实体（仅适用于基于资源的策略）。 有关 IAM 策略语法和描述的更多信息，请参阅《IAM 用户指南》**中的 [Amazon IAM 策略参考](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies.html)。 有关显示所有 Amazon ElastiCache API 操作的表格，请参阅[ElastiCache API 权限：操作、资源和条件参考](IAM.APIReference.md)。 ### 在策略中指定条件 当您授予权限时，可使用 IAM 策略语言来指定规定策略何时生效的条件。例如，您可能希望策略仅在特定日期后应用。有关使用策略语言指定条件的更多信息，请参阅《IAM 用户指南》**中的[条件](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements.html#Condition)。 要表示条件，您可以使用预定义的条件键。要使用 ElastiCache特定条件键，请参阅[使用条件键](IAM.ConditionKeys.md)。您可以根据需要使用Amazon范围内的条件键。有关Amazon范围密钥的完整列表，请参阅 *IAM 用户指南*中的[条件可用密钥](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements.html#AvailableKeys)。 # Amazon Amazon 的托管政策 ElastiCache Amazon托管策略是由创建和管理的独立策略Amazon。Amazon托管策略旨在为许多常见用例提供权限，以便您可以开始为用户、组和角色分配权限。 请记住，Amazon托管策略可能不会为您的特定用例授予最低权限权限，因为它们可供所有Amazon客户使用。我们建议通过定义特定于使用案例的[客户管理型策略](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#customer-managed-policies)来进一步减少权限。 您无法更改Amazon托管策略中定义的权限。如果Amazon更新Amazon托管策略中定义的权限，则更新会影响该策略所关联的所有委托人身份（用户、组和角色）。Amazon最有可能在启动新的 API 或现有服务可以使用新Amazon Web Services 服务的 API 操作时更新Amazon托管策略。 有关更多信息，请参阅《IAM 用户指南》**中的 [Amazon托管式策略](https://docs.amazonaws.cn/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)。 ## Amazon托管策略： ElastiCacheServiceRolePolicy 您无法附加 ElastiCacheServiceRolePolicy 到您的 IAM 实体。此策略附加到允许代表您执行操作 ElastiCache 的服务相关角色。 此政策 ElastiCache 允许在必要时代表您管理Amazon资源，以管理您的缓存： + `ec2`— 管理要连接到缓存节点的 EC2 网络资源，包括 VPC 终端节点（用于无服务器缓存）、弹性网络接口 (ENIs)（用于基于节点的集群）和安全组。 + `cloudwatch`— 将指标数据从服务发送到。 CloudWatch + `outposts`— 允许在Amazon Outposts 上创建缓存节点。 您可以在 [ElastiCacheServiceRolePolicy](https://console.amazonaws.cn/iam/home#policies/arn:aws:iam::aws:policy/ElastiCacheServiceRolePolicy)IAM 控制台和*Amazon托管策略参考指南[ElastiCacheServiceRolePolicy](https://docs.amazonaws.cn/aws-managed-policy/latest/reference/ElastiCacheServiceRolePolicy.html)中找到该策略*。 ## Amazon托管策略： AmazonElastiCacheFullAccess 您可以将 `AmazonElastiCacheFullAccess` 策略附加到 IAM 身份。 此策略允许委托人 ElastiCache 使用Amazon管理控制台进行完全访问： + `elasticache`— 访问全部 APIs。 + `iam`：创建服务操作所需的服务相关角色。 + `ec2`— 描述创建缓存所需的依赖 EC2 资源（VPC、子网、安全组），并允许创建 VPC 终端节点（用于无服务器缓存）。 + `kms`— 允许使用客户管理 CMKs 的。 encryption-at-rest + `cloudwatch`— 允许访问指标以在控制台中显示 ElastiCache 指标。 + `application-autoscaling`：允许访问权限，以便描述缓存的自动缩放策略。 + `logs`：用于填充日志流，以便在控制台中使用日志传输功能。 + `firehose` – 用于填充传输送流，以便在控制台中使用日志传输功能。 + `s3`：用于填充 S3 存储桶，以便在控制台中使用快照还原功能。 + `outposts`— 用于填充 Outpo Amazon sts 以便在控制台中创建缓存。 + `sns`：用于填充 SNS 主题，以便在控制台中使用通知功能。 您可以在 [AmazonElastiCacheFullAccess](https://console.amazonaws.cn/iam/home#policies/arn:aws:iam::aws:policy/AmazonElastiCacheFullAccess)IAM 控制台和*Amazon托管策略参考指南[AmazonElastiCacheFullAccess](https://docs.amazonaws.cn/aws-managed-policy/latest/reference/AmazonElastiCacheFullAccess.html)中找到该策略*。 ## Amazon托管策略： AmazonElastiCacheReadOnlyAccess 您可以将 `AmazonElastiCacheReadOnlyAccess` 策略附加到 IAM 身份。 此策略允许委托人 ElastiCache 使用Amazon管理控制台进行只读访问： + `elasticache`— 访问权限为只读`Describe` APIs。 您可以在 [AmazonElastiCacheReadOnlyAccess](https://console.amazonaws.cn/iam/home#policies/arn:aws:iam::aws:policy/AmazonElastiCacheReadOnlyAccess)IAM 控制台和*Amazon托管策略参考指南[AmazonElastiCacheReadOnlyAccess](https://docs.amazonaws.cn/aws-managed-policy/latest/reference/AmazonElastiCacheReadOnlyAccess.html)中找到该策略*。 ## ElastiCache Amazon托管策略的更新 查看 ElastiCache 自该服务开始跟踪这些更改以来Amazon托管策略更新的详细信息。要获得有关此页面变更的自动提醒，请订阅 “ ElastiCache 文档历史记录” 页面上的 RSS feed。 | 更改 | 描述 | 日期 | | --- | --- | --- | | [AmazonElastiCacheFullAccess](#security-iam-awsmanpol-AmazonElastiCacheFullAccess)：对现有策略的更新 | ElastiCache 为 MemCached操作添加了允许垂直缩放的新权限`elasticache:ModifyCacheCluster`。 | 2025 年 3 月 27 日 | | [AmazonElastiCacheFullAccess](#security-iam-awsmanpol-AmazonElastiCacheFullAccess)：对现有策略的更新 | ElastiCache 添加了新的权限以允许管理无服务器缓存，并允许通过控制台使用所有服务功能。 | 2023 年 11 月 27 日 | | [ElastiCacheServiceRolePolicy](#security-iam-awsmanpol-ElastiCacheServiceRolePolicy)：对现有策略的更新 | ElastiCache 添加了新的权限以允许管理无服务器缓存资源的 VPC 终端节点。 | 2023 年 11 月 27 日 | | ElastiCache 开始跟踪更改 | ElastiCache 开始跟踪其Amazon托管策略的更改。 | 2020 年 2 月 7 日 | # 使用适用于亚马逊的基于身份的政策（IAM 策略） ElastiCache 本主题提供了基于身份的策略的示例，在这些策略中，账户管理员可以向 IAM 身份（即：用户、组和角色）附加权限策略。 **重要** 我们建议您先阅读解释基本概念和管理 Amazon ElastiCache 资源访问权限的选项的主题。有关更多信息，请参阅 [管理 ElastiCache 资源访问权限概述](IAM.Overview.md)。 本主题的各个部分涵盖以下内容： + [Amazon Amazon 的托管政策 ElastiCache](IAM.IdentityBasedPolicies.PredefinedPolicies.md) + [客户管理型策略示例](#IAM.IdentityBasedPolicies.CustomerManagedPolicies) 下面展示了使用 Redis OSS 时的权限策略示例。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowClusterPermissions", "Effect": "Allow", "Action": [ "elasticache:CreateServerlessCache", "elasticache:CreateCacheCluster", "elasticache:DescribeServerlessCaches", "elasticache:DescribeReplicationGroups", "elasticache:DescribeCacheClusters", "elasticache:ModifyServerlessCache", "elasticache:ModifyReplicationGroup", "elasticache:ModifyCacheCluster" ], "Resource": "*" }, { "Sid": "AllowUserToPassRole", "Effect": "Allow", "Action": [ "iam:PassRole" ], "Resource": "arn:aws:iam::123456789012:role/EC2-roles-for-cluster" } ] } ``` ------ 下面展示了使用 Memcached 时的权限策略示例。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [{ "Sid": "AllowClusterPermissions", "Effect": "Allow", "Action": [ "elasticache:CreateServerlessCache", "elasticache:CreateCacheCluster", "elasticache:DescribeServerlessCaches", "elasticache:DescribeCacheClusters", "elasticache:ModifyServerlessCache", "elasticache:ModifyCacheCluster" ], "Resource": "*" }, { "Sid": "AllowUserToPassRole", "Effect": "Allow", "Action": [ "iam:PassRole" ], "Resource": "arn:aws:iam::123456789012:role/EC2-roles-for-cluster" } ] } ``` ------ 该策略包含两条语句： + 第一条语句授予对 Amazon ElastiCache 操作的权限（`elasticache:Create*`、`elasticache:Describe*`、`elasticache:Modify*`） + 第二条语句授予对 `Resource` 值末尾指定的 IAM 角色名称的 IAM 操作（`iam:PassRole`）的权限。 该策略不指定 `Principal` 元素，因为在基于身份的策略中，您未指定获取权限的委托人。附加了策略的用户是隐式委托人。向 IAM 角色附加权限策略后，该角色的信任策略中标识的主体将获取权限。 有关显示所有 Amazon ElastiCache API 操作及其适用的资源的表格，请参阅[ElastiCache API 权限：操作、资源和条件参考](IAM.APIReference.md)。 ## 客户管理型策略示例 如果您未使用默认策略并选择使用自定义托管策略，请确保以下两项之一。您应该有权调用 `iam:createServiceLinkedRole`（有关更多信息，请参阅[示例 4：允许用户调用 IAM CreateServiceLinkedRole API](#create-service-linked-role-policy)）。或者你应该已经创建了一个 ElastiCache 与服务相关的角色。 与使用 Amazon ElastiCache 控制台所需的最低权限相结合，本节中的示例策略将授予额外权限。这些示例也与Amazon SDKs 和有关Amazon CLI。 有关设置 IAM 用户和组的说明，请参阅 *IAM 用户指南*中的[创建您的第一个 IAM 用户和管理员组](https://docs.amazonaws.cn/IAM/latest/UserGuide/getting-started_create-admin-group.html)。 **重要** 在生产中使用 IAM 策略之前，请始终全面测试这些策略。在您使用 ElastiCache 控制台时，某些 ElastiCache 看似简单的操作可能需要其他操作来支持它们。例如，`elasticache:CreateCacheCluster`授予创建 ElastiCache 集群的权限。但是，为了执行此操作， ElastiCache 控制台使用许多`Describe`和`List`操作来填充控制台列表。 **Topics** + [示例 1：允许用户对 ElastiCache 资源进行只读访问](#example-allow-list-current-elasticache-resources) + [示例 2：允许用户执行常见的 ElastiCache 系统管理员任务](#example-allow-specific-elasticache-actions) + [示例 3：允许用户访问所有 ElastiCache API 操作](#allow-unrestricted-access) + [示例 4：允许用户调用 IAM CreateServiceLinkedRole API](#create-service-linked-role-policy) + [示例 5：允许用户使用 IAM 身份验证连接到无服务器缓存](#iam-connect-policy) ### 示例 1：允许用户对 ElastiCache 资源进行只读访问 以下策略授予允许用户列出资源的权限 ElastiCache 操作。通常，您将此类型的权限策略挂载到管理人员组。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement":[{ "Sid": "ECReadOnly", "Effect":"Allow", "Action": [ "elasticache:Describe*", "elasticache:List*"], "Resource":"*" } ] } ``` ------ ### 示例 2：允许用户执行常见的 ElastiCache 系统管理员任务 常见的系统管理员任务包括修改资源。系统管理员还可能需要获得有关 ElastiCache 事件的信息。以下策略向用户授予执行这些常见系统管理员任务的 ElastiCache 操作的权限。通常，您将此类型的权限策略挂载到系统管理员组。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement":[{ "Sid": "ECAllowMutations", "Effect":"Allow", "Action":[ "elasticache:Modify*", "elasticache:Describe*", "elasticache:ResetCacheParameterGroup" ], "Resource":"*" } ] } ``` ------ ### 示例 3：允许用户访问所有 ElastiCache API 操作 以下策略允许用户访问所有 ElastiCache 操作。建议您仅向管理员用户授予此类型的权限策略。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement":[{ "Sid": "ECAllowAll", "Effect":"Allow", "Action":[ "elasticache:*" ], "Resource":"*" } ] } ``` ------ ### 示例 4：允许用户调用 IAM CreateServiceLinkedRole API 以下策略允许用户调用 IAM `CreateServiceLinkedRole` API。我们建议您向调用变异 ElastiCache 操作的用户授予此类权限策略。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement":[ { "Sid":"CreateSLRAllows", "Effect":"Allow", "Action":[ "iam:CreateServiceLinkedRole" ], "Resource":"*", "Condition":{ "StringLike":{ "iam:AWSServiceName":"elasticache.amazonaws.com" } } } ] } ``` ------ ### 示例 5：允许用户使用 IAM 身份验证连接到无服务器缓存 以下策略允许任何用户在 2023 年 4 月 1 日到 2023 年 6 月 30 日之间，使用 IAM 身份验证连接到任何无服务器缓存。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement" : [ { "Effect" : "Allow", "Action" : ["elasticache:Connect"], "Resource" : [ "arn:aws:elasticache:us-east-1:123456789012:serverlesscache:*" ], "Condition": { "DateGreaterThan": {"aws:CurrentTime": "2023-04-01T00:00:00Z"}, "DateLessThan": {"aws:CurrentTime": "2023-06-30T23:59:59Z"} } }, { "Effect" : "Allow", "Action" : ["elasticache:Connect"], "Resource" : [ "arn:aws:elasticache:us-east-1:123456789012:user:*" ] } ] } ``` ------ # 资源级权限 您可以通过在 IAM policy 中指定资源来限制权限范围。多数 ElastiCache API 操作均支持根据操作行为而有所不同的资源类型。每条 IAM policy 语句为对一个资源执行的一个操作授予权限。如果操作不对指定资源执行操作，或者您授予对所有资源执行操作的权限，则策略中资源的值为通配符（\$1）。对于许多 API 操作，可以通过指定资源的 Amazon 资源名称（ARN）或与多个资源匹配的 ARN 模式来限制用户可修改的资源。要按资源限制权限，请指定资源的 ARN。 有关 ElastiCache 资源类型及其 ARN 的列表，请参阅《服务授权参考》**中的 [Amazon ElastiCache 定义的资源](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazonelasticache.html#amazonelasticache-resources-for-iam-policies)。要了解您可以使用哪些操作指定每个资源的 ARN，请参阅 [Amazon ElastiCache 定义的操作](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazonelasticache.html#amazonelasticache-actions-as-permissions)。 **Topics** + [示例 1：允许用户完全访问特定 ElastiCache 资源类型](#example-allow-list-current-elasticache-resources-resource) + [示例 2：拒绝用户访问无服务器缓存。](#example-allow-specific-elasticache-actions-resource) ## 示例 1：允许用户完全访问特定 ElastiCache 资源类型 以下策略明确允许无服务器缓存类型的所有资源。 ``` { "Sid": "Example1", "Effect": "Allow", "Action": "elasticache:*", "Resource": [ "arn:aws:elasticache:us-east-1:account-id:serverlesscache:*" ] } ``` ## 示例 2：拒绝用户访问无服务器缓存。 以下示例明确拒绝访问特定无服务器缓存。 ``` { "Sid": "Example2", "Effect": "Deny", "Action": "elasticache:*", "Resource": [ "arn:aws:elasticache:us-east-1:account-id:serverlesscache:name" ] } ``` # 使用条件键 您可以指定决定 IAM 策略如何生效的条件。在中 ElastiCache，您可以使用 JSON 策略的`Condition`元素将请求上下文中的密钥与您在策略中指定的密钥值进行比较。有关更多信息，请参阅 [IAM JSON 策略元素：条件](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements_condition.html)。 要查看 ElastiCache 条件密钥列表，请参阅《*服务授权参考*》 ElastiCache中的 [Amazon 条件密钥](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazonelasticache.html#amazonelasticache-policy-keys)。 有关全局条件键的列表，请参阅 [Amazon全局条件上下文键](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_condition-keys.html)。 ** ElastiCache 与Amazon全局条件键一起使用** 当使用需要 ElastiCache的 “[主体](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_elements_principal.html#principal-services)” 的[Amazon全局条件键](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_condition-keys.html)时，请使用*同时*包含主体:`elasticache.amazonaws.com`和`ec.amazonaws.com`的`OR`条件。 **注意** 如果您不同时为其添加两个委托人 ElastiCache，则无法对策略中列出的任何资源正确执行预期的 “允许” 或 “拒绝” 操作。 带有 `aws:CalledVia` 全局条件键的策略示例： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "ec2:*", "Resource": "*", "Condition": { "ForAnyValue:StringLike": { "aws:CalledVia": [ "ec.amazonaws.com", "elasticache.amazonaws.com" ] } } } ] } ``` ------ ## 指定条件：使用条件键 要实现精细控制，您需要编写 IAM 权限策略，用于指定控制某些请求上单独参数集的条件。然后，将该策略应用于您使用 IAM 控制台创建的 IAM 用户、组或角色。 要应用条件，请将条件信息添加到 IAM policy 语句。在以下示例中，您指定了条件，为创建的所有基于节点的集群使用节点类型 `cache.r5.large`。 **注意** 要使用 `String` 类型的条件键构造 `Condition` 元素，请使用不区分大小写的条件运算符 `StringEqualsIgnoreCase` 或 `StringNotEqualsIgnoreCase` 将键与字符串值进行比较。 ElastiCache 以不区分大小写的方式处理`CacheNodeType`和`CacheParameterGroupName`的输入参数。因此，在引用这些参数的权限策略中，应使用字符串条件运算符 `StringEqualsIgnoreCase` 和 `StringNotEqualsIgnoreCase`。 下面展示了使用 Valkey 或 Redis OSS 时的权限策略示例。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*", "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "StringEquals": { "elasticache:CacheNodeType": [ "cache.r5.large" ] } } } ] } ``` ------ 下面展示了使用 Memcached 时的权限策略示例。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*" ], "Condition": { "StringEquals": { "elasticache:CacheNodeType": [ "cache.r5.large" ] } } } ] } ``` ------ 有关更多信息，请参阅 [为资源添加 ElastiCache 标签](Tagging-Resources.md)。 有关使用策略条件运算符的更多信息，请参阅 [ElastiCache API 权限：操作、资源和条件参考](IAM.APIReference.md)。 ## 策略示例：使用条件实现精细参数控制 本节显示了对前面列出的 ElastiCache 参数实施细粒度访问控制的策略示例。 1. **elasticacheMaximumDataStorage:**: 指定无服务器缓存的最大数据存储空间。使用提供的条件，客户不能创建存储超过特定数量数据的缓存。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowDependentResources", "Effect": "Allow", "Action": [ "elasticache:CreateServerlessCache" ], "Resource": [ "arn:aws:elasticache:*:*:serverlesscachesnapshot:*", "arn:aws:elasticache:*:*:snapshot:*", "arn:aws:elasticache:*:*:usergroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateServerlessCache" ], "Resource": [ "arn:aws:elasticache:*:*:serverlesscache:*" ], "Condition": { "NumericLessThanEquals": { "elasticache:MaximumDataStorage": "30" }, "StringEquals": { "elasticache:DataStorageUnit": "GB" } } } ] } ``` ------ 1. **ElastiCache: 最大ECPUPer秒数**：指定无服务器缓存每秒的最大 ECPU 值。根据提供的条件，客户无法创建 ECPUs 每秒执行次数超过特定次数的缓存。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowDependentResources", "Effect": "Allow", "Action": [ "elasticache:CreateServerlessCache" ], "Resource": [ "arn:aws:elasticache:*:*:serverlesscachesnapshot:*", "arn:aws:elasticache:*:*:snapshot:*", "arn:aws:elasticache:*:*:usergroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateServerlessCache" ], "Resource": [ "arn:aws:elasticache:*:*:serverlesscache:*" ], "Condition": { "NumericLessThanEquals": { "elasticache:MaximumECPUPerSecond": "100000" } } } ] } ``` ------ 1. **elasticacheCacheNodeType:**: 指定用户可以创建哪 NodeType些。使用提供的条件，客户可以为节点类型指定单个值或范围值。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*", "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "StringEquals": { "elasticache:CacheNodeType": [ "cache.t2.micro", "cache.t2.medium" ] } } } ] } ``` ------ 1. **elasticacheCacheNodeType:**: 使用 Memcached，指定用户可以创建哪 NodeType些。使用提供的条件，客户可以为节点类型指定单个值或范围值。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*" ], "Condition": { "StringEquals": { "elasticache:CacheNodeType": [ "cache.t2.micro", "cache.t2.medium" ] } } } ] } ``` ------ 1. **elasticacheNumNodeGroups:**: 创建节点组少于 20 个的复制组。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "NumericLessThanEquals": { "elasticache:NumNodeGroups": "20" } } } ] } ``` ------ 1. **elasticacheReplicasPerNodeGroup:**: 指定每个节点的副本数在 5 到 10 之间。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "NumericGreaterThanEquals": { "elasticache:ReplicasPerNodeGroup": "5" }, "NumericLessThanEquals": { "elasticache:ReplicasPerNodeGroup": "10" } } } ] } ``` ------ 1. **elasticache:EngineVersion:** 指定引擎版本 5.0.6 的用法。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*", "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "StringEquals": { "elasticache:EngineVersion": "5.0.6" } } } ] } ``` ------ 1. **elasticache:EngineVersion:** 指定 Memcached 引擎版本 1.6.6 的用法 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*" ], "Condition": { "StringEquals": { "elasticache:EngineVersion": "1.6.6" } } } ] } ``` ------ 1. **elasticache:EngineType:** 仅使用 Valkey 或 Redis OSS 引擎进行指定。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*", "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "StringEquals": { "elasticache:EngineType": "redis" } } } ] } ``` ------ 1. **elasticacheAtRestEncryptionEnabled:**: 指定只有在启用加密的情况下才能创建复制组。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "Bool": { "elasticache:AtRestEncryptionEnabled": "true" } } } ] } ``` ------ 1. **弹性疼痛:TransitEncryptionEnabled** 1. 将[CreateReplicationGroup](https://docs.amazonaws.cn/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)操作的`elasticache:TransitEncryptionEnabled`条件键设置为，以指定只有在不使用 TLS 时才能创建复制组：`false` ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "Bool": { "elasticache:TransitEncryptionEnabled": "false" } } } ] } ``` ------ 在[CreateReplicationGroup](https://docs.amazonaws.cn/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)操作策略`false`中将`elasticache:TransitEncryptionEnabled`条件键设置为时，只有在未使用 TLS 的情况下（也就是说，请求中不包含设置为的`TransitEncryptionEnabled`参数`true`或设置为的`TransitEncryptionMode`参数），才允许请求`required`。`CreateReplicationGroup` 1. 将[CreateReplicationGroup](https://docs.amazonaws.cn/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)操作`elasticache:TransitEncryptionEnabled`的条件键设置为，以指定只有在使用 TLS 时才能创建复制组：`true` ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "Bool": { "elasticache:TransitEncryptionEnabled": "true" } } } ] } ``` ------ 在[CreateReplicationGroup](https://docs.amazonaws.cn/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)操作策略`true`中将`elasticache:TransitEncryptionEnabled`条件键设置为时，只有在`CreateReplicationGroup`请求中包含设置为的参数`true`和设置为的`TransitEncryptionEnabled`参数时，`TransitEncryptionMode`才允许请求`required`。 1. 针对 `ModifyReplicationGroup` 操作将 `elasticache:TransitEncryptionEnabled` 设置为 `true`，以指定只有在使用 TLS 时才能修改复制组： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:ModifyReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "BoolIfExists": { "elasticache:TransitEncryptionEnabled": "true" } } } ] } ``` ------ 在[ModifyReplicationGroup](https://docs.amazonaws.cn/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html)操作策略`true`中将`elasticache:TransitEncryptionEnabled`条件键设置为时，只有当`ModifyReplicationGroup`请求包含设置为的`TransitEncryptionMode`参数时，才允许请求`required`。也可以选择包含设置为 `true` 的 `TransitEncryptionEnabled` 参数，但在这种情况下，该设置并不是启用 TLS 所必需的。 1. **elasticacheAutomaticFailoverEnabled:**: 指定只有在启用自动故障转移的情况下才能创建复制组。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "Bool": { "elasticache:AutomaticFailoverEnabled": "true" } } } ] } ``` ------ 1. **ElastiCache: Multi AZEnabled**：指定在禁用多可用区的情况下无法创建复制组。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Deny", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*", "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "Bool": { "elasticache:MultiAZEnabled": "false" } } } ] } ``` ------ 1. **elasticacheClusterModeEnabled:**: 指定只有在启用集群模式的情况下才能创建复制组。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "Bool": { "elasticache:ClusterModeEnabled": "true" } } } ] } ``` ------ 1. **elasticacheAuthTokenEnabled:**: 指定只有在启用身份验证令牌的情况下才能创建复制组。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*", "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "Bool": { "elasticache:AuthTokenEnabled": "true" } } } ] } ``` ------ 1. **elasticacheSnapshotRetentionLimit:**: 指定保存快照的天数（或最小/最大）。以下策略强制将备份存储至少 30 天。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup", "elasticache:CreateServerlessCache" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*", "arn:aws:elasticache:*:*:replicationgroup:*", "arn:aws:elasticache:*:*:serverlesscache:*" ], "Condition": { "NumericGreaterThanEquals": { "elasticache:SnapshotRetentionLimit": "30" } } } ] } ``` ------ 1. **elasticache:KmsKeyId:** 指定客户托管的Amazon KMS 密钥的使用情况。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowDependentResources", "Effect": "Allow", "Action": [ "elasticache:CreateServerlessCache" ], "Resource": [ "arn:aws:elasticache:*:*:serverlesscachesnapshot:*", "arn:aws:elasticache:*:*:snapshot:*", "arn:aws:elasticache:*:*:usergroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateServerlessCache" ], "Resource": [ "arn:aws:elasticache:*:*:serverlesscache:*" ], "Condition": { "StringEquals": { "elasticache:KmsKeyId": "my-key" } } } ] } ``` ------ 1. **elasticacheCacheParameterGroupName:**: 指定一个非默认参数组，其中包含来自集群上某个组织的特定参数。您还可以为参数组指定命名模式，或阻止删除特定参数组名称。以下是限制仅使用 “my-org-param-group” 的示例。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*", "arn:aws:elasticache:*:*:replicationgroup:*" ], "Condition": { "StringEquals": { "elasticache:CacheParameterGroupName": "my-org-param-group" } } } ] } ``` ------ 1. **elasticacheCacheParameterGroupName:**: 使用 Memcached，使用集群上来自组织的特定参数来指定一个非默认参数组。您还可以为参数组指定命名模式，或阻止删除特定参数组名称。以下是限制仅使用 “my-org-param-group” 的示例。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*" ], "Condition": { "StringEquals": { "elasticache:CacheParameterGroupName": "my-org-param-group" } } } ] } ``` ------ 1. **elasticacheCreateCacheCluster:**: 如果请求标签`Project`缺失或不等于`Dev`、`QA`或，则拒绝`CreateCacheCluster`执行操作。`Prod` ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*", "arn:aws:elasticache:*:*:securitygroup:*", "arn:aws:elasticache:*:*:replicationgroup:*" ] }, { "Effect": "Deny", "Action": [ "elasticache:CreateCacheCluster" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*" ], "Condition": { "Null": { "aws:RequestTag/Project": "true" } } }, { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:AddTagsToResource" ], "Resource": "arn:aws:elasticache:*:*:cluster:*", "Condition": { "StringEquals": { "aws:RequestTag/Project": [ "Dev", "Prod", "QA" ] } } } ] } ``` ------ 1. **elasticache:CacheNodeType: 允许`CreateCacheCluster`使用 cache** .r5.large 或 `cacheNodeType` cache.r6g.4xlarge 和 tag。`Project=XYZ` ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster", "elasticache:CreateReplicationGroup" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*" ], "Condition": { "StringEqualsIfExists": { "elasticache:CacheNodeType": [ "cache.r5.large", "cache.r6g.4xlarge" ] }, "StringEquals": { "aws:RequestTag/Project": "XYZ" } } } ] } ``` ------ 1. **elasticache:CacheNodeType: 允许`CreateCacheCluster`使用 cache** .r5.large 或 `cacheNodeType` cache.r6g.4xlarge 和 tag。`Project=XYZ` ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster" ], "Resource": [ "arn:aws:elasticache:*:*:parametergroup:*", "arn:aws:elasticache:*:*:subnetgroup:*" ] }, { "Effect": "Allow", "Action": [ "elasticache:CreateCacheCluster" ], "Resource": [ "arn:aws:elasticache:*:*:cluster:*" ], "Condition": { "StringEqualsIfExists": { "elasticache:CacheNodeType": [ "cache.r5.large", "cache.r6g.4xlarge" ] }, "StringEquals": { "aws:RequestTag/Project": "XYZ" } } } ] } ``` ------ **注意** 在创建策略以将标签和其他条件键一起强制执行时，由于使用 `--tags` 参数创建请求的额外 `elasticache:AddTagsToResource` 策略要求，条件键元素可能需要条件 `IfExists`。 # 将服务相关角色用于 Amazon ElastiCache Amazon ElastiCache 使用 Amazon Identity and Access Management (IAM) [服务相关角色](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)。服务相关角色是一种独特类型的 IAM 角色，它与 Amazon ElastiCache 等 Amazon 服务直接相关。Amazon ElastiCache 服务相关角色由 Amazon ElastiCache 预定义。它们包含该服务代表您的集群调用 Amazon 服务所需的一切权限。 服务相关角色可让您更轻松地设置 Amazon ElastiCache，因为您不必手动添加必要的权限。这些角色已存在于您的 Amazon 账户中，但与 Amazon ElastiCache 使用案例有关并有预定义的权限。只有 Amazon ElastiCache 可以代入这些角色，并且只有这些角色可以使用预定义的权限策略。只有先删除角色的相关资源，才能删除角色。这样可以保护您的 Amazon ElastiCache 资源，因为您不会无意中删除访问资源所需的必要权限。 有关支持服务链接角色的其他服务的信息，请参阅[使用 IAM 的 Amazon 服务](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)，并在**服务链接角色**列中查找**是**的服务。请选择**是**与查看该服务的服务相关角色文档的链接。 **Contents** + [服务相关角色权限](#service-linked-role-permissions) + [创建服务相关角色所需的权限](#service-linked-role-permissions) + [创建服务相关角色 (IAM)](#create-service-linked-role-iam) + [使用 IAM 控制台](#create-service-linked-role-iam-console) + [使用 IAM CLI](#create-service-linked-role-iam-cli) + [使用 IAM API](#create-service-linked-role-iam-api) + [编辑服务相关角色描述](#edit-service-linked-role) + [使用 IAM 控制台](#edit-service-linked-role-iam-console) + [使用 IAM CLI](#edit-service-linked-role-iam-cli) + [使用 IAM API](#edit-service-linked-role-iam-api) + [删除 Amazon ElastiCache 的服务相关角色](#delete-service-linked-role) + [清除服务相关角色](#service-linked-role-review-before-delete) + [删除服务相关角色（IAM 控制台）](#delete-service-linked-role-iam-console) + [删除服务相关角色（IAM CLI）](#delete-service-linked-role-iam-cli) + [删除服务相关角色（IAM API）](#delete-service-linked-role-iam-api) ## Amazon ElastiCache 的服务相关角色权限 ### 创建服务相关角色所需的权限 **允许 IAM 实体创建 AmazonServiceRoleForElastiCache 服务相关角色** 向该 IAM 实体的权限中添加以下策略声明： ``` { "Effect": "Allow", "Action": [ "iam:CreateServiceLinkedRole", "iam:PutRolePolicy" ], "Resource": "arn:aws:iam::*:role/aws-service-role/elasticache.amazonaws.com/AmazonServiceRoleForElastiCache*", "Condition": {"StringLike": {"iam:AmazonServiceName": "elasticache.amazonaws.com"}} } ``` **允许 IAM 实体删除 AmazonServiceRoleForElastiCache 服务相关角色** 向该 IAM 实体的权限中添加以下策略声明： ``` { "Effect": "Allow", "Action": [ "iam:DeleteServiceLinkedRole", "iam:GetServiceLinkedRoleDeletionStatus" ], "Resource": "arn:aws:iam::*:role/aws-service-role/elasticache.amazonaws.com/AmazonServiceRoleForElastiCache*", "Condition": {"StringLike": {"iam:AmazonServiceName": "elasticache.amazonaws.com"}} } ``` 或者，您可以使用 Amazon 托管式策略提供对 Amazon ElastiCache 的完全访问权限。 ## 创建服务相关角色 (IAM) 您可以使用 IAM 控制台、CLI 或 API 创建服务相关角色。 ### 创建服务相关角色（IAM 控制台） 您可使用 IAM 控制台创建服务相关角色。 **创建服务相关角色（控制台）** 1. 登录 Amazon Web Services 管理控制台，打开 IAM 控制台：[https://console.aws.amazon.com/iam/](https://console.amazonaws.cn/iam/)。 1. 在 IAM 控制台的导航窗格中，选择**角色**。然后选择**创建新角色**。 1. 在 **Select type of trusted entity（选择受信任实体的类型）**下，选择 **Amazon Service（亚马逊云科技服务）**。 1. 在 **Or select a service to view its use cases（或选择服务以查看其使用案例）**下，选择 **ElastiCache**。 1. 选择**下一步: 权限**。 1. 在 **策略名称**下，请注意此角色需要 `ElastiCacheServiceRolePolicy`。选择 **Next:Tags（下一步: 标签）**。 1. 请注意，服务相关角色不支持标签。选择**下一步: 审核**。 1. （可选）对于 **Role description**，编辑新服务相关角色的描述。 1. 检查角色，然后选择**创建角色**。 ### 创建服务相关角色（IAM CLI） 您可以从 Amazon Command Line Interface 中使用 IAM 操作创建服务相关角色。此角色可以包括服务代入角色时所需的信任策略和内联策略。 **创建服务相关角色（CLI）** 使用以下操作： ``` $ aws iam [create-service-linked-role](https://docs.amazonaws.cn/cli/latest/reference/iam/create-service-linked-role.html) --aws-service-name elasticache.amazonaws.com ``` ### 创建服务相关角色（IAM API） 您可以使用 IAM API 创建服务相关角色。此角色可以包括服务代入角色时所需的信任策略和内联策略。 **创建服务相关角色（API）** 使用 [CreateServiceLinkedRole](https://docs.amazonaws.cn/IAM/latest/APIReference/API_CreateServiceLinkedRole.html) API 调用。在请求中，指定 `elasticache.amazonaws.com` 的服务名称。 ## 编辑 Amazon ElastiCache 的服务相关角色的描述 Amazon ElastiCache 不允许您编辑 Amazon ServiceRoleForElastiCache 服务相关角色。创建服务相关角色后，您将无法更改角色的名称，因为可能有多种实体引用该角色。但是可以使用 IAM 编辑角色描述。 ### 编辑服务相关角色描述（IAM 控制台） 您可以使用 IAM 控制台编辑服务相关角色的描述。 **编辑服务相关角色的描述（控制台）** 1. 在 IAM 控制台的导航窗格中，选择**角色**。 1. 以下代码示例显示如何将 IAM 策略附加到用户。 1. 在 **Role description** 的最右侧，选择 **Edit**。 1. 在框中输入新描述，然后选择 **Save（保存）**。 ### 编辑服务相关角色描述（IAM CLI） 您可以从 Amazon Command Line Interface 使用 IAM 操作来编辑服务相关角色的描述。 **更改服务相关角色的描述（CLI）** 1. （可选）要查看角色的当前描述，请使用 Amazon CLI 执行 IAM 操作 `[get-role](https://docs.amazonaws.cn/cli/latest/reference/iam/get-role.html)`。 **Example** ``` $ aws iam [get-role](https://docs.amazonaws.cn/cli/latest/reference/iam/get-role.html) --role-name AmazonServiceRoleForElastiCache ``` 通过 CLI 操作使用角色名称（并非 ARN）指向角色。例如，如果一个角色的 ARN 为 `arn:aws:iam::123456789012:role/myrole`，则应将角色称为 **myrole**。 1. 要更新服务相关角色的描述，请使用 Amazon CLI 执行 IAM 操作 `[update-role-description](https://docs.amazonaws.cn/cli/latest/reference/iam/update-role-description.html)`。 对于 Linux、macOS 或 Unix： ``` $ aws iam [update-role-description](https://docs.amazonaws.cn/cli/latest/reference/iam/update-role-description.html) \ --role-name AmazonServiceRoleForElastiCache \ --description "new description" ``` 对于 Windows： ``` $ aws iam [update-role-description](https://docs.amazonaws.cn/cli/latest/reference/iam/update-role-description.html) ^ --role-name AmazonServiceRoleForElastiCache ^ --description "new description" ``` ### 编辑服务相关角色描述（IAM API） 您可以使用 IAM API 编辑服务相关角色描述。 **更改服务相关角色的描述（API）** 1. （可选）要查看角色的当前描述，请使用 IAM API 操作 [GetRole](https://docs.amazonaws.cn/IAM/latest/APIReference/API_GetRole.html)。 **Example** ``` https://iam.amazonaws.com/ ?Action=[GetRole](https://docs.amazonaws.cn/IAM/latest/APIReference/API_GetRole.html) &RoleName=AmazonServiceRoleForElastiCache &Version=2010-05-08 &AUTHPARAMS ``` 1. 要更新角色的描述，请使用 IAM API 操作 [UpdateRoleDescription](https://docs.amazonaws.cn/IAM/latest/APIReference/API_UpdateRoleDescription.html)。 **Example** ``` https://iam.amazonaws.com/ ?Action=[UpdateRoleDescription](https://docs.amazonaws.cn/IAM/latest/APIReference/API_UpdateRoleDescription.html) &RoleName=AmazonServiceRoleForElastiCache &Version=2010-05-08 &Description="New description" ``` ## 删除 Amazon ElastiCache 的服务相关角色 如果不再需要使用某个需要服务相关角色的功能或服务，我们建议您删除该角色。这样就没有未被主动监控或维护的未使用实体。但是，您必须先清除您的服务相关角色，然后才能将其删除。 Amazon ElastiCache 不会删除您的服务相关角色。 ### 清除服务相关角色 您必须先确认该角色没有与之关联的资源（集群或复制组），然后才能使用 IAM 删除服务相关角色。 **在 IAM 控制台中检查服务相关角色是否具有活动会话** 1. 登录 Amazon Web Services 管理控制台，打开 IAM 控制台：[https://console.aws.amazon.com/iam/](https://console.amazonaws.cn/iam/)。 1. 在 IAM 控制台的导航窗格中，选择**角色**。然后选择 Amazon ServiceRoleForElastiCache 角色的名称（而不是复选框）。 1. 在所选角色的**摘要**页面上，选择**访问顾问**选项卡。 1. 在**访问顾问**选项卡查看服务相关角色的近期活动。 **删除需要 AmazonServiceRoleForElastiCache 的 Amazon ElastiCache 资源** + 要删除集群，请参阅以下内容： + [使用Amazon Web Services 管理控制台](Clusters.Delete.md#Clusters.Delete.CON) + [使用Amazon CLI删除集 ElastiCache 群](Clusters.Delete.md#Clusters.Delete.CLI) + [使用 ElastiCache API](Clusters.Delete.md#Clusters.Delete.API) + 要删除复制组，请参阅以下内容： + [删除复制组（控制台）](Replication.DeletingRepGroup.md#Replication.DeletingRepGroup.CON) + [删除复制组 (Amazon CLI)](Replication.DeletingRepGroup.md#Replication.DeletingRepGroup.CLI) + [删除复制组 (ElastiCache API)](Replication.DeletingRepGroup.md#Replication.DeletingRepGroup.API) ### 删除服务相关角色（IAM 控制台） 您可以使用 IAM 控制台删除服务相关角色。 **删除服务相关角色（控制台）** 1. 登录 Amazon Web Services 管理控制台，打开 IAM 控制台：[https://console.aws.amazon.com/iam/](https://console.amazonaws.cn/iam/)。 1. 在 IAM 控制台的导航窗格中，选择**角色**。然后，选中要删除的角色名称旁边的复选框，而不是名称或行本身。 1. 对于页面顶部的**角色操作**，请选择**删除角色**。 1. 在确认对话框中，查看上次访问服务数据，该数据显示每个选定角色上次访问 Amazon 服务的时间。这样可帮助您确认角色当前是否处于活动状态。如果要继续，请选择 **Yes, Delete ** 以提交服务相关角色进行删除。 1. 监视 IAM 控制台通知，以监控服务相关角色的删除进度。由于 IAM 服务相关角色删除是异步的，因此，在您提交角色进行删除后，删除任务可能成功，也可能失败。如果任务失败，您可以从通知中选择 **View details** 或 **View Resources** 以了解删除失败的原因。 ### 删除服务相关角色（IAM CLI） 您可以从 Amazon Command Line Interface 中使用 IAM 操作删除服务相关角色。 **删除服务相关角色（CLI）** 1. 如果您不知道要删除的服务相关角色的名称，请输入以下命令。此命令会列出您账户中的角色及其 Amazon 资源名称（ARN）。 ``` $ aws iam [get-role](https://docs.amazonaws.cn/cli/latest/reference/iam/get-role.html) --role-name role-name ``` 通过 CLI 操作使用角色名称（并非 ARN）指向角色。例如，如果某个角色具有 ARN `arn:aws:iam::123456789012:role/myrole`，则将该角色称为 **myrole**。 1. 如果服务相关角色正被使用或具有关联的资源，则无法删除它，因此您必须提交删除请求。如果不满足这些条件，该请求可能会被拒绝。您必须从响应中捕获 `deletion-task-id` 以检查删除任务的状态。输入以下命令以提交服务相关角色的删除请求。 ``` $ aws iam [delete-service-linked-role](https://docs.amazonaws.cn/cli/latest/reference/iam/delete-service-linked-role.html) --role-name role-name ``` 1. 输入以下命令以检查删除任务的状态。 ``` $ aws iam [get-service-linked-role-deletion-status](https://docs.amazonaws.cn/cli/latest/reference/iam/get-service-linked-role-deletion-status.html) --deletion-task-id deletion-task-id ``` 删除任务的状态可能是 `NOT_STARTED`、`IN_PROGRESS`、`SUCCEEDED` 或 `FAILED`。如果删除失败，则调用会返回失败的原因，以便您进行问题排查。 ### 删除服务相关角色（IAM API） 您可以使用 IAM API 删除服务相关角色。 **删除服务相关角色（API）** 1. 要提交服务相关角色的删除请求，请调用 [DeleteServiceLinkedRole](https://docs.amazonaws.cn/IAM/latest/APIReference/API_DeleteServiceLinkedRole.html)。在请求中，指定角色名称。 如果服务相关角色正被使用或具有关联的资源，则无法删除它，因此您必须提交删除请求。如果不满足这些条件，该请求可能会被拒绝。您必须从响应中捕获 `DeletionTaskId` 以检查删除任务的状态。 1. 要检查删除的状态，请调用 [GetServiceLinkedRoleDeletionStatus](https://docs.amazonaws.cn/IAM/latest/APIReference/API_GetServiceLinkedRoleDeletionStatus.html)。在请求中，指定 `DeletionTaskId`。 删除任务的状态可能是 `NOT_STARTED`、`IN_PROGRESS`、`SUCCEEDED` 或 `FAILED`。如果删除失败，则调用会返回失败的原因，以便您进行问题排查。 # ElastiCache API 权限：操作、资源和条件参考 在设置[访问控制](IAM.md)以及编写可附加到 IAM 策略的权限策略（基于身份或基于资源）时，可将下表作为参考。此表列出每个 Amazon ElastiCache API 操作及您可授予执行该操作的权限的对应操作。您可以在策略的 `Action` 字段中指定这些操作，并在策略的 `Resource` 字段中指定资源值。除非另有说明，否则需要该资源。某些字段同时包含必需资源和可选资源。如果没有资源 ARN，则策略中的资源为通配符 (\$1)。 您可以在 ElastiCache 策略中使用条件键来表达条件。要查看特定于 ElastiCache 的条件键的列表以及它们适用的操作和资源类型，请参阅 [使用条件键](IAM.ConditionKeys.md)。有关 Amazon 范围的键的完整列表，请参阅《IAM 用户指南》**中的 [Amazon 全局条件上下文键](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_condition-keys.html)。 **注意** 要指定操作，请在 API 操作名称之前使用 `elasticache:` 前缀（例如，`elasticache:DescribeCacheClusters`）。 要查看 ElastiCache 操作的列表，请参阅《服务授权参考》**中的 [Amazon ElastiCache 定义的操作](https://docs.amazonaws.cn/service-authorization/latest/reference/list_amazonelasticache.html#amazonelasticache-actions-as-permissions)。