Aviso de fim do suporte: em 30 de outubro de 2026, a AWS encerrará o suporte para o Amazon Pinpoint. Após 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint nem seus recursos (endpoints, segmentos, campanhas, jornadas e analytics). Para acessar mais informações, consulte Amazon Pinpoint end of support. Observação: as APIs relacionadas a SMS, voz, notificações push para dispositivos móveis, OTP e validação de número de telefone não são afetadas por essa alteração e são compatíveis com o AWS End User Messaging.

Como o Amazon Pinpoint funciona com o IAM

Para usar o Amazon Pinpoint, os usuários em sua conta da AWS precisam de permissões para visualizar dados de análises, 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 atributos do Amazon Pinpoint, crie políticas AWS Identity and Access Management (IAM) que permitam ações do Amazon Pinpoint para identidades do IAM ou recursos do Amazon Pinpoint.

O IAM é um serviço que ajuda os administradores a controlar o acesso aos recursos da AWS. As políticas do IAM incluem instruções que permitem ou proíbem usuários de executar ações específicas em recursos específicos. O Amazon Pinpoint fornece um conjunto de ações que você pode usar em políticas do IAM para especificar permissões granulares a 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 o IAM para gerenciar o acesso ao Amazon Pinpoint, você deve entender quais recursos do IAM estão disponíveis para uso com o Amazon Pinpoint. Para obter uma visualização de alto nível de como o Amazon Pinpoint e outros serviços da AWS funcionam com o IAM, consulte Serviços da AWS compatíveis com o IAM no Guia do usuário do IAM.

Políticas baseadas em identidade do Amazon Pinpoint

Com as políticas baseadas em identidade do IAM, é possível especificar ações e recursos permitidos ou negados, assim 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 podem ser usados em uma política JSON, consulte Referência de elementos de política JSON do IAM no Guia do usuário do IAM.

Ações

Os administradores podem usar as políticas JSON da AWS para especificar quem tem acesso a 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 podem ser usadas para permitir ou negar acesso em uma política. 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. Elas também controlam o que os usuários podem fazer programaticamente ao usar os AWS SDKs, a AWS Command Line Interface (AWS CLI) ou as APIs do Amazon Pinpoint diretamente.

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

Por exemplo, para conceder a alguém a permissão para visualizar informações sobre todos os segmentos de um projeto, que é uma ação que corresponde à operação GetSegments na API do Amazon Pinpoint, inclua a ação mobiletargeting:GetSegments na 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 de ações do Amazon Pinpoint que você pode usar em políticas do IAM, consulte Ações do Amazon Pinpoint para políticas do IAM.

Recursos

Os administradores podem usar as políticas JSON da AWS para especificar quem tem acesso a 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. Como prática recomendada, especifique um recurso usando seu nome do recurso da Amazon (ARN). Para ações em que não é possível usar permissões em nível de recurso, 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. Identifique um projeto com um ARN no seguinte formato:

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

Para obter mais informações sobre o formato de ARNs, consulte Nomes de recurso da Amazon (ARNs) na Referência geral da AWS.

Nas políticas do IAM, especifique os ARNs para os seguintes tipos de recursos do Amazon Pinpoint:

Por exemplo, para criar uma declaração de política para o projeto que tem o ID do projeto 810c7aab86d42fb2b56c8c966example, use o seguinte ARN:

"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 políticas do IAM, você também pode especificar ARNs para os seguintes tipos de recursos de SMS e voz do Amazon Pinpoint:

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 seguinte ARN:

"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 de SMS e voz do Amazon Pinpoint não são executadas em um recurso específico, como aquelas as que gerenciam configurações no nível da conta, por exemplo, limites de gastos. Nesses casos, você deve usar o caractere curinga (*):

"Resource": "*"

Algumas ações da API 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 seus ARNs, consulte Recursos definidos pelo Amazon Pinpoint no Guia do usuário do IAM. Para saber as ações que podem ser especificadas com o ARN de cada tipo de recurso, consulte Ações definidas pelo Amazon Pinpoint no Guia de usuário do IAM.

Chaves de condição

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

O elemento Condition especifica quando as instruções são executadas com base em critérios definidos. É 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. Para ver todas as chaves de condição globais da AWS, consulte Chaves de contexto de condição globais da AWS no Guia do usuário do IAM.

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 globais da AWS, consulte Chaves de contexto de condição globais da AWS no Guia do usuário do IAM. Para ver uma lista de chaves de condição do Amazon Pinpoint, consulte Chaves de condição para o Amazon Pinpoint no Guia do usuário do IAM. Para saber com quais ações e recursos é possível usar uma chave de condição, consulte Ações definidas pelo Amazon Pinpoint no Guia do usuário do IAM.

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

As políticas baseadas em recursos são documentos de políticas JSON que especificam quais ações uma entidade principal pode executar em um recurso do Amazon Pinpoint e em 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 como marcar recursos do Amazon Pinpoint, incluindo uma política do IAM de exemplo, consulte Gerenciar tags de recursos do Amazon Pinpoint.

Perfis do IAM do Amazon Pinpoint

Perfil do IAM é uma entidade dentro da sua conta da AWS que tem permissões específicas.

Usar credenciais temporárias com o Amazon Pinpoint

É possível usar credenciais temporárias para fazer login com federação, assumir um perfil do IAM ou assumir uma função entre contas. As credenciais de segurança temporárias são obtidas chamando operações da API do AWS Security Token Service (AWS STS), como AssumeRole ou GetFederationToken.

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

Perfis vinculados a serviço

Perfis vinculados ao serviço permitem que os serviços da AWS 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.

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. Os perfis de serviço aparecem em sua conta do IAM e são de propriedade da conta. Isso significa que um administrador do IAM pode alterar as permissões para esse perfil. Porém, fazer isso pode alterar a funcionalidade do serviço.

O Amazon Pinpoint oferece suporte ao uso de funções de serviço.