Aviso de fim do suporte: em 30 de outubro de 2026, AWS encerrará o suporte para o Amazon Pinpoint. Depois de 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint ou os recursos do Amazon Pinpoint (endpoints, segmentos, campanhas, viagens e análises). Para obter mais informações, consulte Fim do suporte do Amazon Pinpoint. Observação: APIs relacionados a SMS, voz, push móvel, OTP e validação de número de telefone não são afetados por essa alteração e são compatíveis com o AWS End User Messaging.
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 o 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 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 com segurança o acesso aos recursos. 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 ter uma visão de alto nível de como o Amazon Pinpoint 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.
Tópicos
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 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 podem ser usadas 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.
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:
-
mobiletargeting
: para ações que derivam da API do Amazon Pinpoint, que é a API principal do Amazon Pinpoint. -
sms-voice
: para ações que derivam da API de voz e SMS do Amazon Pinpoint, que é uma API complementar que oferece opções avançadas para usar e gerenciar os canais de SMS e voz no Amazon Pinpoint.
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 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": "*"
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 Amazon Resource Names (ARNs) no Referência geral da AWS.
Nas políticas do IAM, você pode especificar ARNs os seguintes tipos de recursos do Amazon Pinpoint:
-
Campanhas
-
Jornadas
-
Modelos de mensagens (referidos como modelos em alguns contextos)
-
Projetos (referidos como apps ou aplicativos em alguns contextos)
-
Modelos de recomendação (conhecidos como recomendações em alguns contextos)
-
Segmentos
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 os seguintes tipos de recursos de SMS e voz do Amazon Pinpoint:
-
Conjunto de configurações
-
Lista de exclusão
-
Número de telefone
-
Grupo
-
ID do remetente
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 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 de Condition
em uma declaração ou várias chaves em um único elemento de Condition
, 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 recurso 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 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 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. Você obtém credenciais de segurança temporárias chamando AWS Security Token Service (AWS STS) operações de API, como AssumeRoleou GetFederationToken.
O Amazon Pinpoint oferece suporte ao uso de credenciais temporárias.
Perfis vinculados 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.
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.