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á.
Controlar o acesso aos recursos do Amazon Kinesis Data Streams usando o IAM
AWS Identity and Access Management (IAM) permite que você faça o seguinte:
-
Crie usuários e grupos em sua AWS conta
-
Atribua credenciais de segurança exclusivas a cada usuário em sua conta AWS
-
Controle as permissões de cada usuário para realizar tarefas usando AWS recursos
-
Permita que os usuários de outra AWS conta compartilhem seus AWS recursos
-
Crie funções para sua AWS conta e defina os usuários ou serviços que podem assumi-las
-
Use identidades existentes para sua empresa para conceder permissões para realizar tarefas usando recursos AWS
Ao usar o IAM com o Kinesis Data Streams, você pode controlar se os usuários de sua organização podem executar uma tarefa usando ações específicas da API do Kinesis Data Streams e se podem usar recursos específicos da AWS .
Se você estiver desenvolvendo um aplicativo usando a Kinesis Client Library (KCL), sua política deve incluir permissões para o Amazon DynamoDB e a Amazon; CloudWatch o KCL usa o DynamoDB para rastrear informações de estado do aplicativo e enviar métricas de KCL para você. CloudWatch CloudWatch Para obter mais informações sobre o recurso KCL, consulte Desenvolver consumidores do KCL 1.x.
Para obter mais informações sobre IAM, consulte o seguinte:
Para obter mais informações sobre o IAM e o DynamoDB, consulte Usar o IAM para controlar o acesso a recursos do Amazon DynamoDB no Guia do desenvolvedor do Amazon DynamoDB.
Para obter mais informações sobre o IAM e a Amazon CloudWatch, consulte Controlando o acesso do usuário à sua AWS conta no Guia CloudWatch do usuário da Amazon.
Conteúdo
- Sintaxe da política
- Ações para o Kinesis Data Streams
- Nomes de recursos da Amazon (ARNs) para o Kinesis Data Streams
- Exemplo de políticas para o Kinesis Data Streams
- Compartilhamento do fluxo de dados com outra conta
- Configurar uma AWS Lambda função para ler do Kinesis Data Streams em outra conta
- Compartilhamento de acesso usando políticas baseadas em recursos
Sintaxe da política
A política do IAM é um documento JSON que consiste em uma ou mais declarações. Cada instrução é estruturada da seguinte maneira:
{
"Statement":[{
"Effect":"effect",
"Action":"action",
"Resource":"arn",
"Condition":{
"condition":{
"key":"value"
}
}
}
]
}Existem vários elementos que compõem uma instrução:
-
Effect: o efeito pode ser
AllowouDeny. Por padrão, os usuários do IAM não têm permissão para usar recursos e ações da API. Por isso, todas as solicitações são negadas. Uma permissão explícita substitui o padrão. Uma negação explícita substitui todas as permissões. -
Ação: é a ação de API específica para a qual você está concedendo ou negando permissão.
-
Recurso: o recurso afetado pela ação. Para especificar um recurso na declaração, você precisa usar o nome do recurso da Amazon (ARN).
-
Condição: condições são opcionais. Elas podem ser usadas para controlar quando as políticas entrarão em vigor.
Ao criar e gerenciar políticas do IAM, você pode querer usar o gerador de políticas do IAM e o simulador de políticas do IAM.
Ações para o Kinesis Data Streams
Em uma declaração de política do IAM, é possível especificar qualquer ação de API de qualquer serviço que dê suporte ao IAM. Para o Kinesis Data Streams, use o seguinte prefixo com o nome da ação da API: kinesis:. Por exemplo: kinesis:CreateStream, kinesis:ListStreams e kinesis:DescribeStreamSummary.
Para especificar várias ações em uma única instrução, separe-as com vírgulas, como segue:
"Action": ["kinesis:action1", "kinesis:action2"]Também é possível especificar várias ações usando asteriscos. Por exemplo, você pode especificar todas as ações cujo nome começa com a palavra "Obter", conforme o seguinte:
"Action": "kinesis:Get*"Para especificar todas as operações do Kinesis Data Streams, use o curinga *, como a seguir:
"Action": "kinesis:*"Para obter a lista completa das ações da API do Kinesis Data Streams, consulte a Referência de API do Amazon Kinesis.
Nomes de recursos da Amazon (ARNs) para o Kinesis Data Streams
Cada declaração de política do IAM se aplica aos recursos que você especifica usando os ARNs.
Use o seguinte formato de recursos do ARN para os fluxos de dados do Kinesis:
arn:aws:kinesis:region:account-id:stream/stream-namePor exemplo: .
"Resource": arn:aws:kinesis:*:111122223333:stream/my-streamExemplo de políticas para o Kinesis Data Streams
As políticas de exemplo a seguir demonstram como você pode controlar o acesso do usuário aos fluxos de dados do Kinesis.
Compartilhamento do fluxo de dados com outra conta
nota
Atualmente, a Kinesis Producer Library não oferece suporte à especificação de um ARN de stream ao gravar em um stream de dados. Use o AWS SDK se quiser gravar em um stream de dados entre contas.
Anexe uma política baseada em recursos ao fluxo de dados para conceder acesso a outra conta, a um usuário do IAM ou a um perfil do IAM. As políticas baseadas em recursos são documentos de política JSON que você anexa a um recurso, como um fluxo de dados. Essas políticas concedem permissão para a entidade principal especificada executar ações específicas nesse recurso e definem sob quais condições isso se aplica. Uma política pode ter várias declarações. Você deve especificar uma entidade principal em uma política baseada em recursos. Os diretores podem incluir contas, usuários, funções, usuários federados ou AWS serviços. Você pode configurar políticas no console do Kinesis Data Streams, na API ou no SDK.
Observe que compartilhar o acesso a consumidores registrados, como o Enhanced Fan Out, exige uma política tanto no ARN do fluxo de dados quanto no ARN do consumidor.
Ativação do acesso entre contas
Para permitir o acesso entre contas, você pode especificar uma conta inteira ou as entidades do IAM em outra conta como a entidade principal em uma política baseada em atributo. Adicionar uma entidade principal entre contas à política baseada em atributo é apenas metade da tarefa de estabelecimento da relação de confiança. Quando o principal e o recurso estão em AWS contas separadas, você também deve usar uma política baseada em identidade para conceder ao principal acesso ao recurso. No entanto, se uma política baseada em atributo conceder acesso a uma entidade principal na mesma conta, nenhuma política baseada em identidade adicional será necessária.
Para obter mais informações sobre como usar políticas baseadas em recursos para acesso entre contas, consulte Acesso a recursos entre contas no IAM.
Os administradores de fluxo de dados podem usar AWS Identity and Access Management 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 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.
Ações do Kinesis Data Streams que podem ser compartilhadas:
| Ação | Nível de acesso |
|---|---|
| DescribeStreamConsumer | Consumidor |
| DescribeStreamSummary | Fluxo de dados |
| GetRecords | Fluxo de dados |
| GetShardIterator | Fluxo de dados |
| ListShards | Fluxo de dados |
| PutRecord | Fluxo de dados |
| PutRecords | Fluxo de dados |
| SubscribeToShard | Consumidor |
Veja a seguir exemplos do uso de uma política baseada em recursos para conceder acesso entre contas ao fluxo de dados ou ao consumidor registrado.
Para realizar uma ação entre contas, você deve especificar o ARN do fluxo para acesso ao fluxo de dados e o ARN do consumidor para o acesso do consumidor registrado.
Exemplo de políticas baseadas em recursos para fluxos de dados do Kinesis
Compartilhar um consumidor registrado envolve uma política de fluxo de dados e uma política de consumidor devido às ações necessárias.
nota
Veja os seguintes exemplos de valores válidos para Principal:
{"AWS": "123456789012"}Usuário do IAM:
{"AWS": "arn:aws:iam::123456789012:user/user-name"}Perfil do IAM:
{"AWS":["arn:aws:iam::123456789012:role/role-name"]}Várias entidades principais (pode ser uma combinação de contas, usuários, perfis):
{"AWS":["123456789012", "123456789013", "arn:aws:iam::123456789012:user/user-name"]}
Gerenciamento da política do fluxo de dados de forma programática
Além do AWS Management Console, o Kinesis Data Streams tem três APIS para gerenciar sua política de stream de dados:
Use PutResourePolicy para anexar ou substituir uma política de um fluxo de dados ou consumidor. Use GetResourcePolicy para verificar e visualizar uma política do fluxo de dados ou consumidor especificado. Use DeleteResourcePolicy para excluir uma política do fluxo de dados ou consumidor especificado.
Limites de políticas
As políticas de recursos do Kinesis Data Streams têm as restrições a seguir.
-
Não há suporte para curingas (*) para ajudar a impedir que um amplo acesso seja concedido por meio das políticas de recursos diretamente vinculadas a um fluxo de dados ou a um consumidor registrado. Além disso, inspecione cuidadosamente as seguintes políticas para confirmar se elas não concedem amplo acesso:
-
Políticas baseadas em identidade vinculadas aos AWS diretores associados (por exemplo, funções do IAM)
-
Políticas baseadas em recursos anexadas aos AWS recursos associados (por exemplo, chaves AWS Key Management Service KMS)
-
AWS Os diretores de serviço não recebem suporte para diretores para evitar possíveis deputados confusos.
Não há suporte para entidades principais federadas.
Não há suporte para IDs de usuário canônicos.
O tamanho da política não pode exceder 20 kB.
Compartilhamento de acesso a dados criptografados
Se você habilitou a criptografia do lado do servidor para um fluxo de dados com chave KMS AWS gerenciada e deseja compartilhar o acesso por meio de uma política de recursos, deve passar a usar a chave gerenciada pelo cliente (CMK). Para ter mais informações, consulte O que é criptografia no lado do servidor para o Kinesis Data Streams?. Além disso, você deve permitir que suas entidades principais de compartilhamento tenham acesso à sua CMK, usando os recursos de compartilhamento entre contas do KMS. Certifique-se também de fazer a alteração nas políticas do IAM para as entidades principais de compartilhamento. Para ter mais informações, consulte o tópico sobre como Permitir que usuários de outras contas utilizem uma chave do KMS.
Configurar uma AWS Lambda função para ler do Kinesis Data Streams em outra conta
Para ver um exemplo de como configurar uma função do Lambda para ler do Kinesis Data Streams em outra conta, consulte Compartilhamento de acesso com funções entre contas AWS Lambda.
