本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
亚马逊 Kendra 是如何与之合作的 IAM
在使用管理IAM对亚马逊 Kendra 的访问权限之前,您应该了解亚马逊 Kendra 有哪些IAM功能可供使用。要全面了解 Amazon Kendra 和其他 AWS 服务的使用方式IAM,请参阅《IAM用户指南》IAM中的 “与之配合使用的AWS 服务”。
Amazon Kendra 基于身份的策略
使用IAM基于身份的策略,您可以指定允许或拒绝的操作和资源,以及允许或拒绝操作的条件。Amazon Kendra 支持特定的操作、资源和条件键。要了解您在JSON策略中使用的所有元素,请参阅IAM用户指南中的IAMJSON策略元素参考。
操作
管理员可以使用 AWS JSON策略来指定谁有权访问什么。也就是说,哪个主体 可以对什么资源执行操作,以及在什么条件下执行。
JSON策略Action
元素描述了可用于在策略中允许或拒绝访问的操作。策略操作通常与关联的 AWS API操作同名。也有一些例外,例如没有匹配API操作的仅限权限的操作。还有一些操作需要在策略中执行多个操作。这些附加操作称为相关操作。
在策略中包含操作以授予执行关联操作的权限。
Amazon Kendra 中的策略操作在操作前面使用以下前缀:kendra:
。例如,要授予某人通过该操作列出 Amazon Kendra 索引的权限,您需要将该ListIndicesAPIkendra:ListIndices
操作包含在他们的策略中。策略语句必须包含 Action
或 NotAction
元素。Amazon Kendra 定义了一组自己的操作,以描述您可以使用该服务执行的任务。
要在单个语句中指定多项操作,请使用逗号将它们隔开,如下所示:
"Action": [ "kendra:action1", "kendra:action2"
您也可以使用通配符 (*) 指定多个操作。例如,要指定以单词 Describe
开头的所有操作,包括以下操作:
"Action": "kendra:Describe*"
要查看 Amazon Kendra 操作列表,请参阅用户指南中的IAM亚马逊 Kendra 定义的操作。
资源
管理员可以使用 AWS JSON策略来指定谁有权访问什么。也就是说,哪个主体 可以对什么资源执行操作,以及在什么条件下执行。
Resource
JSON策略元素指定要应用操作的一个或多个对象。语句必须包含 Resource
或 NotResource
元素。最佳做法是使用资源的 Amazon 资源名称 (ARN) 来指定资源。对于支持特定资源类型(称为资源级权限)的操作,您可以执行此操作。
对于不支持资源级权限的操作(如列出操作),请使用通配符 (*) 指示语句应用于所有资源。
"Resource": "*"
Amazon Kendra 索引资源包含以下内容:ARN
arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}
有关格式的更多信息ARNs,请参阅 Amazon 资源名称 (ARNs) 和 AWS 服务命名空间。
例如,要在语句中指定索引,请使用以下GUID索引中的ARN:
"Resource": "arn:aws:kendra:${Region}:${Account}:index/${GUID}"
要指定属于特定账户的所有索引,请使用通配符(*):
"Resource": "arn:aws:${Region}:${Account}:index/*"
无法对特定资源执行某些 Amazon Kendra 操作,例如,用于创建资源的操作。在这些情况下,您必须使用通配符 (*)。
"Resource": "*"
要查看 Amazon Kendra 资源类型及其列表ARNs,请参阅用户指南中的 IAMAmazon Kendra 定义的资源。要了解您可以为每种资源指定哪些操作,请参阅 Amazon Kendra 定义的操作。ARN
条件键
管理员可以使用 AWS JSON策略来指定谁有权访问什么。也就是说,哪个主体可以对什么资源执行操作,以及在什么条件下执行。
在 Condition
元素(或 Condition
块)中,可以指定语句生效的条件。Condition
元素是可选的。您可以创建使用条件运算符(例如,等于或小于)的条件表达式,以使策略中的条件与请求中的值相匹配。
如果您在一个语句中指定多个 Condition
元素,或在单个 Condition
元素中指定多个键,则 AWS 使用逻辑 AND
运算评估它们。如果您为单个条件键指定多个值,则使用逻辑OR
运算来 AWS 评估条件。在授予语句的权限之前必须满足所有的条件。
在指定条件时,您也可以使用占位符变量。例如,只有在资源上标有IAM用户的用户名时,您才能向IAM用户授予访问该资源的权限。有关更多信息,请参阅《IAM用户指南》中的IAM策略元素:变量和标签。
AWS 支持全局条件密钥和特定于服务的条件密钥。要查看所有 AWS 全局条件键,请参阅《IAM用户指南》中的AWS 全局条件上下文密钥。
Amazon Kendra 不提供任何特定于服务的条件键,但支持使用某些全局条件键。要查看所有 AWS 全局条件键,请参阅《IAM用户指南》中的AWS 全局条件上下文密钥。
示例
要查看 Amazon Kendra 基于身份的策略的示例,请参阅Amazon Kendra 基于身份的策略示例。
Amazon Kendra 基于资源的策略
Amazon Kendra 不支持基于资源的策略。
访问控制列表 (ACLs)
Amazon Kendra 不支持访问 AWS 服务和资源的访问控制列表 (ACLs)。
基于 Amazon Kendra 标签的授权
您可以将标签与某些类型的 Amazon Kendra 资源关联以授权访问这些资源。要基于标签控制访问,请使用 aws:RequestTag/
或 key-name
aws:TagKeys
条件键在策略的条件元素中提供标签信息。
下表列出了基于标签的访问控制的操作、相应的资源类型和条件键。根据与相应资源类型关联的标签对每个操作进行授权。
操作 | 资源类型 | 条件键 |
---|---|---|
CreateDataSource | aws:RequestTag , aws:TagKeys |
|
CreateFaq | aws:RequestTag , aws:TagKeys |
|
CreateIndex | aws:RequestTag , aws:TagKeys |
|
API_ListTagsForResource | 数据源、FAQ、索引 | |
TagResource | 数据源、FAQ、索引 | aws:RequestTag , aws:TagKeys |
UntagResource | 数据源、FAQ、索引 | aws:TagKeys |
有关标记 Amazon Kendra 资源的信息,请参阅标签。有关基于资源标签限制对资源的访问的基于身份的策略示例,请参阅基于标签的策略示例。有关使用标签限制资源访问权限的更多信息,请参阅IAM用户指南中的使用标签控制访问权限。
亚马逊 Kendra 角色 IAM
IAM角色是您的 AWS 账户中具有特定权限的实体。
将临时凭证用于 Amazon Kendra
您可以使用临时证书通过联合身份登录、代入IAM角色或担任跨账户角色。您可以通过调用AssumeRole或之类的 AWS STS API操作来获取临时安全证书GetFederationToken。
Amazon Kendra 支持使用临时凭证。
服务角色
此功能允许服务代表您担任服务角色。此角色允许服务访问其他服务中的资源以代表您完成操作。服务角色显示在您的IAM账户中,并归该账户所有。这意味着IAM管理员可以更改此角色的权限。但是,这样做可能会中断服务的功能。
Amazon Kendra 支持服务角色。
在 Amazon Kendra 中选择IAM角色
在创建索引、调用BatchPutDocument
操作、创建数据源或创建索引时FAQ,必须提供访问角色亚马逊资源名称 (ARN),Amazon Kendra 使用该角色代表您访问所需资源。如果您之前创建了一个角色,Amazon Kendra 控制台会为您提供一个角色列表供您选择。选择允许访问所需资源的角色非常重要。有关更多信息,请参阅 IAM 的访问角色 Amazon Kendra。