

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

# AWS Identity and Access Management 适用于 Amazon Keyspaces
<a name="security-iam"></a>

AWS Identity and Access Management (IAM) AWS 服务 可帮助管理员安全地控制对 AWS 资源的访问权限。IAM 管理员控制谁可以通过*身份验证*（登录）和*授权*（具有权限）使用 Amazon Keyspaces 资源。您可以使用 IAM AWS 服务 ，无需支付额外费用。

**Topics**
+ [受众](#security_iam_audience)
+ [使用身份进行身份验证](#security_iam_authentication)
+ [使用策略管理访问](#security_iam_access-manage)
+ [Amazon Keyspaces 如何与 IAM 配合使用](security_iam_service-with-iam.md)
+ [Amazon Keyspaces 基于身份的策略示例](security_iam_id-based-policy-examples.md)
+ [AWS Amazon Keyspaces 的托管策略](security-iam-awsmanpol.md)
+ [Amazon Keyspaces 身份和访问问题排查](security_iam_troubleshoot.md)
+ [对 Amazon Keyspaces 使用服务相关角色](using-service-linked-roles.md)

## 受众
<a name="security_iam_audience"></a>

您的使用方式 AWS Identity and Access Management (IAM) 因您的角色而异：
+ **服务用户**：如果您无法访问功能，请从管理员处请求权限（请参阅[Amazon Keyspaces 身份和访问问题排查](security_iam_troubleshoot.md)）
+ **服务管理员**：确定用户访问权限并提交权限请求（请参阅[Amazon Keyspaces 如何与 IAM 配合使用](security_iam_service-with-iam.md)）
+ **IAM 管理员**：编写用于管理访问权限的策略（请参阅[Amazon Keyspaces 基于身份的策略示例](security_iam_id-based-policy-examples.md)）

## 使用身份进行身份验证
<a name="security_iam_authentication"></a>

身份验证是您 AWS 使用身份凭证登录的方式。您必须以 IAM 用户身份进行身份验证 AWS 账户根用户，或者通过担任 IAM 角色进行身份验证。

您可以使用来自身份源的证书 AWS IAM Identity Center （例如（IAM Identity Center）、单点登录身份验证或 Google/Facebook 证书，以联合身份登录。有关登录的更多信息，请参阅《AWS 登录 用户指南》**中的[如何登录您的 AWS 账户](https://docs.aws.amazon.com/signin/latest/userguide/how-to-sign-in.html)。

对于编程访问， AWS 提供 SDK 和 CLI 来对请求进行加密签名。有关更多信息，请参阅*《IAM 用户指南》*中的[适用于 API 请求的AWS 签名版本 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)。

### AWS 账户 root 用户
<a name="security_iam_authentication-rootuser"></a>

 创建时 AWS 账户，首先会有一个名为 AWS 账户 *root 用户的*登录身份，该身份可以完全访问所有资源 AWS 服务 和资源。我们强烈建议不要使用根用户进行日常任务。有关要求根用户凭证的任务，请参阅*《IAM 用户指南》*中的[需要根用户凭证的任务](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)。

### IAM 用户和群组
<a name="security_iam_authentication-iamuser"></a>

*[IAM 用户](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users.html)*是对某个人员或应用程序具有特定权限的一个身份。建议使用临时凭证，而非具有长期凭证的 IAM 用户。有关更多信息，请参阅 *IAM 用户指南*[中的要求人类用户使用身份提供商的联合身份验证才能 AWS 使用临时证书进行访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp)。

[https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups.html)指定一组 IAM 用户，便于更轻松地对大量用户进行权限管理。有关更多信息，请参阅*《IAM 用户指南》*中的 [IAM 用户使用案例](https://docs.aws.amazon.com/IAM/latest/UserGuide/gs-identities-iam-users.html)。

### IAM 角色
<a name="security_iam_authentication-iamrole"></a>

*[IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)*是具有特定权限的身份，可提供临时凭证。您可以通过[从用户切换到 IAM 角色（控制台）](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-console.html)或调用 AWS CLI 或 AWS API 操作来代入角色。有关更多信息，请参阅《IAM 用户指南》**中的[担任角色的方法](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage-assume.html)。

IAM 角色对于联合用户访问、临时 IAM 用户权限、跨账户访问、跨服务访问以及在 Amazon EC2 上运行的应用程序非常有用。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的跨账户资源访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)。

## 使用策略管理访问
<a name="security_iam_access-manage"></a>

您可以 AWS 通过创建策略并将其附加到 AWS 身份或资源来控制中的访问权限。策略定义了与身份或资源关联时的权限。 AWS 在委托人提出请求时评估这些政策。大多数策略都以 JSON 文档的 AWS 形式存储在中。有关 JSON 策略文档的更多信息，请参阅*《IAM 用户指南》*中的 [JSON 策略概述](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#access_policies-json)。

管理员使用策略，通过定义哪个**主体**可以在什么**条件**下对哪些**资源**执行哪些**操作**来指定谁有权访问什么。

默认情况下，用户和角色没有权限。IAM 管理员创建 IAM 策略并将其添加到角色中，然后用户可以担任这些角色。IAM 策略定义权限，与执行操作所用的方法无关。

### 基于身份的策略
<a name="security_iam_access-manage-id-based-policies"></a>

基于身份的策略是您附加到身份（用户、组或角色）的 JSON 权限策略文档。这些策略控制身份可以执行什么操作、对哪些资源执行以及在什么条件下执行。要了解如何创建基于身份的策略，请参阅《IAM 用户指南》**中的[使用客户管理型策略定义自定义 IAM 权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)。

基于身份的策略可以是*内联策略*（直接嵌入到单个身份中）或*托管策略*（附加到多个身份的独立策略）。要了解如何在托管策略和内联策略之间进行选择，请参阅*《IAM 用户指南》*中的[在托管策略与内联策略之间进行选择](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-choosing-managed-or-inline.html)。

### 基于资源的策略
<a name="security_iam_access-manage-resource-based-policies"></a>

基于资源的策略是附加到资源的 JSON 策略文档。示例包括 IAM *角色信任策略*和 Amazon S3 *存储桶策略*。在支持基于资源的策略的服务中，服务管理员可以使用它们来控制对特定资源的访问。您必须在基于资源的策略中[指定主体](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html)。

基于资源的策略是位于该服务中的内联策略。您不能在基于资源的策略中使用 IAM 中的 AWS 托管策略。

### 访问控制列表 (ACLs)
<a name="security_iam_access-manage-acl"></a>

访问控制列表 (ACLs) 控制哪些委托人（账户成员、用户或角色）有权访问资源。 ACLs 与基于资源的策略类似，尽管它们不使用 JSON 策略文档格式。

Amazon S3 和 Amazon VPC 就是支持的服务示例 ACLs。 AWS WAF要了解更多信息 ACLs，请参阅《*亚马逊简单存储服务开发者指南*》中的[访问控制列表 (ACL) 概述](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html)。

### 其他策略类型
<a name="security_iam_access-manage-other-policies"></a>

AWS 支持其他策略类型，这些策略类型可以设置更常见的策略类型授予的最大权限：
+ **权限边界** – 设置基于身份的策略可以授予 IAM 实体的最大权限。有关更多信息，请参阅《 IAM 用户指南》**中的 [IAM 实体的权限边界](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html)。
+ **服务控制策略 (SCPs)**-在中指定组织或组织单位的最大权限 AWS Organizations。有关更多信息，请参阅《AWS Organizations 用户指南》**中的[服务控制策略](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html)。
+ **资源控制策略 (RCPs)**-设置账户中资源的最大可用权限。有关更多信息，请参阅《*AWS Organizations 用户指南》*中的[资源控制策略 (RCPs)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_rcps.html)。
+ **会话策略** – 在为角色或联合用户创建临时会话时，作为参数传递的高级策略。有关更多信息，请参阅《IAM 用户指南》**中的[会话策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session)。

### 多个策略类型
<a name="security_iam_access-manage-multiple-policies"></a>

当多个类型的策略应用于一个请求时，生成的权限更加复杂和难以理解。要了解在涉及多种策略类型时如何 AWS 确定是否允许请求，请参阅 *IAM 用户指南*中的[策略评估逻辑](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html)。

# Amazon Keyspaces 如何与 IAM 配合使用
<a name="security_iam_service-with-iam"></a>

在使用 IAM 管理对 Amazon Keyspaces 的访问之前，您应该了解哪些 IAM 功能可用于 Amazon Keyspaces。要全面了解 Amazon Keyspaces 和其他 AWS 服务如何与 IAM 配合使用，请参阅 IAM *用户指南中与 IAM 配合使用的AWS *[服务](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。

**Topics**
+ [Amazon Keyspaces 基于身份的策略](#security_iam_service-with-iam-id-based-policies)
+ [Amazon Keyspaces 基于资源的策略](#security_iam_service-with-iam-resource-based-policies)
+ [基于 Amazon Keyspaces 标签的授权](#security_iam_service-with-iam-tags)
+ [Amazon Keyspaces IAM 角色](#security_iam_service-with-iam-roles)

## Amazon Keyspaces 基于身份的策略
<a name="security_iam_service-with-iam-id-based-policies"></a>

通过使用 IAM 基于身份的策略，您可以指定允许或拒绝的操作和资源以及允许或拒绝操作的条件。Amazon Keyspaces 支持特定的操作、资源和条件键。要了解在 JSON 策略中使用的所有元素，请参阅《IAM 用户指南》中的 [IAM JSON 策略元素参考](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)**。

要查看 Amazon Keyspaces 服务特定的资源和操作以及可用于 IAM 权限策略的条件上下文键，请参阅《服务授权参考》**中的 [Amazon Keyspaces（Apache Cassandra 兼容）的操作、资源和条件键](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonkeyspacesforapachecassandra.html)。

### 操作
<a name="security_iam_service-with-iam-id-based-policies-actions"></a>

管理员可以使用 AWS JSON 策略来指定谁有权访问什么。也就是说，哪个**主体**可以对什么**资源**执行**操作**，以及在什么**条件**下执行。

JSON 策略的 `Action` 元素描述可用于在策略中允许或拒绝访问的操作。在策略中包含操作以授予执行关联操作的权限。

Amazon Keyspaces 中的策略操作在操作前面使用以下前缀：`cassandra:`。例如，要授予某人使用 Amazon Keyspaces `CREATE` CQL 语句创建 Amazon Keyspaces 键空间的权限，您应将 `cassandra:Create` 操作纳入其策略中。策略语句必须包含 `Action` 或 `NotAction` 元素。Amazon Keyspaces 定义了一组自己的操作，以描述您可以使用该服务执行的任务。

要在单个语句中指定多项操作，请使用逗号将它们隔开，如下所示：

```
"Action": [
      "cassandra:CREATE",
      "cassandra:MODIFY"
          ]
```

要查看 Amazon Keyspaces 操作的列表，请参阅《服务授权参考》**中的 [Amazon Keyspaces（Apache Cassandra 兼容）定义的操作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonkeyspacesforapachecassandra.html#amazonkeyspacesforapachecassandra-actions-as-permissions)。

### 资源
<a name="security_iam_service-with-iam-id-based-policies-resources"></a>

管理员可以使用 AWS JSON 策略来指定谁有权访问什么。也就是说，哪个**主体**可以对什么**资源**执行**操作**，以及在什么**条件**下执行。

`Resource` JSON 策略元素指定要向其应用操作的一个或多个对象。作为最佳实践，请使用其 [Amazon 资源名称（ARN）](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)指定资源。对于不支持资源级权限的操作，请使用通配符 (\$1) 指示语句应用于所有资源。

```
"Resource": "*"
```

在 Amazon Keyspaces 中，密钥空间、表和流可以在 IAM 权限`Resource`元素中使用。

**注意**  
要访问 Amazon Keyspaces 中的用户密钥空间和表，您的 IAM 策略必须`cassandra:Select`包含对系统表的权限：  

```
arn:${Partition}:cassandra:${Region}:${Account}:/keyspace/system*
```
这适用于以下场景：  
AWS 管理控制台访问权限
SDK 资源操作`GetKeyspace`，例如`GetTable``ListKeyspaces`、和 `ListTables`
标准 Apache Cassandra 客户端驱动程序连接，因为驱动程序会在连接初始化期间自动读取系统表
系统表是只读的，无法修改。

Amazon Keyspaces 键空间资源具有以下 ARN：

```
arn:${Partition}:cassandra:${Region}:${Account}:/keyspace/${keyspaceName}/
```

Amazon Keyspaces 表资源具有以下 ARN：

```
arn:${Partition}:cassandra:${Region}:${Account}:/keyspace/${keyspaceName}/table/${tableName}
```

Amazon Keyspaces 流资源具有以下 ARN：

```
arn:${Partition}:cassandra:{Region}:${Account}:/keyspace/${keyspaceName}/table/${tableName}/stream/${streamLabel}
```

有关格式的更多信息 ARNs，请参阅 [Amazon 资源名称 (ARNs) 和 AWS 服务命名空间](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)。

例如，要在语句中指定 `mykeyspace` 键空间，请使用以下 ARN：

```
"Resource": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/"
```

要指定属于特定账户的所有键空间，请使用通配符 (\$1)：

```
"Resource": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/*"
```

无法对特定资源执行某些 Amazon Keyspaces 操作，例如，用于创建资源的操作。在这些情况下，您必须使用通配符（\$1)。

```
"Resource": "*"
```

 例如，要向 IAM 委托人授予`mytable`在中的`SELECT`权限`mykeyspace`，该委托人必须同时具有读取`mytable`和的权限`keyspace/system*`。要在单个语句中指定多个资源，请 ARNs 用逗号分隔。

```
"Resource": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable",
            "arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*"
```

*要查看 Amazon Keyspaces 资源类型及其列表 ARNs，请参阅《服务授权参考》中的 [Amazon Keyspaces 定义的资源（适用于 Apache Cassandra）](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonkeyspacesforapachecassandra.html#amazonkeyspacesforapachecassandra-resources-for-iam-policies)。*要了解您可以在哪些操作中指定每个资源的 ARN，请参阅 [Amazon Keyspaces（Apache Cassandra 兼容）定义的操作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonkeyspacesforapachecassandra.html#amazonkeyspacesforapachecassandra-actions-as-permissions)。

### 条件键
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

管理员可以使用 AWS JSON 策略来指定谁有权访问什么。也就是说，哪个**主体**可以对什么**资源**执行**操作**，以及在什么**条件**下执行。

`Condition` 元素根据定义的条件指定语句何时执行。您可以创建使用[条件运算符](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)（例如，等于或小于）的条件表达式，以使策略中的条件与请求中的值相匹配。要查看所有 AWS 全局条件键，请参阅 *IAM 用户指南*中的[AWS 全局条件上下文密钥](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)。

Amazon Keyspaces 定义了自己的一组条件键，还支持使用一些全局条件键。要查看所有 AWS 全局条件键，请参阅 *IAM 用户指南*中的[AWS 全局条件上下文密钥](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)。



 所有 Amazon Keyspaces 操作都支持 `aws:RequestTag/${TagKey}`、`aws:ResourceTag/${TagKey}` 和 `aws:TagKeys` 条件键。有关更多信息，请参阅 [基于标签的 Amazon Keyspaces 资源访问](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-tags)。

要查看 Amazon Keyspaces 条件键的列表，请参阅《服务授权参考》**中的 [Amazon Keyspaces（Apache Cassandra 兼容）的条件键](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonkeyspacesforapachecassandra.html#amazonkeyspacesforapachecassandra-policy-keys)。要了解您可以对哪些操作和资源使用条件键，请参阅 [Amazon Keyspaces（Apache Cassandra 兼容）定义的操作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonkeyspacesforapachecassandra.html#amazonkeyspacesforapachecassandra-actions-as-permissions)。

### 示例
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>

要查看 Amazon Keyspaces 基于身份的策略的示例，请参阅[Amazon Keyspaces 基于身份的策略示例](security_iam_id-based-policy-examples.md)。

## Amazon Keyspaces 基于资源的策略
<a name="security_iam_service-with-iam-resource-based-policies"></a>

Amazon Keyspaces 不支持基于资源的策略。要查看详细的基于资源的策略页面示例，请参阅 [https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html](https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html)。

## 基于 Amazon Keyspaces 标签的授权
<a name="security_iam_service-with-iam-tags"></a>

您可以使用标签管理对 Amazon Keyspaces 资源的访问。要管理基于标签的资源访问，您可以使用 `cassandra:ResourceTag/key-name`、`aws:RequestTag/key-name` 或 `aws:TagKeys` 条件键在策略的[条件元素](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)中提供标签信息。有关标记 Amazon Keyspaces 资源的更多信息，请参阅[对 Amazon Keyspaces 资源使用标签和标注](tagging-keyspaces.md)。

要查看基于身份的策略（用于根据资源上的标签来限制对该资源的访问）的示例，请参阅[基于标签的 Amazon Keyspaces 资源访问](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-tags)。

## Amazon Keyspaces IAM 角色
<a name="security_iam_service-with-iam-roles"></a>

I [AM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)是您内部具有特定权限 AWS 账户 的实体。

### 将临时凭证用于 Amazon Keyspaces
<a name="security_iam_service-with-iam-roles-tempcreds"></a>

您可以使用临时凭证进行联合身份登录，来担任 IAM 角色或担任跨账户角色。您可以通过调用[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)或之类的 AWS STS API 操作来获取临时安全证书[GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html)。

Amazon Keyspaces 支持使用 Github 存储库中提供的 AWS 签名版本 4 (Sigv4) 身份验证插件的临时证书，适用于以下语言：
+ Java：[https://github.com/aws/aws-sigv4-auth-cassandra-java-driver-plugin](https://github.com/aws/aws-sigv4-auth-cassandra-java-driver-plugin)。
+ Node.js：[https://github.com/aws/aws-sigv4-auth-cassandra-nodejs-driver-plugin](https://github.com/aws/aws-sigv4-auth-cassandra-nodejs-driver-plugin)。
+ Python: [https://github.com/aws/aws-sigv4-auth-cassandra-python-driver-plugin](https://github.com/aws/aws-sigv4-auth-cassandra-python-driver-plugin)。
+ Go：[https://github.com/aws/aws-sigv4-auth-cassandra-gocql-driver-plugin](https://github.com/aws/aws-sigv4-auth-cassandra-gocql-driver-plugin)。

有关实现身份验证插件以编程方式访问 Amazon Keyspaces 的示例和教程，请参阅[使用 Cassandra 客户端驱动程序以编程方式访问 Amazon Keyspaces](programmatic.drivers.md)。

### 服务关联角色
<a name="security_iam_service-with-iam-roles-service-linked"></a>

[服务相关角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)允许 AWS 服务访问其他服务中的资源以代表您完成操作。服务关联角色显示在 IAM 账户中，并归该服务所有。IAM 管理员可以查看但不能编辑服务关联角色的权限。

有关创建或管理 Amazon Keyspaces 服务相关角色的详细信息，请参阅**[对 Amazon Keyspaces 使用服务相关角色](using-service-linked-roles.md)**。

### 服务角色
<a name="security_iam_service-with-iam-roles-service"></a>

Amazon Keyspaces 不支持服务角色。

# Amazon Keyspaces 基于身份的策略示例
<a name="security_iam_id-based-policy-examples"></a>

默认情况下，IAM 用户和角色没有创建或修改 Amazon Keyspaces 资源的权限。他们也无法使用控制台、CQLSH 或 AWS API 执行任务。 AWS CLI IAM 管理员必须创建 IAM 策略，以便为用户和角色授予权限以对所需的指定资源执行特定的 API 操作。然后，管理员必须将这些策略附加到需要这些权限的 IAM 用户或组。

要了解如何使用这些示例 JSON 策略文档创建 IAM 基于身份的策略，请参阅《*IAM 用户指南*》中的[在 JSON 选项卡上创建策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor)。

**Topics**
+ [策略最佳实践](#security_iam_service-with-iam-policy-best-practices)
+ [使用 Amazon Keyspaces 控制台](#security_iam_id-based-policy-examples-console)
+ [允许用户查看他们自己的权限](#security_iam_id-based-policy-examples-view-own-permissions)
+ [访问 Amazon Keyspaces 表](#security_iam_id-based-policy-examples-access-one-table)
+ [基于标签的 Amazon Keyspaces 资源访问](#security_iam_id-based-policy-examples-tags)

## 策略最佳实践
<a name="security_iam_service-with-iam-policy-best-practices"></a>

基于身份的策略确定某个人是否可以创建、访问或删除您账户中的 Amazon Keyspaces 资源。这些操作可能会使 AWS 账户产生成本。创建或编辑基于身份的策略时，请遵循以下指南和建议：
+ **开始使用 AWS 托管策略并转向最低权限权限** — 要开始向用户和工作负载授予权限，请使用为许多常见用例授予权限的*AWS 托管策略*。它们在你的版本中可用 AWS 账户。我们建议您通过定义针对您的用例的 AWS 客户托管策略来进一步减少权限。有关更多信息，请参阅《IAM 用户指南》**中的 [AWS 托管策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)或[工作职能的AWS 托管策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html)。
+ **应用最低权限**：在使用 IAM 策略设置权限时，请仅授予执行任务所需的权限。为此，您可以定义在特定条件下可以对特定资源执行的操作，也称为*最低权限许可*。有关使用 IAM 应用权限的更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的策略和权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。
+ **使用 IAM 策略中的条件进一步限制访问权限**：您可以向策略添加条件来限制对操作和资源的访问。例如，您可以编写策略条件来指定必须使用 SSL 发送所有请求。如果服务操作是通过特定的方式使用的，则也可以使用条件来授予对服务操作的访问权限 AWS 服务，例如 CloudFormation。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM JSON 策略元素：条件](https://docs.aws.amazon.com/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.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html)。
+ **需要多重身份验证 (MFA**)-如果 AWS 账户您的场景需要 IAM 用户或根用户，请启用 MFA 以提高安全性。若要在调用 API 操作时需要 MFA，请将 MFA 条件添加到您的策略中。有关更多信息，请参阅《IAM 用户指南》**中的[使用 MFA 保护 API 访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html)。

有关 IAM 中的最佳实操的更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的安全最佳实践](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)。

## 使用 Amazon Keyspaces 控制台
<a name="security_iam_id-based-policy-examples-console"></a>

Amazon Keyspaces 不要求您具备特定权限才能访问 Amazon Keyspaces 控制台。您至少需要具有只读权限才能列出和查看您的 Amazon Keyspaces 资源的详细信息。 AWS 账户如果您创建的基于身份的策略比所需的最低权限更严格，则无法为具有该策略的实体（IAM 用户或角色）正常运行控制台。

两个 AWS 托管策略可供实体使用 Amazon Keyspaces 控制台访问权限。
+ [AmazonKeyspacesReadOnlyAccess\$1v2](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonKeyspacesReadOnlyAccess_v2.html) — 此政策授予对 Amazon Keyspaces 的只读访问权限。
+ [AmazonKeyspacesFullAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonKeyspacesFullAccess.html)— 此政策授予使用 Amazon Keyspaces 的权限，并具有对所有功能的完全访问权限。

有关 Amazon Keyspaces 托管式策略的更多信息，请参阅 [AWS Amazon Keyspaces 的托管策略](security-iam-awsmanpol.md)。

## 允许用户查看他们自己的权限
<a name="security_iam_id-based-policy-examples-view-own-permissions"></a>

该示例说明了您如何创建策略，以允许 IAM 用户查看附加到其用户身份的内联和托管式策略。此策略包括在控制台上或使用 AWS CLI 或 AWS 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 Keyspaces 表
<a name="security_iam_id-based-policy-examples-access-one-table"></a>

**注意**  
要访问 Amazon Keyspaces 中的用户密钥空间和表，您的 IAM 策略必须`cassandra:Select`包含对系统表的权限：  

```
arn:${Partition}:cassandra:${Region}:${Account}:/keyspace/system*
```
这适用于以下场景：  
AWS 管理控制台访问权限
SDK 资源操作`GetKeyspace`，例如`GetTable``ListKeyspaces`、和 `ListTables`
标准 Apache Cassandra 客户端驱动程序连接，因为驱动程序会在连接初始化期间自动读取系统表
系统表是只读的，无法修改。

以下是授予对 Amazon Keyspaces 系统表的只读（`SELECT`）访问权限的示例策略。对于所有示例，请将 Amazon 资源名称（ARN）中的区域和账户 ID 替换为您自己的区域和账户 ID。

```
{
   "Version":"2012-10-17",		 	 	 
   "Statement":[
      {
         "Effect":"Allow",
         "Action":[
            "cassandra:Select"
         ],
         "Resource":[
            "arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*"
         ]
      }
   ]
}
```

以下示例策略添加对键空间 `mykeyspace` 中的用户表 `mytable` 的只读访问权限。

```
{
   "Version":"2012-10-17",		 	 	 
   "Statement":[
      {
         "Effect":"Allow",
         "Action":[
            "cassandra:Select"
         ],
         "Resource":[
            "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable",
            "arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*"
         ]
      }
   ]
}
```

以下示例策略分配了对用户表的 read/write 访问权限和对系统表的读取权限。

```
{
   "Version":"2012-10-17",		 	 	 
   "Statement":[
      {
         "Effect":"Allow",
         "Action":[
            "cassandra:Select",
            "cassandra:Modify"
         ],
         "Resource":[
            "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable",
            "arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*"
         ]
      }
   ]
}
```

以下示例策略允许用户在键空间 `mykeyspace` 中创建表。

```
{
   "Version":"2012-10-17",		 	 	 
   "Statement":[
      {
         "Effect":"Allow",
         "Action":[
            "cassandra:Create",
            "cassandra:Select"
         ],
         "Resource":[
            "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/*",
            "arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*"
         ]
      }
   ]
}
```

以下示例策略分配了对系统表的读取权限，但限制了对用户表的`SELECT`（读取）和`MODIFY`（写入）访问权限。`mytable`

```
{
  "Version": "2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cassandra:Select"
      ],
      "Resource": [
        "arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*"
      ]
    },
    {
      "Effect": "Deny",
      "Action": [
        "cassandra:Select",
        "cassandra:Modify"
      ],
      "Resource": [
        "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable"
      ]
    }
  ]
}
```

## 基于标签的 Amazon Keyspaces 资源访问
<a name="security_iam_id-based-policy-examples-tags"></a>

您可以在基于身份的策略中使用条件，以便基于标签控制对 Amazon Keyspaces 资源的访问。这些策略控制账户中键空间和表的可见性。请注意，与通过 Cassandra 驱动程序和开发者工具调用 Cassandra 查询语言 (CQL) API 相比，使用 AWS SDK 发出请求时，基于标签的系统表权限的行为有所不同。
+ 要在使用基于标签的访问权限时使用 AWS SDK 发出 `List` 和 `Get` 请求，调用者需要具有对系统表的读取权限。例如，需要 `Select` 操作权限才能通过 `GetTable` 操作从系统表读取数据。如果调用者对特定表只有基于标签的访问权限，则需要对系统表进行额外访问的操作将失败。
+ 为了与既定的 Cassandra 驱动程序行为兼容，当您通过 Cassandra 驱动程序和开发人员工具使用 Cassandra 查询语言 (CQL) API 调用对系统表执行操作时，系统不会强制实施基于标签的授权策略。

以下示例说明如何创建一个策略，该策略授予用户查看表的权限（如果表的 `Owner` 包含该用户的用户名的值）。在此示例中，您还授予对系统表的读取权限。

```
{
   "Version":"2012-10-17",		 	 	 
   "Statement":[
      {
         "Sid":"ReadOnlyAccessTaggedTables",
         "Effect":"Allow",
         "Action":"cassandra:Select",
         "Resource":[
            "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/*",
            "arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*"
         ],
         "Condition":{
            "StringEquals":{
               "aws:ResourceTag/Owner":"${aws:username}"
            }
         }
      }
   ]
}
```

您可以将该策略附加到您账户中的 IAM 用户。如果一个名为 `richard-roe` 的用户尝试查看 Amazon Keyspaces 表，则您必须为该表添加 `Owner=richard-roe` 或 `owner=richard-roe` 标签。否则，他将被拒绝访问。条件标签键 `Owner` 匹配 `Owner` 和 `owner`，因为条件键名称不区分大小写。有关更多信息，请参阅*《IAM 用户指南》*中的 [IAM JSON 策略元素：条件](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)。

以下策略授予用户创建带有标签的表的权限（如果表的 `Owner` 包含该用户的用户名的值）。

```
{ 
    "Version": "2012-10-17",		 	 	  
    "Statement": [ 
       { 
          "Sid": "CreateTagTableUser", 
          "Effect": "Allow", 
          "Action": [
              "cassandra:Create", 
              "cassandra:TagResource"
          ], 
          "Resource": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/*", 
          "Condition":{
             "StringEquals":{
                "aws:RequestTag/Owner":"${aws:username}"
            }
         }
      }
   ]
}
```

# AWS Amazon Keyspaces 的托管策略
<a name="security-iam-awsmanpol"></a>





 AWS 托管策略是由创建和管理的独立策略 AWS。 AWS 托管策略旨在为许多常见用例提供权限，以便您可以开始为用户、组和角色分配权限。

请记住， AWS 托管策略可能不会为您的特定用例授予最低权限权限，因为它们可供所有 AWS 客户使用。我们建议通过定义特定于使用案例的[客户管理型策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#customer-managed-policies)来进一步减少权限。

您无法更改 AWS 托管策略中定义的权限。如果 AWS 更新 AWS 托管策略中定义的权限，则更新会影响该策略所关联的所有委托人身份（用户、组和角色）。 AWS 最有可能在启动新的 API 或现有服务可以使用新 AWS 服务 的 API 操作时更新 AWS 托管策略。

有关更多信息，请参阅《IAM 用户指南》**中的 [AWS 托管式策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)。









## AWS 托管策略： AmazonKeyspacesReadOnlyAccess\$1v2
<a name="security-iam-awsmanpol-AmazonKeyspacesReadOnlyAccess_v2"></a>





您可以将 `AmazonKeyspacesReadOnlyAccess_v2` 策略附加到 IAM 身份。



该策略授予对 Amazon Keyspaces 的只读访问权限，并包括通过私有 VPC 端点进行连接时所需的权限。



**权限详细信息**

该策略包含以下权限。




+ `Amazon Keyspaces`：提供对 Amazon Keyspaces 的只读访问权限。
+ `Amazon Keyspaces CDC streams`— 允许委托人查看 Amazon Keyspaces CDC 直播。
+ `Application Auto Scaling`：允许主体从 Application Auto Scaling 查看配置。这是必需权限，以便用户可以查看附加到表的自动扩展策略。
+ `CloudWatch`— 允许委托人查看中 CloudWatch配置的指标数据和警报。这是必需的，这样用户才能查看为表配置的可计费表大小和 CloudWatch 警报。
+ `AWS KMS`— 允许委托人查看中 AWS KMS配置的密钥。这是必需的，这样用户才能查看他们在账户中创建和管理的 AWS KMS 密钥，以确认分配给 Amazon Keyspaces 的密钥是已启用的对称加密密钥。
+ `Amazon EC2`：允许主体通过 VPC 端点连接到 Amazon Keyspaces，以查询 Amazon EC2 实例上的 VPC，从而获取端点和网络接口信息。必须具有对 Amazon EC2 实例的这种只读访问权限，这样 Amazon Keyspaces 才能在用于连接负载均衡的 `system.peers` 表中查找和存储可用的接口 VPC 端点。



要查看政策的`JSON`格式，请参阅 [AmazonKeyspacesReadOnlyAccess\$1v2](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonKeyspacesReadOnlyAccess_v2.html)。

## AWS 托管策略： AmazonKeyspacesReadOnlyAccess
<a name="security-iam-awsmanpol-AmazonKeyspacesReadOnlyAccess"></a>





您可以将 `AmazonKeyspacesReadOnlyAccess` 策略附加到 IAM 身份。



此策略将授予对 Amazon Keyspaces 的只读访问权限。



**权限详细信息**

该策略包含以下权限。




+ `Amazon Keyspaces`：提供对 Amazon Keyspaces 的只读访问权限。
+ `Amazon Keyspaces CDC streams`— 允许委托人查看 Amazon Keyspaces CDC 直播。
+ `Application Auto Scaling`：允许主体从 Application Auto Scaling 查看配置。这是必需权限，以便用户可以查看附加到表的自动扩展策略。
+ `CloudWatch`— 允许委托人查看中 CloudWatch配置的指标数据和警报。这是必需的，这样用户才能查看为表配置的可计费表大小和 CloudWatch 警报。
+ `AWS KMS`— 允许委托人查看中 AWS KMS配置的密钥。这是必需的，这样用户才能查看他们在账户中创建和管理的 AWS KMS 密钥，以确认分配给 Amazon Keyspaces 的密钥是已启用的对称加密密钥。



要查看政策的`JSON`格式，请参阅[AmazonKeyspacesReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonKeyspacesReadOnlyAccess.html)。

## AWS 托管策略： AmazonKeyspacesFullAccess
<a name="security-iam-awsmanpol-AmazonKeyspacesFullAccess"></a>





您可以将 `AmazonKeyspacesFullAccess` 策略附加到 IAM 身份。



此策略授予管理权限，允许您的管理员不受限制地访问 Amazon Keyspaces。



**权限详细信息**

该策略包含以下权限。




+ `Amazon Keyspaces`：允许主体访问任何 Amazon Keyspaces 资源并执行所有操作。
+ `Application Auto Scaling`：允许主体创建、查看和删除 Amazon Keyspaces 表的自动扩展策略。这是必需权限，以便管理员可以管理 Amazon Keyspaces 表的自动扩展策略。
+ `CloudWatch`— 允许委托人查看计费表的大小，以及创建、查看和删除 Amazon Keyspaces 自动扩展策略的 CloudWatch 警报。这是必需的，这样管理员才能查看计费表的大小并创建 CloudWatch 仪表板。
+ `IAM`：允许 Amazon Keyspaces 在启用以下功能时自动使用 IAM 创建服务相关角色：
  + `Amazon Keyspaces CDC streams`— 当管理员为表启用直播时，Amazon Keyspaces 会创建服务相关角色 [AWSServiceRoleForAmazonKeyspacesCDC](using-service-linked-roles-CDC-streams.md#service-linked-role-permissions-CDC-streams)，代表您向您的账户发布 CloudWatch 指标。
  + `Application Auto Scaling`— 当管理员为表启用 Application Auto Scaling 时，Amazon Keyspaces 会创建服务相关角色[AWSServiceRoleForApplicationAutoScaling\$1CassandraTable](using-service-linked-roles-app-auto-scaling.md#service-linked-role-permissions-app-auto-scaling)来代表您执行自动扩展操作。
  + `Amazon Keyspaces multi-Region replication`— 当管理员创建新的多区域密钥空间或 AWS 区域 向现有的单区域密钥空间添加新的密钥空间时，Amazon Keyspaces 会创建服务相关[AWSServiceRoleForAmazonKeyspacesReplication](using-service-linked-roles-multi-region-replication.md#service-linked-role-permissions-multi-region-replication)角色来代表您向选定区域执行表、数据和元数据的复制。
+ `AWS KMS`：允许主体查看 AWS KMS中配置的密钥。这是必需的，这样用户才能查看他们在账户中创建和管理的 AWS KMS 密钥，以确认分配给 Amazon Keyspaces 的密钥是已启用的对称加密密钥。
+ `Amazon EC2`：允许主体通过 VPC 端点连接到 Amazon Keyspaces，以查询 Amazon EC2 实例上的 VPC，从而获取端点和网络接口信息。必须具有对 Amazon EC2 实例的这种只读访问权限，这样 Amazon Keyspaces 才能在用于连接负载均衡的 `system.peers` 表中查找和存储可用的接口 VPC 端点。



要查看政策的`JSON`格式，请参阅[AmazonKeyspacesFullAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonKeyspacesFullAccess.html)。

## AWS 托管策略：Keyspaces CDCService RolePolicy
<a name="security-iam-awsmanpol-KeyspacesCDCServiceRolePolicy"></a>





您不能将 `KeyspacesCDCServiceRolePolicy` 附加到自己的 IAM 实体。本政策附属于一个服务相关角色，该角色允许 Amazon Keyspaces 代表您执行操作。有关更多信息，请参阅 [在 Amazon Keyspaces CDC 直播中使用角色](using-service-linked-roles-CDC-streams.md)。



此政策向服务相关角色`AWSServiceRoleForAmazonKeyspacesCDC`授予代表您发布 Amazon Keyspaces CDC 流媒体指标数据 CloudWatch 所需的权限。



**权限详细信息**

该策略包含以下权限。




+ `CloudWatch`— 允许 service-linked-role [AWSServiceRoleForAmazonKeyspacesCDC 代表](using-service-linked-roles-CDC-streams.md#service-linked-role-permissions-CDC-streams)您将 Amazon Keyspaces CDC 数据流`"cloudwatch:namespace": "AWS/Cassandra"`中的指标数据发布到您的 CloudWatch 账户中。



要查看政策的`JSON`格式，请参阅 [Key CDCService RolePolicy](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/KeyspacesCDCServiceRolePolicy.html) spaces。





## Amazon Keyspaces 更新了托管 AWS 策略
<a name="security-iam-awsmanpol-updates"></a>



查看自该服务开始跟踪这些更改以来，Amazon Keyspaces AWS 托管策略更新的详细信息。要获得有关此页面更改的自动提示，请订阅 [Amazon Keyspaces（Apache Cassandra 兼容）的文档历史记录](doc-history.md) 页面上的 RSS 源。




| 更改 | 描述 | 日期 | 
| --- | --- | --- | 
|  [Keyspaces CDCService RolePolicy](#security-iam-awsmanpol-KeyspacesCDCServiceRolePolicy)-新政策  |  Amazon Keyspaces 添加了一项新的托管策略`KeyspacesCDCServiceRolePolicy`，该策略向服务相关角色授予代表您`AWSServiceRoleForAmazonKeyspacesCDC`发布 Amazon Keyspaces CDC 流媒体指标数据所需的权限。 CloudWatch 有关更多信息，请参阅 [在 Amazon Keyspaces CDC 直播中使用角色](using-service-linked-roles-CDC-streams.md)。  | 2025 年 7 月 2 日 | 
|  [AmazonKeyspacesReadOnlyAccess\$1v2](#security-iam-awsmanpol-AmazonKeyspacesReadOnlyAccess_v2) — 更新现有策略  |  Amazon Keyspaces 添加了新的权限，允许 IAM 委托人查看 Amazon Keyspaces CDC 直播。有关更多信息，请参阅 [在 Amazon Keyspaces 中查看 CDC 直播](keyspaces-view-cdc.md)。  | 2025 年 7 月 2 日 | 
|  [AmazonKeyspacesReadOnlyAccess](#security-iam-awsmanpol-AmazonKeyspacesReadOnlyAccess)：对现有策略的更新  |  Amazon Keyspaces 添加了新的权限，允许 IAM 委托人查看 Amazon Keyspaces CDC 直播。有关更多信息，请参阅 [在 Amazon Keyspaces 中查看 CDC 直播](keyspaces-view-cdc.md)。  | 2025 年 7 月 2 日 | 
|  [AmazonKeyspacesFullAccess](#security-iam-awsmanpol-AmazonKeyspacesFullAccess)：对现有策略的更新  |  Amazon Keyspaces 为服务关联角色 [AWSServiceRoleForAmazonKeyspacesCDC](using-service-linked-roles-CDC-streams.md#service-linked-role-permissions-CDC-streams) 创建了`KeyspacesCDCServiceRolePolicy`托管策略，以添加管理员为表启用流时所需的权限。 Amazon Keyspaces 使用服务相关角色代表您`AWSServiceRoleForAmazonKeyspacesCDC`向您的账户发布 CloudWatch 指标。有关更多信息，请参阅 [在 Amazon Keyspaces CDC 直播中使用角色](using-service-linked-roles-CDC-streams.md)。  | 2025 年 7 月 2 日 | 
|  [AmazonKeyspacesFullAccess](#security-iam-awsmanpol-AmazonKeyspacesFullAccess)：对现有策略的更新  |  Amazon Keys `KeyspacesReplicationServiceRolePolicy` paces 更新了服务关联角色，添加了管理员[AWSServiceRoleForAmazonKeyspacesReplication](using-service-linked-roles-multi-region-replication.md#service-linked-role-permissions-multi-region-replication)向单区域或多区域密钥空间添加新 AWS 区域 密钥空间时所需的权限。 Amazon Keyspaces 使用服务相关角色`AWSServiceRoleForAmazonKeyspacesReplication`代表您复制表、表的设置和数据。有关更多信息，请参阅 [使用角色进行 Amazon Keyspaces 多区域复制](using-service-linked-roles-multi-region-replication.md)。  | 2024 年 11 月 19 日 | 
|  [AmazonKeyspacesFullAccess](#security-iam-awsmanpol-AmazonKeyspacesFullAccess)：对现有策略的更新  |  Amazon Keyspaces 添加了新的权限，允许在管理员向单区域或多区域密钥空间添加新区域时，Amazon Keyspaces 创建服务相关角色。 Amazon KeysSpaces 使用服务相关角色代表您执行数据复制任务。有关更多信息，请参阅 [使用角色进行 Amazon Keyspaces 多区域复制](using-service-linked-roles-multi-region-replication.md)。  | 2023 年 10 月 3 日 | 
|  [AmazonKeyspacesReadOnlyAccess\$1v2 — 新](#security-iam-awsmanpol-AmazonKeyspacesReadOnlyAccess)政策  |  Amazon Keyspaces 创建了一项新策略，为通过接口 VPC 终端节点连接到 Amazon Keyspaces 的客户端添加只读权限，以访问 Amazon EC2 实例以查找网络信息。 Amazon Keyspaces 将可用的接口 VPC 端点存储在 `system.peers` 表中，以实现连接负载均衡。有关更多信息，请参阅 [将 Amazon Keyspaces 与接口 VPC 端点结合使用](vpc-endpoints.md)。  | 2023 年 9 月 12 日 | 
|  [AmazonKeyspacesFullAccess](#security-iam-awsmanpol-AmazonKeyspacesFullAccess)：对现有策略的更新  |  Amazon Keyspaces 添加了新权限，以允许 Amazon Keyspaces 在管理员创建多区域键空间时创建服务相关角色。 Amazon Keyspaces 使用服务相关角色`AWSServiceRoleForAmazonKeyspacesReplication`代表您执行数据复制任务。有关更多信息，请参阅 [使用角色进行 Amazon Keyspaces 多区域复制](using-service-linked-roles-multi-region-replication.md)。  | 2023 年 6 月 5 日 | 
|  [AmazonKeyspacesReadOnlyAccess](#security-iam-awsmanpol-AmazonKeyspacesReadOnlyAccess)：对现有策略的更新  |  Amazon Keyspaces 添加了新的权限，允许用户使用查看表的计费大小。 CloudWatch Amazon Keyspaces 与亚马逊集成， CloudWatch 允许您监控计费表的大小。有关更多信息，请参阅 [Amazon Keyspaces 指标](metrics-dimensions.md#keyspaces-metrics-dimensions)。  | 2022 年 7 月 7 日 | 
|  [AmazonKeyspacesFullAccess](#security-iam-awsmanpol-AmazonKeyspacesFullAccess)：对现有策略的更新  |  Amazon Keyspaces 添加了新的权限，允许用户使用查看表的计费大小。 CloudWatch Amazon Keyspaces 与亚马逊集成， CloudWatch 允许您监控计费表的大小。有关更多信息，请参阅 [Amazon Keyspaces 指标](metrics-dimensions.md#keyspaces-metrics-dimensions)。  | 2022 年 7 月 7 日 | 
|  [AmazonKeyspacesReadOnlyAccess](#security-iam-awsmanpol-AmazonKeyspacesReadOnlyAccess)：对现有策略的更新  |  Amazon Keyspaces 添加了新的权限，允许用户查看为静态亚马逊 AWS KMS 密钥空间加密配置的密钥。 Amazon Keyspaces 静态加密与集成， AWS KMS 用于保护和管理用于加密静态数据的加密密钥。要查看为 Amazon Keyspaces 配置的密 AWS KMS 钥，已添加只读权限。  | 2021 年 6 月 1 日 | 
|  [AmazonKeyspacesFullAccess](#security-iam-awsmanpol-AmazonKeyspacesFullAccess)：对现有策略的更新  |  Amazon Keyspaces 添加了新的权限，允许用户查看为静态亚马逊 AWS KMS 密钥空间加密配置的密钥。 Amazon Keyspaces 静态加密与集成， AWS KMS 用于保护和管理用于加密静态数据的加密密钥。要查看为 Amazon Keyspaces 配置的密 AWS KMS 钥，已添加只读权限。  | 2021 年 6 月 1 日 | 
|  Amazon Keyspaces 开始跟踪更改  |  Amazon Keyspaces 开始跟踪其 AWS 托管策略的变更。  | 2021 年 6 月 1 日 | 

# Amazon Keyspaces 身份和访问问题排查
<a name="security_iam_troubleshoot"></a>

您可以使用以下信息，帮助诊断和修复在使用 Amazon Keyspaces 和 IAM 时可能遇到的常见问题。

**Topics**
+ [我无权在 Amazon Keyspaces 中执行操作](#security_iam_troubleshoot-no-permissions)
+ [我修改了 IAM 用户或角色，但更改没有立即生效](#security_iam_troubleshoot-effect)
+ [我无法使用 Amazon Keyspaces point-in-time 恢复 (PITR) 来恢复表](#security_iam_troubleshoot-pitr)
+ [我无权执行 iam：PassRole](#security_iam_troubleshoot-passrole)
+ [我是管理员并希望允许其他人访问 Amazon Keyspaces](#security_iam_troubleshoot-admin-delegate)
+ [我想允许我以外的人访问我的 Amazon Keyspaces 资源 AWS 账户](#security_iam_troubleshoot-cross-account-access)

## 我无权在 Amazon Keyspaces 中执行操作
<a name="security_iam_troubleshoot-no-permissions"></a>

如果 AWS 管理控制台 告诉您您无权执行某项操作，则必须联系管理员寻求帮助。管理员是指提供用户名和密码的人员。

当 `mateojackson` IAM 用户尝试使用控制台查看有关表的详细信息*table*但没有该表的`cassandra:Select`权限时，就会出现以下示例错误。

```
User: arn:aws:iam::123456789012:user/mateojackson is not authorized to perform: cassandra:Select on resource: mytable
```

在这种情况下，Mateo 请求他的管理员更新其策略，以允许他使用 `cassandra:Select` 操作访问 `mytable` 资源。

## 我修改了 IAM 用户或角色，但更改没有立即生效
<a name="security_iam_troubleshoot-effect"></a>

对于已与 Amazon Keyspaces 建立连接的应用程序，IAM 政策更改最多可能需要 10 分钟才能生效。当应用程序建立新连接时，IAM 策略更改会立即生效。如果您对现有 IAM 用户或角色进行了修改，但修改尚未立即生效，请等待 10 分钟，或者断开连接并重新连接到 Amazon Keyspaces。

## 我无法使用 Amazon Keyspaces point-in-time 恢复 (PITR) 来恢复表
<a name="security_iam_troubleshoot-pitr"></a>

如果您正在尝试使用恢复 (PITR) point-in-time 恢复 Amazon Keyspaces 表，但看到恢复过程已开始但未成功完成，则可能没有配置恢复过程所需的所有必要权限。您必须联系您的管理员寻求帮助，并要求该人员更新您的策略，以允许您还原 Amazon Keyspaces 中的表。

除了用户权限之外，Amazon Keyspaces 可能还需要在还原过程中代表您的主体执行操作的权限。如果表使用客户自主管理型密钥加密，或者您使用限制传入流量的 IAM 策略，就会出现这种情况。例如，如果您在 IAM 策略中使用条件键将源流量限制到特定端点或 IP 范围，则还原操作会失败。要允许 Amazon Keyspaces 代表您的主体执行表恢复操作，必须在 IAM 策略中添加 `aws:ViaAWSService` 全局条件键。

有关恢复表所需的权限的更多信息，请参阅[为 Amazon Keyspaces PITR 配置还原表 IAM 权限](howitworks_restore_permissions.md)。

## 我无权执行 iam：PassRole
<a name="security_iam_troubleshoot-passrole"></a>

如果您收到一个错误消息，其中指明您无权执行 `iam:PassRole` 操作，则必须更新策略以允许您将角色传递给 Amazon Keyspaces。

有些 AWS 服务 允许您将现有角色传递给该服务，而不是创建新的服务角色或服务相关角色。为此，您必须具有将角色传递到服务的权限。

当名为 `marymajor` 的 IAM 用户尝试使用控制台在 Amazon Keyspaces 中执行操作时，会发生以下示例错误。但是，服务必须具有服务角色所授予的权限才可执行此操作。Mary 不具有将角色传递到服务的权限。

```
User: arn:aws:iam::123456789012:user/marymajor is not authorized to perform: iam:PassRole
```

在这种情况下，必须更新 Mary 的策略以允许她执行 `iam:PassRole` 操作。

如果您需要帮助，请联系您的 AWS 管理员。您的管理员是提供登录凭证的人。

## 我是管理员并希望允许其他人访问 Amazon Keyspaces
<a name="security_iam_troubleshoot-admin-delegate"></a>

要允许其他人访问 Amazon Keyspaces，您必须向需要访问的人员或应用程序授予权限。如果使用 AWS IAM Identity Center 管理人员和应用程序，则可以向用户或组分配权限集来定义其访问权限级别。权限集会自动创建 IAM 策略并将其分配给与人员或应用程序关联的 IAM 角色。有关更多信息，请参阅《AWS IAM Identity Center 用户指南》**中的[权限集](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html)。

如果未使用 IAM Identity Center，则必须为需要访问的人员或应用程序创建 IAM 实体（用户或角色）。然后，您必须将策略附加到实体，以便在 Amazon Keyspaces 中为他们（它们）授予正确的权限。授予权限后，向用户或应用程序开发人员提供凭证。他们将使用这些凭证访问 AWS。要了解有关创建 IAM 用户、组、策略和权限的更多信息，请参阅《IAM 用户指南》**中的 [IAM 身份](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html)和 [IAM 中的策略和权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。

## 我想允许我以外的人访问我的 Amazon Keyspaces 资源 AWS 账户
<a name="security_iam_troubleshoot-cross-account-access"></a>

您可以创建一个角色，以便其他账户中的用户或您组织外的人员可以使用该角色来访问您的资源。您可以指定谁值得信赖，可以代入角色。对于支持基于资源的策略或访问控制列表 (ACLs) 的服务，您可以使用这些策略向人们授予访问您的资源的权限。

要了解更多信息，请参阅以下内容：
+ 要了解 Amazon Keyspaces 是否支持这些功能，请参阅 [Amazon Keyspaces 如何与 IAM 配合使用](security_iam_service-with-iam.md)。
+ 要了解如何提供对您拥有的资源的访问权限 AWS 账户 ，请参阅 [IAM 用户*指南中的向您拥有 AWS 账户 的另一个 IAM 用户*提供访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_aws-accounts.html)权限。
+ 要了解如何向第三方提供对您的资源的访问[权限 AWS 账户，请参阅 *IAM 用户指南*中的向第三方提供](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html)访问权限。 AWS 账户 
+ 要了解如何通过身份联合验证提供访问权限，请参阅《IAM 用户指南》**中的[为经过外部身份验证的用户（身份联合验证）提供访问权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_federated-users.html)。
+ 要了解使用角色和基于资源的策略进行跨账户访问之间的差别，请参阅《IAM 用户指南》**中的 [IAM 中的跨账户资源访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)。

# 对 Amazon Keyspaces 使用服务相关角色
<a name="using-service-linked-roles"></a>

[Amazon Keyspaces（适用于 Apache Cassandra）使用 AWS Identity and Access Management (IAM) 服务相关角色。](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)服务相关角色是一种独特类型的 IAM 角色，它与 Amazon Keyspaces 直接相关。服务相关角色由 Amazon Keyspaces 预定义，包括该服务代表您调用 AWS 其他服务所需的所有权限。

有关支持服务相关角色的其他服务的信息，请参阅与 [IAM 配合使用的AWS 服务，](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)并在**服务相关角色**列中查找标有 “**是**” 的服务。选择**是**和链接，查看该服务的服务关联角色文档。

**Topics**
+ [使用角色实现 Amazon Keyspaces 应用程序自动扩缩](using-service-linked-roles-app-auto-scaling.md)
+ [使用角色进行 Amazon Keyspaces 多区域复制](using-service-linked-roles-multi-region-replication.md)
+ [在 Amazon Keyspaces CDC 直播中使用角色](using-service-linked-roles-CDC-streams.md)

# 使用角色实现 Amazon Keyspaces 应用程序自动扩缩
<a name="using-service-linked-roles-app-auto-scaling"></a>

[Amazon Keyspaces（适用于 Apache Cassandra）使用 AWS Identity and Access Management (IAM) 服务相关角色。](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)服务相关角色是一种独特类型的 IAM 角色，它与 Amazon Keyspaces 直接相关。服务相关角色由 Amazon Keyspaces 预定义，包括该服务代表您调用 AWS 其他服务所需的所有权限。

服务相关角色可让您更轻松地设置 Amazon Keyspaces，因为您不必手动添加必要的权限。Amazon Keyspaces 定义其服务相关角色的权限，除非另外定义，否则只有 Amazon Keyspaces 可以代入该角色。定义的权限包括信任策略和权限策略，而且权限策略不能附加到任何其它 IAM 实体。

只有在首先删除服务相关角色的相关资源后，才能删除该角色。这将保护您的 Amazon Keyspaces 资源，因为您不会无意中删除对资源的访问权限。

## Amazon Keyspaces 的服务相关角色权限
<a name="service-linked-role-permissions-app-auto-scaling"></a>

Amazon Keyspaces 使用名为**AWSServiceRoleForApplicationAutoScaling\$1CassandraTable**的服务相关角色允许 Auto Scaling 代表您调用亚马逊密钥空间和亚马逊。 CloudWatch 

 AWSServiceRoleForApplicationAutoScaling\$1CassandraTable 服务相关角色信任以下服务来代入该角色：
+ `cassandra.application-autoscaling.amazonaws.com`

角色权限策略允许 Application Auto Scaling 在指定的 Amazon Keyspaces 资源上完成以下操作：
+ 操作：`arn:*:cassandra:*:*:/keyspace/system/table/*` 上的 `cassandra:Select`
+ 操作：资源 `arn:*:cassandra:*:*:/keyspace/system_schema/table/*` 上的 `cassandra:Select`
+ 操作：资源 `arn:*:cassandra:*:*:/keyspace/system_schema_mcs/table/*` 上的 `cassandra:Select`
+ 操作：资源 `arn:*:cassandra:*:*:"*"` 上的 `cassandra:Alter`

## 为 Amazon Keyspaces 创建服务相关角色
<a name="create-service-linked-role-app-auto-scaling"></a>

您无需手动为 Amazon Keyspaces 自动扩展创建服务相关角色。当您使用 AWS 管理控制台、CQL、或 AWS API 在表上启用 Amazon Keyspaces 自动扩展时，Application Auto Scaling 会为您创建服务相关角色。 AWS CLI

如果您删除该服务关联角色，然后需要再次创建，您可以使用相同流程在账户中重新创建此角色。当为表启用 Amazon Keyspaces 自动扩缩时，Application Auto Scaling 会再次为您创建服务相关角色。

**重要**  
 如果您在其他使用此角色支持的功能的服务中完成某个操作，此服务关联角色可以出现在您的账户中。要了解更多信息，请参阅 “[我的” 中出现了一个新角色 AWS 账户](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_new-role-appeared)。

## 为 Amazon Keyspaces 编辑服务相关角色
<a name="edit-service-linked-role-app-auto-scaling"></a>

Amazon Keyspaces 不允许您编辑 AWSServiceRoleForApplicationAutoScaling\$1CassandraTable 服务相关角色。创建服务关联角色后，您将无法更改角色的名称，因为可能有多种实体引用该角色。但是可以使用 IAM 编辑角色描述。有关更多信息，请参阅《IAM 用户指南》**中的[编辑服务关联角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。

## 删除适用于 Amazon Keyspaces 的服务相关角色
<a name="delete-service-linked-role-app-auto-scaling"></a>

如果您不再需要使用某个需要服务相关角色的特征或服务，我们建议您删除该角色。这样您就没有未被主动监控或维护的未使用实体。但是，必须先禁用账户中所有表的自动缩放功能， AWS 区域 然后才能手动删除服务相关角色。要对 Amazon Keyspaces 表禁用自动扩缩，请参阅[为表关闭 Amazon Keyspaces 自动扩缩](autoscaling.turnoff.md)。

**注意**  
如果在您尝试修改资源时 Amazon Keyspaces 自动扩展使用该角色，则取消注册可能会失败。如果发生这种情况，请等待几分钟后重试。

**使用 IAM 手动删除服务关联角色**

使用 IAM 控制台 AWS CLI、或 AWS API 删除 AWSServiceRoleForApplicationAutoScaling\$1CassandraTable 服务相关角色。有关更多信息，请参见《IAM 用户指南》**中的[删除服务相关角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)。

**注意**  
要删除 Amazon Keyspaces 自动扩展所使用的服务相关角色，您必须首先禁用账户中所有表的自动扩展。

## Amazon Keyspaces 服务相关角色支持的区域
<a name="slr-regions-app-auto-scaling"></a>

Amazon Keyspaces 支持在该服务可用的所有区域中使用服务相关角色。有关更多信息，请参阅 [Amazon Keyspaces 服务端点](https://docs.aws.amazon.com/keyspaces/latest/devguide/programmatic.endpoints.html)。

# 使用角色进行 Amazon Keyspaces 多区域复制
<a name="using-service-linked-roles-multi-region-replication"></a>

[Amazon Keyspaces（适用于 Apache Cassandra）使用 AWS Identity and Access Management (IAM) 服务相关角色。](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)服务相关角色是一种独特类型的 IAM 角色，它与 Amazon Keyspaces 直接相关。服务相关角色由 Amazon Keyspaces 预定义，包括该服务代表您调用 AWS 其他服务所需的所有权限。

服务相关角色可让您更轻松地设置 Amazon Keyspaces，因为您不必手动添加必要的权限。Amazon Keyspaces 定义其服务相关角色的权限，除非另外定义，否则只有 Amazon Keyspaces 可以代入该角色。定义的权限包括信任策略和权限策略，而且权限策略不能附加到任何其它 IAM 实体。

只有在首先删除服务相关角色的相关资源后，才能删除该角色。这将保护您的 Amazon Keyspaces 资源，因为您不会无意中删除对资源的访问权限。

## Amazon Keyspaces 的服务相关角色权限
<a name="service-linked-role-permissions-multi-region-replication"></a>

Amazon Keyspaces 使用名为的服务相关角色来**AWSServiceRoleForAmazonKeyspacesReplication**允许 Amazon Keyspaces 代表您 AWS 区域 向密钥空间添加新内容，并将表及其所有数据和设置复制到新区域。该角色还允许 Amazon Keyspaces 代表您复制对所有区域中表的写入操作。

 AWSServiceRoleForAmazonKeyspacesReplication 服务相关角色信任以下服务来代入该角色：
+ `replication.cassandra.amazonaws.com`

名为的角色权限策略 KeyspacesReplicationServiceRolePolicy 允许 Amazon Keyspaces 完成以下操作：
+ 操作：`cassandra:Select`
+ 操作：`cassandra:SelectMultiRegionResource`
+ 操作：`cassandra:Modify`
+ 操作：`cassandra:ModifyMultiRegionResource`
+ 操作：`cassandra:AlterMultiRegionResource`
+ 操作：`application-autoscaling:RegisterScalableTarget`— Amazon Keyspaces 在启用自动扩展的预配置模式下向单个区域表添加副本时，将使用应用程序的自动扩展权限。
+ 操作：`application-autoscaling:DeregisterScalableTarget`
+ 操作：`application-autoscaling:DescribeScalableTargets`
+ 操作：`application-autoscaling:PutScalingPolicy`
+ 操作：`application-autoscaling:DescribeScalingPolicies`
+ 操作：`cassandra:Alter`
+ 操作：`cloudwatch:DeleteAlarms`
+ 操作：`cloudwatch:DescribeAlarms`
+ 操作：`cloudwatch:PutMetricAlarm`

尽管 Amazon Keyspaces 服务相关角色 AWSServiceRoleForAmazonKeyspacesReplication 为策略中指定的亚马逊资源名称 (ARN) “arn: \$1” 提供了权限：“操作：”，但亚马逊密钥空间会提供您账户的 ARN。

创建服务相关角色的权限包含 AWSServiceRoleForAmazonKeyspacesReplication 在`AmazonKeyspacesFullAccess`托管策略中。有关更多信息，请参阅 [AWS 托管策略： AmazonKeyspacesFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonKeyspacesFullAccess)。

您必须配置使用户、组或角色能够创建、编辑或删除服务相关角色的权限。有关更多信息，请参阅*《IAM 用户指南》*中的[服务相关角色权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。

## 为 Amazon Keyspaces 创建服务相关角色
<a name="create-service-linked-role-multi-region-replication"></a>

您不能手动创建服务相关角色。当您在、或 AWS API 中创建多区域密钥空间时 AWS 管理控制台，Amazon Keyspaces 会为您创建服务相关角色。 AWS CLI

如果您删除该服务关联角色，然后需要再次创建，您可以使用相同流程在账户中重新创建此角色。当您创建多区域键空间时，Amazon Keyspaces 将再次为您创建服务相关角色。

## 为 Amazon Keyspaces 编辑服务相关角色
<a name="edit-service-linked-role-multi-region-replication"></a>

Amazon Keyspaces 不允许您编辑 AWSServiceRoleForAmazonKeyspacesReplication 服务相关角色。创建服务关联角色后，您将无法更改角色的名称，因为可能有多种实体引用该角色。但是可以使用 IAM 编辑角色描述。有关更多信息，请参阅《IAM 用户指南》**中的[编辑服务关联角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。

## 删除适用于 Amazon Keyspaces 的服务相关角色
<a name="delete-service-linked-role-multi-region-replication"></a>

如果不再需要使用某个需要服务关联角色的功能或服务，我们建议您删除该角色。这样就没有未被主动监控或维护的未使用实体。但是，必须先删除账户中的所有多区域密钥空间， AWS 区域 然后才能手动删除服务相关角色。

### 清除服务相关角色
<a name="service-linked-role-review-before-delete-multi-region-replication"></a>

必须先删除服务相关角色使用的多区域键空间和表，然后才能使用 IAM 删除该角色。

**注意**  
如果在您试图删除资源时，Amazon Keyspaces 服务正在使用该角色，则删除操作可能会失败。如果发生这种情况，请等待几分钟后重试。

**删除 AWSServiceRoleForAmazonKeyspacesReplication （控制台）使用的 Amazon Keyspaces 资源**

1. [登录并在家中打开 Amazon Keyspaces 控制台。 AWS 管理控制台 https://console.aws.amazon.com/keyspaces/](https://console.aws.amazon.com/keyspaces/home)

1. 从左侧面板中选择 **Keyspaces**。

1. 从列表中选择所有多区域键空间。

1. 选择**删除**确认删除操作，然后选择**删除键空间**。

您也可以使用以下任何一种方法以编程方式删除多区域键空间。
+ Cassandra 查询语言 (CQL) [DROP KEYSPACE](cql.ddl.keyspace.md#cql.ddl.keyspace.drop) 语句。
+ C [LI 的删除密钥空间](https://docs.aws.amazon.com/cli/latest/reference/keyspaces/delete-keyspace.html)操作。 AWS 
+ Amazon Keyspaces API 的[DeleteKeyspace](https://docs.aws.amazon.com/keyspaces/latest/APIReference/API_DeleteKeyspace.html)操作。

### 手动删除服务相关角色
<a name="slr-manual-delete-multi-region-replication"></a>

使用 IAM 控制台 AWS CLI、或 AWS API 删除 AWSServiceRoleForAmazonKeyspacesReplication服务相关角色。有关更多信息，请参阅《IAM 用户指南》**中的[删除服务关联角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)。

## Amazon Keyspaces 服务相关角色支持的区域
<a name="slr-regions-multi-region-replication"></a>

Amazon Keyspaces 并非在提供该服务的每个区域中都支持使用服务相关角色。您可以在以下区域使用该 AWSServiceRoleForAmazonKeyspacesReplication 角色。


****  

|  区域名称 | 区域标识 | Amazon Keyspaces 支持 | 
| --- | --- | --- | 
| 美国东部（弗吉尼亚州北部） | us-east-1 | 是 | 
| 美国东部（俄亥俄州） | us-east-2 | 是 | 
| 美国西部（北加利福尼亚） | us-west-1 | 是 | 
| 美国西部（俄勒冈州） | us-west-2 | 是 | 
| 亚太地区（孟买） | ap-south-1 | 是 | 
| 亚太地区（大阪） | ap-northeast-3 | 是 | 
| 亚太地区（首尔） | ap-northeast-2 | 是 | 
| 亚太地区（新加坡） | ap-southeast-1 | 是 | 
| 亚太地区（悉尼） | ap-southeast-2 | 是 | 
| 亚太地区（东京） | ap-northeast-1 | 是 | 
| 加拿大（中部） | ca-central-1 | 是 | 
| 欧洲地区（法兰克福） | eu-central-1 | 是 | 
| 欧洲地区（爱尔兰） | eu-west-1 | 是 | 
| 欧洲地区（伦敦） | eu-west-2 | 是 | 
| 欧洲地区（巴黎） | eu-west-3 | 是 | 
| 非洲（开普敦） | af-south-1 | 是 | 
| 南美洲（圣保罗） | sa-east-1 | 是 | 
| AWS GovCloud （美国东部） | us-gov-east-1 | 否 | 
| AWS GovCloud （美国西部） | us-gov-west-1 | 否 | 

# 在 Amazon Keyspaces CDC 直播中使用角色
<a name="using-service-linked-roles-CDC-streams"></a>

[Amazon Keyspaces（适用于 Apache Cassandra）使用 AWS Identity and Access Management (IAM) 服务相关角色。](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)服务相关角色是一种独特类型的 IAM 角色，它与 Amazon Keyspaces 直接相关。服务相关角色由 Amazon Keyspaces 预定义，包括该服务代表您调用 AWS 其他服务所需的所有权限。

服务相关角色可让您更轻松地设置 Amazon Keyspaces，因为您不必手动添加必要的权限。Amazon Keyspaces 定义其服务相关角色的权限，除非另外定义，否则只有 Amazon Keyspaces 可以代入该角色。定义的权限包括信任策略和权限策略，而且权限策略不能附加到任何其它 IAM 实体。

您无法删除服务相关角色。

## Amazon Keyspaces 的服务相关角色权限
<a name="service-linked-role-permissions-CDC-streams"></a>

Amazon Keyspaces 使用名为 **AWSServiceRoleForAmazonKeyspacesCDC** 的服务相关角色来允许 Amazon Keyspaces CDC 直播代表您向您的 CloudWatch 账户发布指标。

 AWSServiceRoleForAmazonKeyspacesCDC 服务相关角色信任以下服务来代替该角色：
+ `cassandra-streams.amazonaws.com`

名为 [Keyspaces 的角色权限策略允许 CDCService RolePolicy](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/KeyspacesCDCServiceRolePolicy.html) Amazon Keyspaces 对命名空间中的资源完成以下操作： CloudWatch `AWS/Cassandra`
+ 操作：`*` 上的 `cloudwatch:PutMetricData`

   AWSServiceRoleForAmazonKeyspacesCDC对符合以下条件的所有资源提供权限:操作:PutMetricData cloudwatch:`"cloudwatch:namespace": "AWS/Cassandra"`.

有关 Keyspaces 的更多信息 CDCServiceRolePolicy，请参阅。[AWS 托管策略：Keyspaces CDCService RolePolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-KeyspacesCDCServiceRolePolicy)

要为自动创建服务相关角色 CDC 的表启用 AWSService RoleForAmazonKeyspaces CDC 流，IAM 委托人需要以下权限。

```
{
    "Sid": "KeyspacesCDCServiceLinkedRole",
    "Effect": "Allow",
    "Action": "iam:CreateServiceLinkedRole",
    "Resource": "arn:aws:iam::*:role/aws-service-role/cassandra-streams.amazonaws.com/AWSServiceRoleForAmazonKeyspacesCDC",
    "Condition": {
    "StringLike": {
        "iam:AWSServiceName": "cassandra-streams.amazonaws.com"
    }
}
```

创建服务相关角色 AWSService RoleForAmazonKeyspaces CDC 的权限包含在`AmazonKeyspacesFullAccess`托管策略中。有关更多信息，请参阅 [AWS 托管策略： AmazonKeyspacesFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonKeyspacesFullAccess)。

## 为 Amazon Keyspaces 创建服务相关角色
<a name="create-service-linked-role-CDC-streams"></a>

您无需为 Amazon Keyspaces CDC 直播手动创建服务相关角色。当您使用 AWS 管理控制台、CQL、或 API 在表上启用 Amazon Keyspaces CDC 流时 AWS ，Amazon Keyspaces 会为您创建服务相关角色。 AWS CLI

如果您删除该服务关联角色，然后需要再次创建，您可以使用相同流程在账户中重新创建此角色。当您为表启用 Amazon Keyspaces CDC 流时，Amazon Keyspaces 会再次为您创建与服务相关的角色。

## 为 Amazon Keyspaces 编辑服务相关角色
<a name="edit-service-linked-role-CDC-streams"></a>

Amazon Keyspaces 不允许您编辑 AWSService RoleForAmazonKeyspaces CDC 服务相关角色。创建服务关联角色后，您将无法更改角色的名称，因为可能有多种实体引用该角色。但是可以使用 IAM 编辑角色描述。有关更多信息，请参阅《IAM 用户指南》**中的[编辑服务关联角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。

## Amazon Keyspaces 服务相关角色支持的区域
<a name="slr-regions-CDC-streams"></a>

Amazon Keyspaces 支持在该服务可用的所有区域中使用服务相关角色。有关更多信息，请参阅 [AWS 区域和端点](https://docs.aws.amazon.com/general/latest/gr/rande.html)。