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á.
Use AWS Identity and Access Management para autenticar
AWS Identity and Access Management (IAM) é uma ferramenta AWS service (Serviço da AWS) que ajuda o administrador a controlar com segurança o acesso aos AWS recursos. Os administradores do IAM controlam quem pode ser autenticado (conectado) e autorizado (ter permissões) para utilizar os recursos do Amazon Location. O IAM é um AWS service (Serviço da AWS) que você pode usar sem custo adicional.
Tópicos
Público
A forma como você usa AWS Identity and Access Management (IAM) difere com base na sua função:
-
Usuário do serviço - solicite permissões do seu administrador se você não conseguir acessar os recursos (consulteResolução de problemas de identidade e acesso no Amazon Location Service)
-
Administrador do serviço - determine o acesso do usuário e envie solicitações de permissão (consulteComo o Amazon Location Service funciona com o IAM)
-
Administrador do IAM - escreva políticas para gerenciar o acesso (consulteExemplos de políticas baseadas em identidade do Amazon Location Service)
Autenticação com identidades
A autenticação é a forma como você faz login AWS usando suas credenciais de identidade. Você deve estar autenticado como usuário do IAM ou assumindo uma função do IAM. Usuário raiz da conta da AWS
Você pode fazer login como uma identidade federada usando credenciais de uma fonte de identidade como AWS IAM Identity Center (IAM Identity Center), autenticação de login único ou credenciais. Google/Facebook Para obter mais informações sobre como fazer login, consulte Como fazer login Conta da AWS no Guia do Início de Sessão da AWS usuário.
Para acesso programático, AWS fornece um SDK e uma CLI para assinar solicitações criptograficamente. Para obter mais informações, consulte AWS Signature versão 4 para solicitações de API no Guia do usuário do IAM.
Conta da AWS usuário root
Ao criar um Conta da AWS, você começa com uma identidade de login chamada usuário Conta da AWS raiz que tem acesso completo a todos Serviços da AWS os recursos. É altamente recomendável que você não use o usuário root para tarefas diárias. Para tarefas que exigem credenciais de usuário raiz, consulte Tarefas que exigem credenciais de usuário raiz no Guia do usuário do IAM.
Identidade federada
Como prática recomendada, exija que os usuários humanos usem a federação com um provedor de identidade para acessar Serviços da AWS usando credenciais temporárias.
Uma identidade federada é um usuário do seu diretório corporativo, provedor de identidade da web ou Directory Service que acessa Serviços da AWS usando credenciais de uma fonte de identidade. As identidades federadas assumem funções que fornecem credenciais temporárias.
Para gerenciamento centralizado de acesso, recomendamos AWS IAM Identity Center. Para obter mais informações, consulte O que é o IAM Identity Center? no Guia do usuário do AWS IAM Identity Center .
Usuários e grupos do IAM
Um usuário do IAM é uma identidade com permissões específicas para uma única pessoa ou aplicativo. Recomendamos usar credenciais temporárias em vez de usuários do IAM com credenciais de longo prazo. Para obter mais informações, consulte Exigir que usuários humanos usem a federação com um provedor de identidade para acessar AWS usando credenciais temporárias no Guia do usuário do IAM.
Um grupo do IAM especifica uma coleção de usuários do IAM e facilita o gerenciamento de permissões para grandes conjuntos de usuários. Para obter mais informações, consulte Casos de uso para usuários do IAM no Guia do usuário do IAM.
IAM roles
Uma função do IAM é uma identidade com permissões específicas que fornece credenciais temporárias. Você pode assumir uma função mudando de um usuário para uma função do IAM (console) ou chamando uma operação de AWS API AWS CLI ou. Para obter mais informações, consulte Métodos para assumir um perfil no Manual do usuário do IAM.
As funções do IAM são úteis para acesso de usuários federados, permissões temporárias de usuários do IAM, acesso entre contas, acesso entre serviços e aplicativos executados na Amazon. EC2 Consulte mais informações em Acesso a recursos entre contas no IAM no Guia do usuário do IAM.
Gerenciar o acesso usando políticas
Você controla o acesso AWS criando políticas e anexando-as a AWS identidades ou recursos. Uma política define permissões quando associada a uma identidade ou recurso. AWS avalia essas políticas quando um diretor faz uma solicitação. A maioria das políticas é armazenada AWS como documentos JSON. Para obter mais informações sobre documentos de política JSON, consulte Visão geral das políticas JSON no Guia do usuário do IAM.
Usando políticas, os administradores especificam quem tem acesso ao quê, definindo qual diretor pode realizar ações em quais recursos e sob quais condições.
Por padrão, usuários e perfis não têm permissões. Um administrador do IAM cria políticas do IAM e as adiciona às funções, que os usuários podem então assumir. As políticas do IAM definem permissões independentemente do método usado para realizar a operação.
Políticas baseadas em identidade
Políticas baseadas em identidade são documentos de políticas de permissões JSON que você anexa a uma identidade (usuário, grupo ou função). Essas políticas controlam quais ações as identidades podem realizar, em quais recursos e sob quais condições. Para saber como criar uma política baseada em identidade, consulte Definir permissões personalizadas do IAM com as políticas gerenciadas pelo cliente no Guia do Usuário do IAM.
As políticas baseadas em identidade podem ser políticas em linha (incorporadas diretamente em uma única identidade) ou políticas gerenciadas (políticas autônomas anexadas a várias identidades). Para saber como escolher entre políticas gerenciadas e em linha, consulte Escolha entre políticas gerenciadas e políticas em linha no Guia do usuário do IAM.
Políticas baseadas em recursos
Políticas baseadas em atributos são documentos de políticas JSON que você anexa a um atributo. Os exemplos incluem políticas de confiança de funções do IAM e políticas de bucket do Amazon S3. Em serviços compatíveis com políticas baseadas em recursos, os administradores de serviço podem usá-las para controlar o acesso a um recurso específico. Você deve especificar uma entidade principal em uma política baseada em recursos.
Políticas baseadas em recursos são políticas em linha localizadas nesse serviço. Você não pode usar políticas AWS gerenciadas do IAM em uma política baseada em recursos.
Outros tipos de política
AWS oferece suporte a tipos de políticas adicionais que podem definir o máximo de permissões concedidas por tipos de políticas mais comuns:
-
Limites de permissões — defina o máximo de permissões que uma política baseada em identidade pode conceder a uma entidade do IAM. Para obter mais informações, consulte Limites de permissões para entidades do IAM no Guia do usuário do IAM.
-
Políticas de controle de serviço (SCPs) — Especifique as permissões máximas para uma organização ou unidade organizacional em AWS Organizations. Para obter mais informações, consulte Políticas de controle de serviço no Guia do usuário do AWS Organizations .
-
Políticas de controle de recursos (RCPs) — Defina o máximo de permissões disponíveis para recursos em suas contas. Para obter mais informações, consulte Políticas de controle de recursos (RCPs) no Guia AWS Organizations do usuário.
-
Políticas de sessão — Políticas avançadas passadas como parâmetro ao criar uma sessão temporária para uma função ou usuário federado. Para obter mais informações, consulte Políticas de sessão no Guia do usuário do IAM.
Vários tipos de política
Quando vários tipos de política são aplicáveis a uma solicitação, é mais complicado compreender as permissões resultantes. Para saber como AWS determinar se uma solicitação deve ser permitida quando vários tipos de políticas estão envolvidos, consulte Lógica de avaliação de políticas no Guia do usuário do IAM.
Como o Amazon Location Service funciona com o IAM
Antes de usar o IAM para gerenciar o acesso ao Amazon Location, entenda que atributos do IAM estão disponíveis para uso com o Amazon Location.
| Recurso do IAM | Suporte do Amazon Location |
|---|---|
|
Sim |
|
|
Não |
|
|
Sim |
|
|
Sim |
|
|
Sim |
|
|
Não |
|
|
Sim |
|
|
Sim |
|
|
Não |
|
|
Não |
|
|
Não |
Para ter uma visão de alto nível de como o Amazon Location e outros AWS serviços funcionam com a maioria dos recursos do IAM, consulte AWS os serviços que funcionam com o IAM no Guia do usuário do IAM.
Políticas baseadas em identidade para o Amazon Location
Compatível com políticas baseadas em identidade: sim
As políticas baseadas em identidade são documentos de políticas de permissões JSON que você pode anexar a uma identidade, como usuário do IAM, grupo de usuários ou perfil. Essas políticas controlam quais ações os usuários e perfis podem realizar, em quais recursos e em que condições. Para saber como criar uma política baseada em identidade, consulte Definir permissões personalizadas do IAM com as políticas gerenciadas pelo cliente no Guia do Usuário do IAM.
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. Para saber mais sobre todos os elementos que podem ser usados em uma política JSON, consulte IAM JSON policy elements reference (Referência de elementos da política JSON do IAM) no Guia do usuário do IAM.
Exemplos de políticas baseadas em identidade para o Amazon Location
Para ver exemplos de políticas baseadas em identidade do Amazon Location, consulte Exemplos de políticas baseadas em identidade do Amazon Location Service.
Políticas baseadas em recursos no Amazon Location
Compatibilidade com políticas baseadas em recursos: não
Políticas baseadas em recursos são documentos de políticas JSON que você anexa a um recurso. São exemplos de políticas baseadas em recursos as políticas de confiança de perfil do IAM e as políticas de bucket do Amazon S3. Em serviços compatíveis com políticas baseadas em recursos, os administradores de serviço podem usá-las para controlar o acesso a um recurso específico. Para o atributo ao qual a política está anexada, a política define quais ações uma entidade principal especificado pode executar nesse atributo e em que condiçõ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. Serviços da AWS
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 recursos. Consulte mais informações em Acesso a recursos entre contas no IAM no Guia do usuário do IAM.
Ações de políticas para o Amazon Location
Compatível com ações de políticas: sim
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. Incluem ações em uma política para conceder permissões para executar a operação associada.
Para ver uma lista de ações do Amazon Location, consulte Ações definidas pelo Amazon Location Service em Service Authorization Reference (Referência de autorização do serviço).
As ações de política no Amazon Location usam o seguinte prefixo antes da ação:
geo
Para especificar várias ações em uma única instrução, separe-as com vírgulas.
"Action": [ "geo:action1", "geo: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": "geo:Get*"
Para ver exemplos de políticas baseadas em identidade do Amazon Location, consulte Exemplos de políticas baseadas em identidade do Amazon Location Service.
Recursos de políticas para o Amazon Location
Compatível com recursos de políticas: sim
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. Como prática recomendada, especifique um recurso usando seu nome do recurso da Amazon (ARN). Para ações que não oferecem suporte a permissões em nível de recurso, use um caractere curinga (*) para indicar que a declaração se aplica a todos os recursos.
"Resource": "*"
Para ver uma lista dos tipos de recursos de localização da Amazon e seus ARNs, consulte Resources Defined by Amazon Location Service na Referência de autorização de serviço. Para saber com quais ações você pode especificar o ARN de cada recurso, consulte Actions Defined by Amazon Location Service (Ações definidas pelo Amazon Location Service).
Para ver exemplos de políticas baseadas em identidade do Amazon Location, consulte Exemplos de políticas baseadas em identidade do Amazon Location Service.
Chaves de condição de políticas para o Amazon Location
Compatível com chaves de condição de política específicas de serviço: sim
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 Condition elemento 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 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 Location, consulte Condition Keys for Amazon Location Service (Chaves de condição do Amazon Location Service) em Service Authorization Reference (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 Actions Defined by Amazon Location Service (Ações definidas pelo Amazon Location Service).
O Amazon Location é compatível com chaves de condição para permitir ou negar o acesso a geocercas ou dispositivos específicos em suas declarações de política. As seguintes chaves de condição estão disponíveis:
-
geo:GeofenceIdspara uso com ações de Geocercas. O tipo éArrayOfString. -
geo:DeviceIdspara uso com ações do Rastreador. O tipo éArrayOfString.
As ações a seguir podem ser usadas com geo:GeofenceIds na sua política do IAM:
-
BatchDeleteGeofences -
BatchPutGeofences -
GetGeofence -
PutGeofence
As ações a seguir podem ser usadas com geo:DeviceIds na sua política do IAM:
-
BatchDeleteDevicePositionHistory -
BatchGetDevicePosition -
BatchUpdateDevicePosition -
GetDevicePosition -
GetDevicePositionHistory
nota
Você não pode usar essas chaves de condição com as ações BatchEvaluateGeofences, ListGeofences, ou ListDevicePosition.
Para ver exemplos de políticas baseadas em identidade do Amazon Location, consulte Exemplos de políticas baseadas em identidade do Amazon Location Service.
ACLs na localização da Amazon
Suportes ACLs: Não
As listas de controle de acesso (ACLs) controlam quais diretores (membros da conta, usuários ou funções) têm permissões para acessar um recurso. ACLs são semelhantes às políticas baseadas em recursos, embora não usem o formato de documento de política JSON.
ABAC com o Amazon Location
Compatível com ABAC (tags em políticas): sim
O controle de acesso baseado em atributos (ABAC) é uma estratégia de autorização que define permissões com base em atributos chamados de tags. Você pode anexar tags a entidades e AWS recursos do IAM e, em seguida, criar políticas ABAC para permitir operações quando a tag do diretor corresponder à tag no recurso.
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/, key-nameaws:RequestTag/ ou chaves de condição key-nameaws:TagKeys.
Se um serviço for compatível com as três chaves de condição para cada tipo de recurso, o valor será Sim para o serviço. Se um serviço for compatível com as três chaves de condição somente para alguns tipos de recursos, o valor será Parcial
Para obter mais informações sobre o ABAC, consulte Definir permissões com autorização do ABAC no Guia do usuário do IAM. Para visualizar um tutorial com etapas para configurar o ABAC, consulte Usar controle de acesso baseado em atributos (ABAC) no Guia do usuário do IAM.
Para ter mais informações sobre recursos de marcação do Amazon Location, consulte Como usar tags.
Para visualizar um exemplo de política baseada em identidade para limitar o acesso a um recurso baseado em tags desse recurso, consulte Controlar o acesso a recursos com base em tags.
Uso de credenciais temporárias com o Amazon Location
Compatível com credenciais temporárias: sim
As credenciais temporárias fornecem acesso de curto prazo aos AWS recursos e são criadas automaticamente quando você usa a federação ou troca de funções. AWS recomenda que você gere credenciais temporárias dinamicamente em vez de usar chaves de acesso de longo prazo. Para obter mais informações, consulte Credenciais de segurança temporárias no IAM e Serviços da AWS que funcionam com o IAM no Guia do usuário do IAM.
Permissões de entidades principais entre serviços para o Amazon Location
Compatível com o recurso de encaminhamento de sessões de acesso (FAS): Não
As sessões de acesso direto (FAS) usam as permissões do principal chamando um AWS service (Serviço da AWS), combinadas com a solicitação AWS service (Serviço da AWS) de fazer solicitações aos serviços posteriores. Para obter detalhes da política ao fazer solicitações de FAS, consulte Sessões de acesso direto.
Perfis de serviço para o Amazon Location
Compatível com perfis de serviço: não
O perfil de serviço é um perfil do IAM que um serviço assume para executar ações em seu nome. Um administrador do IAM pode criar, modificar e excluir um perfil de serviço do IAM. Para obter mais informações, consulte Criar um perfil para delegar permissões a um AWS service (Serviço da AWS) no Guia do Usuário do IAM.
Atenção
A alteração das permissões de um perfil de serviço pode interromper a funcionalidade do Amazon Location. Edite perfis de serviço somente quando o Amazon Location fornecer orientação para isso.
Perfis vinculados ao serviço para o Amazon Location
Compatível com perfis vinculados ao serviço: Não
Uma função vinculada ao serviço é um tipo de função de serviço vinculada a um. AWS service (Serviço da AWS) O serviço pode presumir o perfil para executar uma ação em seu nome. As funções vinculadas ao serviço aparecem em você Conta da AWS e são de propriedade do serviço. Um administrador do IAM pode visualizar, mas não editar as permissões para funções vinculadas ao serviço.
Para obter detalhes sobre como criar ou gerenciar perfis vinculados a serviços, consulte Serviços da AWS
que funcionam com o IAM. Encontre um serviço na tabela que inclua um Yes na coluna Perfil vinculado ao serviço. Escolha o link Sim para visualizar a documentação do perfil vinculado a serviço desse serviço.
Como o Amazon Location Service funciona com usuários não autenticados
Muitos cenários para usar o Amazon Location Service, incluindo a exibição de mapas na web ou em um aplicativo móvel, requerem a permissão de acesso a usuários que não tenham feito login com o IAM. Nesses casos não autenticados, você tem duas opções.
-
Use chaves da API: para conceder acesso a usuários não autenticados, você pode criar chaves da API que dão acesso somente de leitura aos seus recursos do Amazon Location Service. Isso é útil caso você não deseje autenticar todos os usuários. Por exemplo, um aplicativo da web. Para obter mais informações sobre chaves da API, consulte Use chaves de API para autenticar.
-
Use o Amazon Cognito: uma alternativa às chaves da API é usar o Amazon Cognito para conceder acesso anônimo. O Amazon Cognito permite que você crie uma autorização mais rica com uma política do IAM para definir o que pode ser feito pelos usuários não autenticados. Para obter mais informações sobre como usar o Amazon Cognito, consulte Use o pool de identidade do Amazon Cognito na web.
Para obter uma visão geral sobre como fornecer acesso a usuários não autenticados, consulte Autenticar com o Amazon Location Service.
Exemplos de políticas baseadas em identidade do Amazon Location Service
Por padrão, usuários e perfis não têm permissão para criar ou modificar recursos do Amazon Location. Para conceder permissão aos usuários para executar ações nos recursos que eles precisam, um administrador do IAM pode criar políticas do IAM.
Para aprender a criar uma política baseada em identidade do IAM ao usar esses documentos de política em JSON de exemplo, consulte Criar políticas do IAM (console) no Guia do usuário do IAM.
Para obter detalhes sobre ações e tipos de recursos definidos pela Amazon Location, incluindo o formato de cada um dos ARNs tipos de recursos, consulte Actions, Resources, and Condition Keys for Amazon Location Service na Referência de Autorização de Serviço.
Tópicos
Práticas recomendadas de política
As políticas baseadas em identidade determinam se alguém pode criar, acessar ou excluir recursos do Amazon Location em sua conta. Essas ações podem incorrer em custos para sua Conta da AWS. Ao criar ou editar políticas baseadas em identidade, siga estas diretrizes e recomendações:
-
Comece com as políticas AWS gerenciadas e avance para as permissões de privilégios mínimos — Para começar a conceder permissões aos seus usuários e cargas de trabalho, use as políticas AWS gerenciadas que concedem permissões para muitos casos de uso comuns. Eles estão disponíveis no seu Conta da AWS. Recomendamos que você reduza ainda mais as permissões definindo políticas gerenciadas pelo AWS cliente que sejam específicas para seus casos de uso. Para obter mais informações, consulte Políticas gerenciadas pela AWS ou Políticas gerenciadas pela AWS para funções de trabalho no Guia do usuário do IAM.
-
Aplique permissões de privilégio mínimo: ao definir permissões com as políticas do IAM, conceda apenas as permissões necessárias para executar uma tarefa. Você faz isso definindo as ações que podem ser executadas em recursos específicos sob condições específicas, também conhecidas como permissões de privilégio mínimo. Para obter mais informações sobre como usar o IAM para aplicar permissões, consulte Políticas e permissões no IAM no Guia do usuário do IAM.
-
Use condições nas políticas do IAM para restringir ainda mais o acesso: você pode adicionar uma condição às políticas para limitar o acesso a ações e recursos. Por exemplo, você pode escrever uma condição de política para especificar que todas as solicitações devem ser enviadas usando SSL. Você também pode usar condições para conceder acesso às ações de serviço se elas forem usadas por meio de uma ação específica AWS service (Serviço da AWS), como CloudFormation. Para obter mais informações, consulte Elementos da política JSON do IAM: condição no Guia do usuário do IAM.
-
Use o IAM Access Analyzer para validar suas políticas do IAM a fim de garantir permissões seguras e funcionais: o IAM Access Analyzer valida as políticas novas e existentes para que elas sigam a linguagem de política do IAM (JSON) e as práticas recomendadas do IAM. O IAM Access Analyzer oferece mais de cem verificações de política e recomendações práticas para ajudar a criar políticas seguras e funcionais. Para obter mais informações, consulte Validação de políticas do IAM Access Analyzer no Guia do Usuário do IAM.
-
Exigir autenticação multifator (MFA) — Se você tiver um cenário que exija usuários do IAM ou um usuário root, ative Conta da AWS a MFA para obter segurança adicional. Para exigir MFA quando as operações de API forem chamadas, adicione condições de MFA às suas políticas. Para obter mais informações, consulte Configuração de acesso à API protegido por MFA no Guia do Usuário do IAM.
Para obter mais informações sobre as práticas recomendadas do IAM, consulte Práticas recomendadas de segurança no IAM no Guia do usuário do IAM.
Usar o console do Amazon Location
Para acessar o console do Amazon Location Service, você deve ter um conjunto mínimo de permissões. Essas permissões devem permitir que você liste e visualize detalhes sobre os recursos de localização da Amazon em seu Conta da AWS. Caso crie uma política baseada em identidade mais restritiva que as permissões mínimas necessárias, o console não funcionará como pretendido para entidades (usuários ou perfis) com essa política.
Você não precisa permitir permissões mínimas do console para usuários que estão fazendo chamadas somente para a API AWS CLI ou para a AWS API. Em vez disso, permita o acesso somente a ações que correspondam à operação de API que estiverem tentando executar.
Para garantir que usuários e perfis ainda possam usar o console do Amazon Location, anexe também a política para as entidades. Para obter informações, consulte Adicionar permissões a um usuário no Guia do usuário do IAM.
A política a seguir dá acesso ao console do Amazon Location Service para poder criar, excluir, listar e visualizar detalhes sobre os recursos de localização do Amazon Location em sua conta AWS .
{ "Version": "2012-10-17", "Statement": [ { "Sid": "GeoPowerUser", "Effect": "Allow", "Action": [ "geo:*", "geo-maps:*", "geo-places:*", "geo-routes:*" ], "Resource": "*" } ] }
Alternativamente, você pode conceder permissões de somente leitura para facilitar o acesso como somente leitura. Com permissões somente leitura, uma mensagem de erro aparecerá se o usuário tentar escrever ações, como criar ou excluir recursos. Como exemplo, consulte Política somente leitura para recursos do rastreador
Permitir que os usuários visualizem suas próprias permissões
Este exemplo mostra como criar uma política que permita que os usuários do IAM visualizem as políticas gerenciadas e em linha anexadas a sua identidade de usuário. Essa política inclui permissões para concluir essa ação no console ou programaticamente usando a API AWS CLI ou AWS .
{ "Version": "2012-10-17", "Statement": [ { "Sid": "ViewOwnUserInfo", "Effect": "Allow", "Action": [ "iam:GetUserPolicy", "iam:ListGroupsForUser", "iam:ListAttachedUserPolicies", "iam:ListUserPolicies", "iam:GetUser" ], "Resource": ["arn:aws:iam::*:user/${aws:username}"] }, { "Sid": "NavigateInConsole", "Effect": "Allow", "Action": [ "iam:GetGroupPolicy", "iam:GetPolicyVersion", "iam:GetPolicy", "iam:ListAttachedGroupPolicies", "iam:ListGroupPolicies", "iam:ListPolicyVersions", "iam:ListPolicies", "iam:ListUsers" ], "Resource": "*" } ] }
Usar os recursos do Amazon Location Service em políticas
O Amazon Location Service usa os seguintes prefixos para recursos:
| Recurso | Prefixo do recurso |
|---|---|
| Recursos de mapa | map |
| Recursos de local | place-index |
| Recursos de rota | route-calculator |
| Recursos de rastreamento | tracker |
| Recursos da coleção de geocercas | geofence-collection |
Use a seguinte sintaxe ARN:
arn:Partition:geo:Region:Account:ResourcePrefix/ResourceName
Para obter mais informações sobre o formato de ARNs, consulte Amazon Resource Names (ARNs) e AWS Service Namespaces.
Exemplos
-
Use o seguinte ARN para permitir o acesso a um recurso de mapa especificado.
"Resource": "arn:aws:geo:us-west-2:account-id:map/map-resource-name" -
Para especificar o acesso a todos os recursos da
mapque pertencem a uma conta específica, use o caractere curinga (*):"Resource": "arn:aws:geo:us-west-2:account-id:map/*" -
Algumas ações do Amazon Location, como as que servem para a criação de recursos, não podem ser executadas em um recurso específico. Nesses casos, você deve utilizar o caractere curinga (*).
"Resource": "*"
Para ver uma lista dos tipos de recursos de localização da Amazon e seus ARNs, consulte Resources Defined by Amazon Location Service na Referência de autorização de serviço. Para saber com quais ações você pode especificar o ARN de cada recurso, consulte Actions Defined by Amazon Location Service (Ações definidas pelo Amazon Location Service).
Permissões para atualizar as posições do dispositivo
Para atualizar as posições do dispositivo para vários rastreadores, você deve conceder a um usuário o acesso a um ou mais dos seus recursos de rastreador. Você também deverá permitir que o usuário atualize um lote de posições do dispositivo.
Neste exemplo, além de conceder acesso aos Tracker2 recursos Tracker1 e, a política a seguir concede permissão para usar a geo:BatchUpdateDevicePosition ação contra os Tracker2 recursos Tracker1 e.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "UpdateDevicePositions", "Effect": "Allow", "Action": [ "geo:BatchUpdateDevicePosition" ], "Resource": [ "arn:aws:geo:us-west-2:account-id:tracker/Tracker1", "arn:aws:geo:us-west-2:account-id:tracker/Tracker2" ] } ] }
Se você quiser limitar o usuário a poder atualizar somente as posições de um dispositivo específico, você pode adicionar uma chave de condição para a ID desse dispositivo.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "UpdateDevicePositions", "Effect": "Allow", "Action": [ "geo:BatchUpdateDevicePosition" ], "Resource": [ "arn:aws:geo:us-west-2:account-id:tracker/Tracker1", "arn:aws:geo:us-west-2:account-id:tracker/Tracker2" ], "Condition":{ "ForAllValues:StringLike":{ "geo:DeviceIds":[ "deviceId" ] } } } ] }
Política somente leitura para recursos do rastreador
Para criar uma política somente de leitura para todos os recursos do rastreador em sua AWS conta, você precisará conceder acesso a todos os recursos do rastreador. Você também deve conceder ao usuário o acesso a ações que permitam obter a posição do dispositivo para vários dispositivos, obter a posição do dispositivo a partir de um único dispositivo e obter o histórico de posições.
Neste exemplo, a política a seguir concede permissão para as seguintes ações:
-
geo:BatchGetDevicePositionpara recuperar as posições de vários dispositivos. -
geo:GetDevicePositionpara recuperar a posição de um único dispositivo. -
geo:GetDevicePositionHistorypara recuperar o histórico de posições de um dispositivo.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "GetDevicePositions", "Effect": "Allow", "Action": [ "geo:BatchGetDevicePosition", "geo:GetDevicePosition", "geo:GetDevicePositionHistory" ], "Resource": "arn:aws:geo:us-west-2:account-id:tracker/*" } ] }
Política para a criação de geocercas
Para criar uma política que permita a um usuário criar geocercas, você precisará conceder acesso a ações específicas que permitam aos usuários criar uma ou mais geocercas em uma coleção de geocercas.
A política abaixo concede permissão para as seguintes ações emCollection:
-
geo:BatchPutGeofencepara criar várias geocercas. -
geo:PutGeofencepara criar uma única geocerca.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "CreateGeofences", "Effect": "Allow", "Action": [ "geo:BatchPutGeofence", "geo:PutGeofence" ], "Resource": "arn:aws:geo:us-west-2:account-id:geofence-collection/Collection" } ] }
Política somente leitura para geocercas
Para criar uma política somente leitura para geocercas armazenadas em uma coleção de geocercas na sua conta AWS , você precisará conceder acesso às ações que são lidas da coleção de geocercas que armazena as geocercas.
A política abaixo concede permissão para as seguintes ações emCollection:
-
geo:ListGeofencespara listar geocercas na coleção de geocercas especificada. -
geo:GetGeofencepara recuperar uma geocerca da coleção de geocercas.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "GetGeofences", "Effect": "Allow", "Action": [ "geo:ListGeofences", "geo:GetGeofence" ], "Resource": "arn:aws:geo:us-west-2:account-id:geofence-collection/Collection" } ] }
Permissões para renderizar um recurso de mapa
Para conceder permissões suficientes para renderizar mapas, você precisará conceder acesso aos blocos de mapas, “sprites”, glifos e ao descritor de estilo:
-
o
geo:GetMapTilerecupera blocos de mapas usados para renderizar seletivamente os atributos em um mapa. -
o
geo:GetMapSpritesrecupera a planilha de sprites PNG e o documento JSON correspondente, descrevendo os desvios dentro dela. -
o
geo:GetMapGlyphsrecupera os glifos usados para exibir texto. -
o
geo:GetMapStyleDescriptorrecupera o descritor de estilo do mapa, contendo regras de renderização.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "GetTiles", "Effect": "Allow", "Action": [ "geo:GetMapTile", "geo:GetMapSprites", "geo:GetMapGlyphs", "geo:GetMapStyleDescriptor" ], "Resource": "arn:aws:geo:us-west-2:account-id:map/Map" } ] }
Permissões para operações de pesquisa
Para criar uma política que permita operações de pesquisa, primeiro você precisará conceder acesso ao recurso de índice de lugares em sua AWS conta. Você também deverá conceder acesso a ações que permitam ao usuário pesquisar usando texto por geocodificação e pesquisar usando uma posição por geocodificação reversa.
Neste exemplo, além de conceder acesso aPlaceIndex, a política a seguir também concede permissão para as seguintes ações:
-
o
geo:SearchPlaceIndexForPositionpermite que você pesquise lugares ou pontos de interesse próximos a uma determinada posição. -
o
geo:SearchPlaceIndexForTextpermite que você pesquise um endereço, nome, cidade ou região usando texto em formato livre.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "Search", "Effect": "Allow", "Action": [ "geo:SearchPlaceIndexForPosition", "geo:SearchPlaceIndexForText" ], "Resource": "arn:aws:geo:us-west-2:account-id:place-index/PlaceIndex" } ] }
Política somente leitura para calculadoras de rotas
Você pode criar uma política somente leitura para permitir que um usuário acesse um recurso de calculadora de rotas para calcular uma rota.
Neste exemplo, além de conceder acesso aExampleCalculator, a política a seguir concede permissão para a seguinte operação:
-
o
geo:CalculateRoutecalcula uma rota com base em uma posição de partida, posição de destino e uma lista de posições de pontos de referência.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "RoutesReadOnly", "Effect": "Allow", "Action": [ "geo:CalculateRoute" ], "Resource": "arn:aws:geo:us-west-2:accountID:route-calculator/ExampleCalculator" } ] }
Controlar o acesso aos recursos com base nas chaves de condições
Ao criar uma política do IAM para conceder acesso ao uso de geocercas ou posições de dispositivos, você pode usar operadores de condição para obter um controle mais preciso sobre quais geocercas ou dispositivos um usuário pode acessar. Você pode fazer isso incluindo o ID da geocerca ou o ID do dispositivo no elemento Condition da sua política.
O exemplo de política a seguir mostra como você pode criar uma política que permita que um usuário atualize as posições de um dispositivo específico.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "UpdateDevicePositions", "Effect": "Allow", "Action": [ "geo:BatchUpdateDevicePosition" ], "Resource": [ "arn:aws:geo:us-west-2:account-id:tracker/Tracker" ], "Condition":{ "ForAllValues:StringLike":{ "geo:DeviceIds":[ "deviceId" ] } } } ] }
Controlar o acesso a recursos com base em tags
Ao criar uma política do IAM para conceder acesso para usar os recursos do seu Amazon Location, você pode usar o controle de acesso baseado em atributos para controlar melhor quais recursos um usuário pode modificar, usar ou excluir. Você pode fazer isso incluindo as informações da tag no elemento Condition da sua política para controlar o acesso com base nas suas tags de recursos.
O exemplo de política a seguir mostra como você pode criar uma política que permita que um usuário crie geocercas. Isso concede a permissão às seguintes ações para criar uma ou mais cercas geográficas em uma coleção de cercas geográficas chamada: Collection
-
geo:BatchPutGeofencepara criar várias geocercas. -
geo:PutGeofencepara criar uma única geocerca.
No entanto, essa política usa o Condition elemento para conceder a permissão somente se a Collection tag,Owner, tiver o valor do nome de usuário desse usuário.
-
Por exemplo, se um usuário chamado
richard-roetentar visualizar uma localização da AmazonCollection, elaCollectiondeverá ser marcada comoOwner=richard-roeouowner=richard-roe. Caso contrário, o usuário terá o acesso negado.nota
A chave da tag de condição
Ownercorresponde aOwnere aownerporque os nomes das chaves de condição não fazem distinção entre maiúsculas e minúsculas. Para obter mais informações, consulte IAM JSON Policy Elements: Condition (Elementos da política JSON do IAM: Condição) no Guia do usuário do IAM.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "CreateGeofencesIfOwner", "Effect": "Allow", "Action": [ "geo:BatchPutGeofence", "geo:PutGeofence" ], "Resource": "arn:aws:geo:us-west-2:account-id:geofence-collection/Collection", "Condition": { "StringEquals": {"geo:ResourceTag/Owner": "${aws:username}"} } } ] }
Para ver um tutorial sobre como definir permissões para acessar recursos da AWS com base em tags, consulte o Guia do usuário do AWS Identity and Access Management .
Resolução de problemas de identidade e acesso no Amazon Location Service
Use as informações a seguir para diagnosticar e corrigir problemas comuns que você pode encontrar ao trabalhar com o Amazon Location e o IAM.
Tópicos
Não tenho autorização para executar uma ação no Amazon Location
Se você receber uma mensagem de erro informando que não tem autorização para executar uma ação, suas políticas deverão ser atualizadas para permitir que você realize a ação.
O erro do exemplo a seguir ocorre quando o usuário do IAM mateojackson tenta usar o console para visualizar detalhes sobre um atributo fictício, mas não tem as permissões my-example-widgetgeo: fictícias.GetWidget
User: arn:aws:iam::123456789012:user/mateojackson is not authorized to perform: geo:GetWidgeton resource:my-example-widget
Nesse caso, a política do usuário mateojackson deve ser atualizada para permitir o acesso ao recurso usando a ação my-example-widgetgeo:.GetWidget
Se precisar de ajuda, entre em contato com seu AWS administrador. Seu administrador é a pessoa que forneceu suas credenciais de login.
Não estou autorizado a realizar iam: PassRole
Caso receba uma mensagem de erro informando que você não tem autorização para executar a ação iam:PassRole, as suas políticas deverão ser atualizadas para permitir que você atribua um perfil ao Amazon Location.
Alguns Serviços da AWS permitem que você passe uma função existente para esse serviço em vez de criar uma nova função de serviço ou uma função vinculada ao serviço. Para fazer isso, é preciso ter permissões para passar o perfil para o serviço.
O erro exemplificado a seguir ocorre quando uma usuária do IAM chamada marymajor tenta usar o console para executar uma ação no Amazon Location. No entanto, a ação exige que o serviço tenha permissões concedidas por um perfil de serviço. Mary não tem permissões para passar o perfil para o serviço.
User: arn:aws:iam::123456789012:user/marymajoris not authorized to perform: iam:PassRole
Nesse caso, as políticas de Mary devem ser atualizadas para permitir que ela realize a ação iam:PassRole.
Se precisar de ajuda, entre em contato com seu AWS administrador. Seu administrador é a pessoa que forneceu suas credenciais de login.
Quero permitir que pessoas de fora da minha Conta da AWS acessem meus recursos de localização da Amazon
Você pode criar um perfil que os usuários de outras contas ou pessoas fora da organização podem usar para acessar seus recursos. É possível especificar quem é confiável para assumir o perfil. Para serviços que oferecem suporte a políticas baseadas em recursos ou listas de controle de acesso (ACLs), você pode usar essas políticas para conceder às pessoas acesso aos seus recursos.
Para saber mais, consulte:
-
Para saber se o Amazon Location é compatível com esses recursos, consulte Como o Amazon Location Service funciona com o IAM.
-
Para saber como fornecer acesso aos seus recursos em todos os Contas da AWS que você possui, consulte Como fornecer acesso a um usuário do IAM em outro Conta da AWS que você possui no Guia do usuário do IAM.
-
Para saber como fornecer acesso aos seus recursos a terceiros Contas da AWS, consulte Como fornecer acesso Contas da AWS a terceiros no Guia do usuário do IAM.
-
Para saber como conceder acesso por meio da federação de identidades, consulte Conceder acesso a usuários autenticados externamente (federação de identidades) no Guia do usuário do IAM.
-
Para conhecer a diferença entre perfis e políticas baseadas em recurso para acesso entre contas, consulte Acesso a recursos entre contas no IAM no Guia do usuário do IAM.