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á.
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ções específicos do serviço para uso em políticas de permissão. IAM
Referências:
-
Saiba como configurar este serviço.
-
Veja uma lista das APIoperações disponíveis para esse serviço.
-
Saiba como proteger esse serviço e seus recursos usando políticas de IAM permissão.
Tópicos
Ações definidas pelo Amazon Cognito Identity
Você pode especificar as seguintes ações no Action elemento de uma declaração de IAM política. Use políticas para conceder permissões para executar uma operação na AWS. Quando você usa uma ação em uma política, geralmente permite ou nega acesso à API operação ou ao CLI comando 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 declaraçã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 Resource elemento em uma IAM política, deverá incluir um padrão ARN ou 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 | |||
| 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 | |||
| 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 | |||
| 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 | Escrever | |||
| GetIdentityPoolAnalytics | Concede permissão para obter dados analíticos sobre a contagem total de identidades atual de todos os provedores de identidade do pool de identidades (IdPs) | Leitura | |||
| GetIdentityPoolDailyAnalytics | Concede permissão para obter dados analíticos sobre o número de novas identidades e o total de identidades para todos os provedores de identidade do pool de identidades () IdPs | Leitura | |||
| GetIdentityPoolRoles | Concede permissão para obter as funções de um pool de identidades | Leitura | |||
| GetIdentityProviderDailyAnalytics | Concede permissão para obter dados analíticos sobre o número de novas identidades e o total de identidades de um provedor de identidade do grupo de identidades () IdPs | Leitura | |||
| GetOpenIdToken | Concede permissão para obter um token OpenID, usando um ID conhecido do Cognito | Leitura | |||
| GetOpenIdTokenForDeveloperIdentity | Concede permissão para registrar (ou recuperar) um token do IdentityId Cognito e do OpenID Connect para um usuário autenticado pelo seu processo de autenticação de back-end | Leitura | |||
| GetPrincipalTagAttributeMap | Concede permissão para obter as principais etiquetas para um pool de identidades e provedor | Read | |||
| ListIdentities | Concede permissão para listar as identidades de um pool de identidades | List | |||
| 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 | Leitura | |||
| LookupDeveloperIdentity | Concede permissão para recuperar o IdentityId associado a uma DeveloperUserIdentifier ou a lista de DeveloperUserIdentifiers associados a uma IdentityId para uma identidade existente | Leitura | |||
| MergeDeveloperIdentities | Concede permissão para mesclar dois usuários diferentes IdentityIds, existentes no mesmo grupo de identidades e identificados pelo mesmo provedor de desenvolvedores | Escrever | |||
| SetIdentityPoolRoles | Concede permissão para definir as funções para um pool de identidades. Essas funções são usadas ao fazer chamadas à GetCredentialsForIdentity ação. | Escrever | |||
| SetPrincipalTagAttributeMap | Concede permissão para definir as principais etiquetas para um pool de identidades e provedor. Essas tags são usadas ao fazer chamadas à GetOpenIdToken ação. | Escrever | |||
| TagResource | Concede permissão para atribuir um conjunto de etiquetas a um pool de identidades do Amazon Cognito | Tags | |||
| UnlinkDeveloperIdentity | Concede permissão para desvincular DeveloperUserIdentifier a de uma identidade existente | Escrever | |||
| 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 | |||
| UpdateIdentityPool | Concede permissão para atualizar um pool de identidades | Write |
Tipos de recursos definidos pelo Amazon Cognito Identity
Os tipos de recursos a seguir são definidos por esse serviço e podem ser usados no Resource elemento das declarações de política de IAM permissão. 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}
|
Chaves de condição do Amazon Cognito Identity
O Amazon Cognito Identity define as seguintes chaves de condição que podem ser usadas no Condition elemento de uma IAM política. É 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 ver as chaves de condição globais que estão 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 |
