As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como a Amazon Kendra trabalha com IAM

Antes de usar IAM para gerenciar o acesso ao Amazon Kendra, você deve entender IAM quais recursos estão disponíveis para uso com o Amazon Kendra. Para ter uma visão de alto nível de como o Amazon Kendra AWS e outros serviços IAM funcionam com AWS , consulte Serviços que IAM funcionam com IAM no Guia do usuário.

Políticas baseadas em identidade do Amazon Kendra

Com políticas IAM baseadas em identidade, você pode especificar ações e recursos permitidos ou negados, bem como as condições sob as quais as ações são permitidas ou negadas. O Amazon Kendra oferece suporte a ações, chaves de condição e recursos específicos. Para saber mais sobre todos os elementos que você usa em uma JSON política, consulte Referência IAM JSON de elementos de política no Guia do IAM usuário.

Ações

Os administradores podem usar AWS JSON políticas para especificar quem tem acesso ao quê. Ou seja, qual entidade principal pode executar ações em quais recursos, e em que condições.

O Action elemento de uma JSON política descreve as ações que você pode usar para permitir ou negar acesso em uma política. As ações de política geralmente têm o mesmo nome da AWS API operação associada. Há algumas exceções, como ações somente de permissão que não têm uma operação correspondente. API Algumas operações também exigem várias ações em uma política. Essas ações adicionais são chamadas de ações dependentes.

Incluem ações em uma política para conceder permissões para executar a operação associada.

As ações de política no Amazon Kendra usam o seguinte prefixo antes da ação: kendra:. Por exemplo, para conceder permissão a alguém para listar índices do Amazon Kendra com a operação, você inclui ListIndicesAPIa ação kendra:ListIndices na política dessa pessoa. As instruções de política devem incluir um elemento Action ou NotAction. O Amazon Kendra define seu próprio conjunto de ações que descrevem as tarefas que você pode executar com esse serviço.

Para especificar várias ações em uma única instrução, separe-as com vírgulas, como segue:

"Action": [
      "kendra:action1",
      "kendra:action2"

Você também pode especificar várias ações usando caracteres curinga (*). Por exemplo, para especificar todas as ações que começam com a palavra Describe, inclua a seguinte ação:

"Action": "kendra:Describe*"

Para ver uma lista das ações do Amazon Kendra, consulte Ações definidas pelo Amazon Kendra no Guia do usuário. IAM

Recursos

Os administradores podem usar AWS JSON políticas para especificar quem tem acesso ao quê. Ou seja, qual entidade principal pode executar ações em quais recursos, e em que condições.

O elemento Resource JSON de política especifica o objeto ou objetos aos quais a ação se aplica. As instruções devem incluir um elemento Resource ou NotResource. Como prática recomendada, especifique um recurso usando seu Amazon Resource Name (ARN). Isso pode ser feito para ações que oferecem compatibilidade com um tipo de recurso específico, conhecido como permissões em nível de recurso.

Para ações que não oferecem compatibilidade com permissões em nível de recurso, como operações de listagem, use um curinga (*) para indicar que a instrução se aplica a todos os recursos.

"Resource": "*"

O recurso de índice Amazon Kendra tem o seguinte: ARN

arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}

Para obter mais informações sobre o formato deARNs, consulte Amazon Resource Names (ARNs) e AWS Service Namespaces.

Por exemplo, para especificar um índice em sua declaração, use o GUID do índice da seguinte formaARN:

"Resource": "arn:aws:kendra:${Region}:${Account}:index/${GUID}"

Para especificar todas os índices que pertencem a uma conta específica, use o caractere curinga (*):

"Resource": "arn:aws:${Region}:${Account}:index/*"

Algumas ações do Amazon Kendra, como as de criação de recursos, não podem ser executadas em um recurso específico. Nesses casos, você deve utilizar o caractere curinga (*).

"Resource": "*"

Para ver uma lista dos tipos de recursos do Amazon Kendra e ARNs seus, consulte Recursos definidos pelo Amazon Kendra no Guia do usuário. IAM Para saber com quais ações você pode especificar cada recurso, consulte Ações definidas pela Amazon Kendra. ARN

Chaves de condição

Os administradores podem usar AWS JSON políticas para especificar quem tem acesso ao quê. Ou seja, qual entidade principal pode executar ações em quais recursos, e em que condições.

O elemento Condition (ou bloco Condition) permite que você especifique condições nas quais uma instrução estiver em vigor. O elemento Condition é opcional. É possível criar expressões condicionais que usem agentes de condição, como “igual a” ou “menor que”, para fazer a condição da política corresponder aos valores na solicitação.

Se você especificar vários elementos Condition em uma instrução ou várias chaves em um único Condition elemento, a AWS os avaliará usando uma operação lógica AND. Se você especificar vários valores para uma única chave de condição, AWS avalia a condição usando uma OR operação lógica. Todas as condições devem ser atendidas antes que as permissões da instrução sejam concedidas.

Você também pode usar variáveis de espaço reservado ao especificar condições. Por exemplo, você pode conceder permissão a um IAM usuário para acessar um recurso somente se ele estiver marcado com o nome de IAM usuário. Para obter mais informações, consulte elementos de IAM política: variáveis e tags no Guia IAM do usuário.

AWS suporta chaves de condição globais e chaves de condição específicas do serviço. Para ver todas as chaves de condição AWS globais, consulte as chaves de contexto de condição AWS global no Guia IAM do usuário.

O Amazon Kendra não fornece nenhuma chave de condição específica ao serviço, mas oferece suporte ao uso de algumas chaves de condição globais. Para ver todas as chaves de condição AWS globais, consulte Chaves de contexto de condição AWS global no Guia IAM do usuário.

Exemplos

Para visualizar exemplos de políticas baseadas em identidade do Amazon Kendra, consulte Exemplos de políticas baseadas em identidade do Amazon Kendra.

Políticas baseadas em recursos do Amazon Kendra

O Amazon Kendra não oferece suporte a políticas baseadas em recursos.

Listas de controle de acesso (ACLs)

O Amazon Kendra não oferece suporte a listas de controle de acesso ACLs () para acesso AWS a serviços e recursos.

Autorização baseada em tags do Amazon Kendra

Você pode associar tags a determinados tipos de recursos do Amazon Kendra para autorizar o acesso a esses recursos. Para controlar o acesso baseado em tags, forneça informações sobre as tags no elemento de condição de uma política usando as chaves de condição aws:RequestTag/key-name ou aws:TagKeys.

A tabela a seguir lista as ações e os tipos de recursos correspondentes para o controle de acesso baseado em tags. Cada ação é autorizada com base nas tags associadas ao tipo de recurso correspondente.

Para ter mais informações sobre recursos de marcação do Amazon Kendra, consulte Tags. Para obter um exemplo de política baseada em identidade que limita o acesso a um recurso com base em tags de recurso, consulte Exemplos de política baseada na tag do. Para obter mais informações sobre o uso de tags para limitar o acesso aos recursos, consulte Controlar o acesso usando tags no Guia IAM do usuário.

Funções do Amazon Kendra IAM

Uma IAMfunção é uma entidade dentro da sua AWS conta que tem permissões específicas.

Usar credenciais temporárias com o Amazon Kendra

Você pode usar credenciais temporárias para entrar com a federação, assumir uma IAM função ou assumir uma função entre contas. Você obtém credenciais de segurança temporárias ligando para AWS STS API operações como AssumeRoleou GetFederationToken.

O Amazon Kendra oferece suporte ao uso de credenciais temporárias.

Perfis de serviço

Esse atributo permite que um serviço assuma um perfil de serviço em seu nome. O perfil permite que o serviço acesse recursos em outros serviços para concluir uma ação em seu nome. As funções de serviço aparecem na sua IAM conta e são de propriedade da conta. Isso significa que um IAM administrador pode alterar as permissões para essa função. Porém, fazer isso pode alterar a funcionalidade do serviço.

O Amazon Kendra oferece suporte às funções de serviço.

Escolhendo uma IAM função na Amazon Kendra

Ao criar um índice, chamar a BatchPutDocument operação, criar uma fonte de dados ou criar umaFAQ, você deve fornecer uma função de acesso Amazon Resource Name (ARN) que o Amazon Kendra usa para acessar os recursos necessários em seu nome. Se você já tiver criado uma função, o Amazon Kendra fornecerá uma lista de funções da qual escolher. É importante escolher uma função que permita o acesso aos recursos necessários. Para obter mais informações, consulte IAM funções de acesso para Amazon Kendra.