Ações, recursos e chaves de condição do Amazon Cognito Identity

O Amazon Cognito Identity (prefixo do serviço: cognito-identity) fornece os seguintes recursos, ações e chaves de contexto de condição específicos ao serviço para uso em políticas de permissão do IAM.

Referências:

• Saiba como configurar este serviço.

• Visualize uma lista das operações de API disponíveis para este serviço.

• Saiba como proteger este serviço e seus recursos usando políticas de permissão do IAM.

Ações definidas pelo Amazon Cognito Identity

Você pode especificar as seguintes ações no elemento Action de uma declaração de política do IAM. Use políticas para conceder permissões para executar uma operação na AWS. Quando usa uma ação em uma política, você geralmente permite ou nega acesso à operação da API ou ao comando da CLI com o mesmo nome. No entanto, em alguns casos, uma única ação controla o acesso a mais de uma operação. Como alternativa, algumas operações exigem várias ações diferentes.

A coluna Tipos de recursos na tabela Ações indica se cada ação é compatível com permissões no nível do recurso. Se não houver valor para essa coluna, você deverá especificar todos os recursos ("*") aos quais a política se aplica no elemento Resource de sua declaração de política. Se a coluna incluir um tipo de recurso, você poderá especificar um ARN desse tipo em uma instrução com essa ação. Se a ação tiver um ou mais recursos necessários, o chamador deverá ter permissão para usar a ação com esses recursos. Os recursos obrigatórios são indicados na tabela com um asterisco (*). Se você limitar o acesso aos recursos com o elemento Resource em uma política do IAM, deverá incluir um ARN ou padrão para cada tipo de recurso necessário. Algumas ações oferecem suporte a vários tipos de recursos. Se o tipo de recurso for opcional (não indicado como obrigatório), você poderá optar por usar um dos tipos de recurso opcionais.

A coluna Chaves de condição na tabela Ações inclui chaves que você pode especificar em um elemento Condition da declaração de política. Para obter mais informações sobre as chaves de condição associadas aos recursos do serviço, consulte a coluna Chaves de condição da tabela Tipos de recursos.

nota

As chaves de condição do recurso estão listadas na tabela Tipos de recursos. Você pode encontrar um link para o tipo de recurso que se aplica a uma ação na coluna Tipos de recursos (*obrigatório) da tabela Ações. O tipo de recurso na tabela Tipos de recursos inclui a coluna Chaves de condição, que são as chaves de condição do recurso que se aplicam a uma ação na tabela Ações.

Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de ações.

Ações	Descrição	Nível de acesso	Tipos de recursos (*necessários)	Chaves de condição	Ações dependentes
CreateIdentityPool	Concede permissão para criar um novo pool de identidades	Write		aws:RequestTag/${TagKey} aws:TagKeys
DeleteIdentities	Concede permissão para excluir identidades de um pool de identidades. Você pode especificar uma lista de 1-60 identidades que deseja excluir	Write
DeleteIdentityPool	Concede permissão para excluir um pool de usuários. Após um pool ser excluído, os usuários não poderão se autenticar nele.	Write	identitypool*
DescribeIdentity	Concede permissão para retornar metadados relacionados à identidade dada, inclusive quando a identidade foi criada e quaisquer logins vinculados associados	Read
DescribeIdentityPool	Concede permissão para obter detalhes sobre um determinado pool de identidades, incluindo o nome do pool, a descrição do ID, a data de criação e o número atual de usuários	Read	identitypool*
GetCredentialsForIdentity	Concede permissão para retornar credenciais para o ID de identidade fornecido	Read
GetId	Concede permissão para gerar (ou recuperar) um ID do Cognito. O fornecimento de vários logins criará uma conta vinculada implícita	Gravação
GetIdentityPoolAnalytics	Concede permissão para obter dados analíticos sobre a contagem total de identidades atual para todos os provedores de identidade (IDPs) do banco de identidades	Leitura	identitypool*
GetIdentityPoolDailyAnalytics	Concede permissão para obter dados analíticos sobre o número de novas identidades e sua contagem total para todos os provedores de identidade (IDPs) do banco de identidades	Leitura	identitypool*
GetIdentityPoolRoles	Concede permissão para obter as funções de um pool de identidades	Leitura	identitypool*
GetIdentityProviderDailyAnalytics	Concede permissão para obter dados analíticos sobre o número de novas identidades e sua contagem total para um provedor de identidade (IDPs) do banco de identidades	Leitura	identitypool*
GetOpenIdToken	Concede permissão para obter um token OpenID, usando um ID conhecido do Cognito	Read
GetOpenIdTokenForDeveloperIdentity	Concede permissão para registrar (ou recuperar) um Cognito IdentityID e um token OpenID Connect para um usuário autenticado pelo seu processo de autenticação de backend	Read	identitypool*
GetPrincipalTagAttributeMap	Concede permissão para obter as principais etiquetas para um pool de identidades e provedor	Read	identitypool*
ListIdentities	Concede permissão para listar as identidades de um pool de identidades	List	identitypool*
ListIdentityPools	Concede permissão para listar todos os pools de identidades do Cognito registrados na sua conta	List
ListTagsForResource	Concede permissão para listar as etiquetas atribuídas a um pool de identidades do Amazon Cognito	Read	identitypool
LookupDeveloperIdentity	Concede permissão para recuperar o IdentityId associado a um DeveloperUserIdentifier ou a lista de DeveloperUserIdentifiers associados a um IdentityId para uma identidade existente	Read	identitypool*
MergeDeveloperIdentities	Concede permissão para mesclar dois usuários com IdentityIDs diferentes, existentes no mesmo pool de identidades e identificados pelo mesmo provedor de desenvolvedores	Write	identitypool*
SetIdentityPoolRoles	Concede permissão para definir as funções para um pool de identidades. Essas funções serão usadas na execução de chamadas à ação GetCredentialsForIdentity	Write
SetPrincipalTagAttributeMap	Concede permissão para definir as principais etiquetas para um pool de identidades e provedor. Essas etiquetas serão usadas na execução de chamadas à ação GetOpenIdToken	Write
TagResource	Concede permissão para atribuir um conjunto de etiquetas a um pool de identidades do Amazon Cognito	Marcação	identitypool
				aws:RequestTag/${TagKey} aws:TagKeys
UnlinkDeveloperIdentity	Concede permissão para desvincular um DeveloperUserIdentifier de uma identidade existente	Write	identitypool*
UnlinkIdentity	Concede permissão para desvincular uma identidade federada de uma conta existente	Write
UntagResource	Concede permissão para remover as etiquetas especificadas de um pool de identidades do Amazon Cognito	Marcação	identitypool
				aws:TagKeys
UpdateIdentityPool	Concede permissão para atualizar um pool de identidades	Write	identitypool*

Tipos de recursos definidos pelo Amazon Cognito Identity

Os seguintes tipos de recursos são definidos por este serviço e podem ser usados no elemento Resource de declarações de políticas de permissão do IAM. Cada ação na Tabela de ações identifica os tipos de recursos que podem ser especificados com essa ação. Um tipo de recurso também pode definir quais chaves de condição você pode incluir em uma política. Essas chaves são exibidas na última coluna da tabela Tipos de recursos. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de tipos de recursos.

Tipos de recursos	ARN	Chaves de condição
identitypool	arn:${Partition}:cognito-identity:${Region}:${Account}:identitypool/${IdentityPoolId}	aws:ResourceTag/${TagKey}

Chaves de condição do Amazon Cognito Identity

O Amazon Cognito Identity define as seguintes chaves de condição que podem ser usadas no elemento Condition de uma política do IAM. É possível usar essas chaves para refinar ainda mais as condições sob as quais a declaração de política se aplica. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de chaves de condição.

Para visualizar as chaves de condição globais disponíveis para todos os serviços, consulte Chaves de condição globais disponíveis.

Chaves de condição	Descrição	Type
aws:RequestTag/${TagKey}	Filtra ações com base na presença de pares de chave-valor da etiqueta na solicitação	String
aws:ResourceTag/${TagKey}	Filtra ações com base nos pares de chave-valor da etiqueta anexados ao recurso	String
aws:TagKeys	Filtra o acesso por uma chave presente na solicitação	ArrayOfString