Como o Amazon Keyspaces funciona com o IAM

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

Políticas baseadas em identidade do Amazon Keyspaces

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

Para ver os recursos e as ações específicas do serviço Amazon Keyspaces e as chaves de contexto condicionais que podem ser usadas para políticas de permissões do IAM, consulte as Ações, recursos e chaves de condição do Amazon Keyspaces (para Apache Cassandra) na Referência de autorização de serviço.

Ações

Os administradores podem usar políticas AWS JSON 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 Action de uma política JSON 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 operação de AWS API associada. Existem algumas exceções, como ações somente de permissão, que não têm uma operação de API correspondente. 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 Keyspaces usam o seguinte prefixo antes da ação: cassandra:. Por exemplo, para conceder a uma pessoa permissão para criar um espaço de chaves do Amazon Keyspaces com a instrução CREATE CQL do Amazon Keyspaces, inclua a ação cassandra:Create na política. As instruções de política devem incluir um elemento Action ou NotAction. O Amazon Keyspaces 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": [
      "cassandra:CREATE",
      "cassandra:MODIFY"
          ]

Para ver uma lista de ações do Amazon Keyspaces, consulte Ações definidas pelo Amazon Keyspaces (para Apache Cassandra) na Referência de autorização do serviço.

Recursos

Os administradores podem usar políticas AWS JSON 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 de política JSON Resource especifica o objeto ou os 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 nome do recurso da Amazon (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": "*"

No Amazon Keyspaces, os espaços de chaves e as tabelas podem ser usados no elemento Resource de permissões do IAM.

O recurso de espaço de chaves do Amazon Keyspaces tem o seguinte ARN:

arn:${Partition}:cassandra:${Region}:${Account}:/keyspace/${KeyspaceName}/

O recurso de tabela do Amazon Keyspaces tem o seguinte ARN:

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

Para obter mais informações sobre o formato dos ARNs, consulte Amazon Resource Names (ARNs) e namespaces AWS de serviços.

Por exemplo, para especificar o espaço de chaves mykeyspace em sua instrução, use o seguinte ARN:

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

Para especificar todos os espaços de chaves que pertencem a uma conta específica, use o curinga (*):

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

Algumas ações do Amazon Keyspaces, 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 se conectar programaticamente ao Amazon Keyspaces com um driver padrão, a entidade principal deve ter acesso SELECT às tabelas do sistema, pois a maioria dos drivers lê os espaços de chaves/tabelas do sistema na conexão. Por exemplo, para conceder permissões SELECT a um usuário do IAM para mytable em mykeyspace, a entidade principal deve ter permissões para ler ambos, mytable e system keyspace. Para especificar vários recursos em uma única instrução, separe os ARNs com vírgulas.

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

Para ver uma lista de tipos de recursos do Amazon Keyspaces e seus ARNs, consulte Recursos definidos pelo Amazon Keyspaces (para Apache Cassandra) na Referência de autorização do serviço. Para saber com quais ações você pode especificar o ARN de cada recurso, consulte Ações definidas pelo Amazon Keyspaces (para Apache Cassandra).

Chaves de condição

Os administradores podem usar políticas AWS JSON 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, é possível conceder a um usuário do IAM permissão para acessar um atributo somente se ele estiver marcado com seu nome de usuário do IAM. Para obter mais informações, consulte Elementos da política do IAM: variáveis e tags no Guia do usuário do IAM.

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 do usuário do IAM.

O Amazon Keyspaces define seu próprio conjunto de chaves de condição e também oferece suporte ao uso de algumas chaves de condição globais. Para ver todas as chaves de condição AWS globais, consulte as chaves de contexto de condição AWS global no Guia do usuário do IAM.

Todas as ações do Amazon Keyspaces oferecem suporte às chaves de condição aws:RequestTag/${TagKey}, aws:ResourceTag/${TagKey} e aws:TagKeys. Para ter mais informações, consulte Acesso a recursos do Amazon Keyspaces com base em tags.

Para ver uma lista de chaves de condição do Amazon Keyspaces, consulte Chaves de condição do Amazon Keyspaces (para Apache Cassandra) na Referência de autorização do serviço. Para saber com quais ações e recursos você pode usar uma chave de condição, consulte Ações definidas pelo Amazon Keyspaces (para Apache Cassandra).

Exemplos

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

Políticas baseadas em recursos do Amazon Keyspaces

O Amazon Keyspaces não oferece suporte a políticas baseadas em recursos. Para visualizar um exemplo de uma política baseada em recurso detalhada, consulte https://docs.aws.amazon.com/lambda/latest/dg/access-control-resource-based.html.

Autorização baseada em tags do Amazon Keyspaces

Você pode gerenciar o acesso a seus recursos do Amazon Keyspaces usando tags. Para gerenciar o acesso a recursos 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 cassandra:ResourceTag/key-name, aws:RequestTag/key-name ou aws:TagKeys. Para obter mais informações sobre recursos de marcação do Amazon Keyspaces, consulte Trabalhando com tags e rótulos para recursos do Amazon Keyspaces.

Para visualizar exemplos de políticas baseadas em identidade para limitar o acesso a um recurso baseado em tags desse recurso, consulte Acesso a recursos do Amazon Keyspaces com base em tags.

Perfis do IAM no Amazon Keyspaces

Uma função do IAM é uma entidade dentro da sua Conta da AWS que tem permissões específicas.

Uso de credenciais temporárias com o Amazon Keyspaces

É possível usar credenciais temporárias para fazer login com federação, assumir uma função do IAM ou assumir uma função entre contas. Você obtém credenciais de segurança temporárias chamando operações de AWS STS API, como AssumeRoleou GetFederationToken.

O Amazon Keyspaces oferece suporte ao uso de credenciais temporárias com o plug-in de autenticação AWS Signature Version 4 (SigV4) disponível no repositório Github para os seguintes idiomas:

• Java: https://github.com/aws/aws-sigv4-auth-cassandra-java-driver-plugin.

• Node.js: https://github.com/aws/aws-sigv4-auth-cassandra-nodejs-driver-plugin.

• Python: https://github.com/aws/aws-sigv4-auth-cassandra-python-driver-plugin.

• Go: https://github.com/aws/aws-sigv4-auth-cassandra-gocql-driver-plugin.

Para exemplos e tutoriais que implementam o plug-in de autenticação para acessar o Amazon Keyspaces programaticamente, consulte. Como usar um driver de cliente Cassandra para acessar o Amazon Keyspaces programaticamente

Funções vinculadas a serviço

As funções vinculadas ao serviço permitem que AWS os serviços acessem recursos em outros serviços para concluir uma ação em seu nome. Os perfis vinculados a serviço aparecem em sua conta do IAM e são de propriedade do serviço. Um administrador do IAM pode visualizar, mas não pode editar as permissões para perfis vinculados a serviço.

Para obter detalhes sobre como criar ou gerenciar perfis vinculados ao serviço do Amazon Keyspaces, consulte Uso de perfis vinculados ao serviço para o Amazon Keyspaces.

Perfis de serviço

O Amazon Keyspaces não é compatível com perfis de serviço.