Políticas do Amazon QuickSight (baseadas em identidade)

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 QuickSight oferece suporte a ações, recursos e chaves de condição específicos. Para conhecer todos os elementos usados em uma política JSON, consulte Referência de elementos de política JSON do IAM no Guia do usuário do IAM.

Você pode usar credenciais raiz da AWS ou credenciais de usuário do IAM para criar uma conta do Amazon QuickSight. As credenciais raiz e de administrador da AWS já têm todas as permissões necessárias para gerenciar o acesso do Amazon QuickSight aos recursos da AWS.

No entanto, recomendamos que você proteja suas credenciais raiz usando as credenciais de usuário do IAM. Para isso, é possível criar uma política e anexá-la aos perfis e ao usuário do IAM que você planeja usar para o Amazon QuickSight. A política deve incluir as instruções adequadas para as tarefas administrativas do Amazon QuickSight que precisam ser executadas, conforme descrito nas seções a seguir.

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. As ações de políticas geralmente têm o mesmo nome que a operação de API da AWS 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.

As ações de política no Amazon QuickSight usam o seguinte prefixo antes da ação: quicksight:. Por exemplo, para conceder permissão a alguém para executar uma instância do Amazon EC2 com a operação da API RunInstances do Amazon EC2, inclua a ação ec2:RunInstances na política da pessoa. As instruções de política devem incluir um elemento Action ou NotAction. O Amazon QuickSight define seu próprio conjunto de ações que descrevem as tarefas que você pode executar com esse serviço.

Para especificar várias ações em uma única instrução, separe-as com vírgulas, como segue:

"Action": [
	      "quicksight:action1",
	      "quicksight: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 Create, inclua a seguinte ação:

"Action": "quicksight:Create*"

O Amazon QuickSight fornece várias ações do AWS Identity and Access Management (IAM). Todas as ações do Amazon QuickSight são prefixadas com quicksight:, como quicksight:Subscribe. Para obter informações sobre como usar as ações do Amazon QuickSight em uma política do IAM, consulte Exemplos de políticas do IAM para o Amazon QuickSight.

Para ver a lista mais atualizada das ações do Amazon QuickSight, consulte Actions Defined by Amazon QuickSight no Guia do usuário 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. 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": "*"

Veja abaixo um exemplo de política. Isso significa que o autor da chamada com essa política vinculada pode invocar a operação CreateGroupMembership em qualquer grupo, desde que o nome do usuário que ele está adicionando ao grupo não seja user1.

{
    "Effect": "Allow",
    "Action": "quicksight:CreateGroupMembership",
    "Resource": "arn:aws:quicksight:us-east-1:aws-account-id:group/default/*",
    "Condition": {
        "StringNotEquals": {
            "quicksight:UserName": "user1"
        }
    }
}

Algumas ações do Amazon QuickSight, como as usadas 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": "*"

Algumas ações da API do envolvem vários recursos. Para especificar vários recursos em uma única declaração, separe os ARNs com vírgulas.

"Resource": [
	      "resource1",
	      "resource2"

Para ver uma lista dos tipos de recursos do Amazon QuickSight e seus nomes do recurso da Amazon (ARNs), consulte Resources Defined by Amazon QuickSight no Guia do usuário do IAM. Para saber com quais ações você pode especificar o ARN de cada recurso, consulte Actions Defined by Amazon QuickSight.

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 (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, a AWS avaliará a condição usando uma operação lógica OR. 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.

A AWS oferece compatibilidade com chaves de condição globais e chaves de condição específicas do serviç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 QuickSight não fornece nenhuma chave de condição específica ao serviço, mas oferece suporte ao uso de algumas chaves de condição globais. 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.

Exemplos

Para visualizar exemplos de políticas baseadas em identidade do Amazon QuickSight, consulte Políticas baseadas em identidade do IAM para o Amazon QuickSight.