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 o Amazon Pinpoint funciona com IAM

Para usar o Amazon Pinpoint, os usuários da sua AWS conta precisam de permissões que lhes permitam visualizar dados analíticos, criar projetos, definir segmentos de usuários, implantar campanhas e muito mais. Se você integrar um aplicativo móvel ou web ao Amazon Pinpoint, os usuários do aplicativo também precisarão acessar o Amazon Pinpoint. Esse acesso permite que o aplicativo registre endpoints e relate dados de uso ao Amazon Pinpoint. Para conceder acesso aos recursos do Amazon Pinpoint, crie AWS Identity and Access Management (IAM) políticas que permitam ações do Amazon Pinpoint IAM para identidades ou recursos do Amazon Pinpoint.

IAMé um serviço que ajuda os administradores a controlar com segurança o acesso aos recursos. AWS IAMas políticas incluem declarações que permitem ou negam ações específicas de usuários específicos ou para recursos específicos. O Amazon Pinpoint fornece um conjunto de ações que você pode usar em IAM políticas para especificar permissões granulares para usuários e recursos do Amazon Pinpoint. Isso significa que você pode conceder o nível de acesso apropriado ao Amazon Pinpoint sem criar políticas excessivamente permissivas que possam expor dados importantes ou comprometer os recursos. Por exemplo, você pode conceder acesso irrestrito a um administrador do Amazon Pinpoint e conceder acesso somente leitura a indivíduos que precisam de acesso a apenas um projeto específico.

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

Políticas baseadas em identidade do Amazon Pinpoint

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 Pinpoint é compatível com ações, recursos e chaves de condição. Para saber mais sobre todos os elementos que você pode usar em uma JSON política, consulte a referência IAM JSON de elementos de política no Guia IAM do 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.

Isso significa que as ações de políticas controlam o que os usuários podem fazer no console do Amazon Pinpoint. Eles também controlam o que os usuários podem fazer programaticamente usando o AWS SDKs, o AWS Command Line Interface (AWS CLI) ou o Amazon APIs Pinpoint diretamente.

As ações de políticas no Amazon Pinpoint usam os seguintes prefixos:

Por exemplo, para conceder a alguém permissão para visualizar informações sobre todos os segmentos de um projeto, que é uma ação que corresponde à GetSegments operação no Amazon PinpointAPI, inclua a mobiletargeting:GetSegments ação em sua política. As instruções de política devem incluir um elemento Action ou NotAction. O Amazon Pinpoint define seu próprio conjunto de ações que descrevem as tarefas que os usuários podem executar com isso.

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

"Action": [
      "mobiletargeting:action1",
      "mobiletargeting: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 Get, inclua a seguinte ação:

"Action": "mobiletargeting:Get*"

No entanto, como prática recomendada, você deve criar políticas que sigam o princípio de privilégio mínimo. Em outras palavras, você deve criar políticas que incluem somente as permissões necessárias para executar uma ação específica.

Para obter uma lista das ações do Amazon Pinpoint que você pode usar nas IAM políticas, consulte. Ações do Amazon Pinpoint para políticas 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": "*"

Por exemplo, a ação mobiletargeting:GetSegments recupera informações sobre todos os segmentos que estão associados a um projeto do Amazon Pinpoint específico. Você identifica um projeto com um ARN no seguinte formato:

arn:aws:mobiletargeting:${Region}:${Account}:apps/${projectId}

Para obter mais informações sobre o formato deARNs, consulte Amazon Resource Names (ARNs) no Referência geral da AWS.

Nas IAM políticas, você pode especificar ARNs os seguintes tipos de recursos do Amazon Pinpoint:

Por exemplo, para criar uma declaração de política para o projeto que tenha o ID do projeto810c7aab86d42fb2b56c8c966example, use o seguinteARN:

"Resource": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/810c7aab86d42fb2b56c8c966example"

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

"Resource": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/*"

Algumas ações do Amazon Pinpoint, como determinadas ações para criar recursos, não podem ser realizadas em um recurso específico. Nesses casos, você deve usar o caractere curinga (*):

"Resource": "*"

Nas IAM políticas, você também pode especificar ARNs os seguintes tipos de recursos do Amazon Pinpoint SMS e Voice:

Por exemplo, para criar uma declaração de política para um número de telefone que tenha o ID do número de telefone, phone-12345678901234567890123456789012 use o seguinteARN:

"Resource": "arn:aws:sms-voice:us-east-1:123456789012:phone-number/phone-12345678901234567890123456789012"

Para especificar todos os números de telefone que pertencem a uma conta específica, use um caractere curinga (*) no lugar do ID do número de telefone:

"Resource": "arn:aws:sms-voice:us-east-1:123456789012:phone-number/*"

Algumas ações do Amazon Pinpoint SMS e Voice não são realizadas em um recurso específico, como aquelas para gerenciar configurações no nível da conta, como limites de gastos. Nesses casos, você deve usar o caractere curinga (*):

"Resource": "*"

Algumas API ações do Amazon Pinpoint envolvem vários recursos. Por exemplo, a ação TagResource pode adicionar uma tag a vários projetos. Para especificar vários recursos em uma única instrução, separe-os ARNs com vírgulas:

"Resource": [
      "resource1",
      "resource2"

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

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 Pinpoint define o próprio conjunto de chaves de condição e também oferece suporte para algumas chaves de condição globais. Para ver uma lista de todas as chaves de condição AWS globais, consulte as chaves de contexto de condição AWS global no Guia IAM do usuário. Para ver uma lista das chaves de condição do Amazon Pinpoint, consulte Chaves de condição do Amazon Pinpoint no IAM Guia do usuário. Para saber com quais ações e recursos você pode usar uma chave de condição, consulte Ações definidas pelo Amazon Pinpoint no Guia do IAMusuário.

Exemplos

Para ver exemplos de políticas baseadas em identidade do Amazon Pinpoint, consulte Exemplos de políticas baseadas em identidade do Amazon Pinpoint.

Políticas de permissões baseadas em recursos do Amazon Pinpoint

Políticas de permissão baseadas em recursos são documentos JSON de política que especificam quais ações um determinado diretor pode realizar em um recurso do Amazon Pinpoint e sob quais condições. O Amazon Pinpoint oferece suporte a políticas de permissões baseadas em recursos para campanhas, jornadas, modelos de mensagens (modelos), modelos de recomendação (recomendações), projetos (aplicativos) e segmentos.

Exemplos

Para ver exemplos de políticas baseadas em recursos do Amazon Pinpoint, consulte Exemplos de políticas baseadas em identidade do Amazon Pinpoint.

Autorização baseada em tags do Amazon Pinpoint

É possível associar tags a determinados tipos de recursos do Amazon Pinpoint ou passar tags em uma solicitação para o Amazon Pinpoint. 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 aws:ResourceTag/${TagKey}, aws:RequestTag/${TagKey} ou chaves de condição aws:TagKeys.

Para obter informações sobre a marcação de recursos do Amazon Pinpoint, incluindo um IAM exemplo de política, consulte. Gerenciar tags de recursos do Amazon Pinpoint

Funções do Amazon Pinpoint IAM

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

Usar credenciais temporárias com o Amazon Pinpoint

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 chamando API operações AWS Security Token Service (AWS STS) como AssumeRoleou GetFederationToken.

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

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. As funções vinculadas ao serviço aparecem em sua IAM conta e são de propriedade do serviço. Um IAM administrador pode visualizar, mas não editar, as permissões para funções vinculadas ao serviço.

O Amazon Pinpoint não usa funções vinculadas ao serviço.

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 Pinpoint oferece suporte ao uso de funções de serviço.