Usando a Amazon QuickSight com IAM - Amazon QuickSight
QuickSight Políticas da Amazon QuickSightPolíticas da Amazon (baseadas em recursos)Autorização baseada em QuickSight tags da Amazon QuickSight IAMFunções na AmazonPassando IAM funções para QuickSight

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á.

Usando a Amazon QuickSight com IAM

   Aplica-se a: Enterprise Edition e Standard Edition 
   Público-alvo: administradores de sistemas 

Antes de usar IAM para gerenciar o acesso à Amazon QuickSight, você deve entender quais IAM recursos estão disponíveis para uso com a Amazon QuickSight. Para obter uma visão de alto nível de como a Amazon QuickSight e outros AWS serviços funcionam comIAM, consulte AWS Serviços que funcionam com IAM no Guia do IAM usuário.

QuickSight Políticas da Amazon (baseadas em identidade)

Com políticas IAM baseadas em identidade, você pode especificar ações e recursos permitidos ou negados, bem como as condições sob as quais as ações são permitidas ou negadas. A Amazon QuickSight oferece suporte a ações, recursos e chaves de condição específicos. Para saber mais sobre todos os elementos que você usa em uma JSON política, consulte Referência IAM JSON de elementos de política no Guia do IAM usuário.

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

No entanto, recomendamos que você proteja suas credenciais raiz e, em vez disso, use as credenciais IAM do usuário. Para fazer isso, você pode criar uma política e anexá-la ao IAM usuário e às funções que planeja usar na Amazon QuickSight. A política deve incluir as declarações apropriadas para as tarefas QuickSight administrativas da Amazon que você precisa realizar, conforme descrito nas seções a seguir.

Importante

Esteja ciente do seguinte ao trabalhar com a Amazon QuickSight e IAM as políticas:

  • Evite modificar diretamente uma política criada pela Amazon QuickSight. Quando você mesmo o modifica, a Amazon não QuickSight pode editá-lo. Essa incapacidade pode causar um problema com a política. Para corrigir o problema, exclua a política modificada anteriormente.

  • Se você receber um erro nas permissões ao tentar criar uma QuickSight conta da Amazon, consulte Ações definidas pela Amazon QuickSight no Guia do IAM usuário.

  • Em alguns casos, você pode ter uma QuickSight conta da Amazon que não consegue acessar nem mesmo da conta raiz (por exemplo, se você excluiu acidentalmente o serviço de diretório). Nesse caso, você pode excluir sua QuickSight conta antiga da Amazon e recriá-la. Para obter mais informações, consulte Excluindo sua QuickSight assinatura da Amazon e fechando a conta.

Ações

Os administradores podem usar AWS JSON políticas 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 Action elemento de uma JSON política descreve as ações que você pode usar para permitir ou negar acesso em uma política. As ações de política geralmente têm o mesmo nome da AWS API operação associada. Há algumas exceções, como ações somente de permissão que não têm uma operação correspondente. API 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 políticas na Amazon QuickSight usam o seguinte prefixo antes da ação:quicksight:. Por exemplo, para conceder permissão a alguém para executar uma EC2 instância da Amazon com a EC2 RunInstances API operação da Amazon, você inclui a ec2:RunInstances ação na política dessa pessoa. As instruções de política devem incluir um elemento Action ou NotAction. A Amazon QuickSight define seu próprio conjunto de ações que descrevem tarefas que você pode realizar 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*"

QuickSight A Amazon fornece várias AWS Identity and Access Management (IAM) ações. Todas as QuickSight ações da Amazon são prefixadas comquicksight:, comoquicksight:Subscribe. Para obter informações sobre o uso QuickSight das ações da Amazon em uma IAM política, consulteIAMexemplos de políticas para a Amazon QuickSight.

Para ver a maior up-to-date lista de QuickSight ações da Amazon, consulte Ações definidas pela Amazon QuickSight no Guia IAM do usuário.

Recursos

Os administradores podem usar AWS JSON políticas 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 Resource JSON de política especifica o objeto ou 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 Amazon Resource Name (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 QuickSight ações da Amazon, como aquelas para criar recursos, não podem ser executadas em um recurso específico. Nesses casos, você deve utilizar o caractere curinga (*).

"Resource": "*"

Algumas API ações envolvem vários recursos. 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 QuickSight recursos da Amazon e seus nomes de recursos da Amazon (ARNs), consulte Recursos definidos pela Amazon QuickSight no Guia IAM do usuário. Para saber com quais ações você pode especificar cada recurso, consulte Ações definidas pela Amazon QuickSight. ARN

Chaves de condição

Os administradores podem usar AWS JSON políticas 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 Condition em uma instrução ou várias chaves em um único Condition elemento, 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, você pode conceder permissão a um IAM usuário para acessar um recurso somente se ele estiver marcado com o nome de IAM usuário. Para obter mais informações, consulte elementos de IAM política: variáveis e tags no Guia IAM do usuário.

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 IAM do usuário.

QuickSight A Amazon não fornece nenhuma chave de condição específica do serviço, mas oferece suporte ao uso de algumas chaves de condição globais. Para ver todas as chaves de condição AWS globais, consulte Chaves de contexto de condição AWS global no Guia IAM do usuário.

Exemplos

Para ver exemplos de políticas QuickSight baseadas em identidade da Amazon, consulte. IAMpolíticas baseadas em identidade para a Amazon QuickSight

QuickSightPolíticas da Amazon (baseadas em recursos)

A Amazon QuickSight não oferece suporte a políticas baseadas em recursos. No entanto, você pode usar o QuickSight console da Amazon para configurar o acesso a outros AWS recursos no seu Conta da AWS.

Autorização baseada em QuickSight tags da Amazon

QuickSight A Amazon não oferece suporte à marcação de recursos nem ao controle de acesso com base em tags.

QuickSight IAMFunções na Amazon

Uma IAMfunção é uma entidade dentro da sua AWS conta que tem permissões específicas. Você pode usar IAM funções para agrupar permissões para facilitar o gerenciamento do acesso do usuário às QuickSight ações da Amazon.

A Amazon QuickSight não oferece suporte aos seguintes recursos de função:

  • Perfis vinculados ao serviço.

  • Funções de serviço.

  • Credenciais temporárias (uso direto): no entanto, a Amazon QuickSight usa credenciais temporárias para permitir que os usuários assumam uma IAM função para acessar painéis incorporados. Para obter mais informações, consulte Trabalhar com análise incorporada.

Para obter mais informações sobre como a Amazon QuickSight usa IAM funções, consulte Usando a Amazon QuickSight com IAM IAMexemplos de políticas para a Amazon QuickSight e.

Transferência de IAM funções para a Amazon QuickSight

 Aplica-se a: Enterprise Edition 

Quando seus IAM usuários se cadastram na Amazon QuickSight, eles podem escolher usar a função QuickSight gerenciada (essa é a função padrão). Ou eles podem passar uma IAM função existente para QuickSight o.

Pré-requisitos

Para que seus usuários passem IAM funções QuickSight, seu administrador precisa concluir as seguintes tarefas:

  • Crie uma IAM função. Para obter mais informações sobre a criação de IAM funções, consulte Criação de IAM funções no Guia IAM do usuário.

  • Anexe uma política de confiança à sua IAM função que QuickSight permita assumir a função. Use o exemplo a seguir para criar uma política de confiança para o perfil. O exemplo de política de confiança a seguir permite que o QuickSight diretor da Amazon assuma a IAM função à qual está vinculado.

    Para obter mais informações sobre como criar políticas de IAM confiança e anexá-las às funções, consulte Modificar uma função (console) no Guia do IAMusuário.

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "quicksight.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

  • Atribua as seguintes IAM permissões ao seu administrador (IAMusuários ou funções):

    • quicksight:UpdateResourcePermissions— Isso concede IAM aos usuários que são QuickSight administradores a permissão para atualizar as permissões em nível de recurso no. QuickSight Para obter mais informações sobre os tipos de recursos definidos por QuickSight, consulte Ações, recursos e chaves de condição para a Amazon QuickSight no Guia IAM do usuário.

    • iam:PassRole— Isso concede aos usuários permissão para passar funções para QuickSight o. Para obter mais informações, consulte Conceder permissões a um usuário para passar uma função para um AWS serviço no Guia do IAM usuário.

    • iam:ListRoles— (Opcional) Isso concede aos usuários permissão para ver uma lista das funções existentes em QuickSight. Se essa permissão não for fornecida, eles poderão usar an ARN para usar IAM funções existentes.

    A seguir está um exemplo de política de IAM permissões que permite gerenciar permissões em nível de recursos, listar IAM funções e passar funções IAM na Amazon. QuickSight

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iam:ListRoles",
            "Resource": "arn:aws:iam::account-id:role:*"
        },
        {
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": "arn:aws:iam::account-id:role/path/role-name",
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": [
                        "quicksight.amazonaws.com"
                    ]
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "quicksight:UpdateResourcePermissions",
            "Resource": "*"
        }
    ]
}

    Para obter mais exemplos de IAM políticas que você pode usar com QuickSight, consulteIAMexemplos de políticas para a Amazon QuickSight.

Para obter mais informações sobre como atribuir políticas de permissões a usuários ou grupos de usuários, consulte Alteração de permissões para um IAM usuário no Guia do IAM usuário.

Depois que o administrador concluir os pré-requisitos, seus IAM usuários poderão passar funções para o. IAM QuickSight Eles fazem isso escolhendo uma IAM função ao se QuickSight inscreverem ou switching to an IAM role na página QuickSight Segurança e Permissões. Para saber como mudar para uma IAM função existente no QuickSight, consulte a seção a seguir.

Anexar políticas adicionais

Se você estiver usando outro AWS serviço, como o Amazon Athena ou o Amazon S3, poderá criar uma política de permissões que QuickSight conceda permissão para realizar ações específicas. Em seguida, você pode anexar a política às IAM funções para as quais você passará posteriormente QuickSight. Veja a seguir exemplos de como você pode configurar e anexar políticas de permissões adicionais às suas IAM funções.

Para ver um exemplo de política gerenciada para QuickSight o Athena, consulte Política AWSQuicksightAthenaAccess gerenciada no Guia do usuário do Amazon Athena. IAMos usuários podem acessar essa função QuickSight usando o seguinteARN:arn:aws:iam::aws:policy/service-role/AWSQuicksightAthenaAccess.

A seguir está um exemplo de uma política de permissões para o QuickSight Amazon S3. Para obter mais informações sobre o uso IAM com o Amazon S3, consulte Gerenciamento de identidade e acesso no Amazon S3 no Guia do usuário do Amazon S3.

Para obter informações sobre como criar acesso entre contas QuickSight a partir de um bucket do Amazon S3 em outra conta, consulte Como faço para configurar o acesso entre contas da Amazon a um bucket do QuickSight Amazon S3 em outra conta? no Centro de AWS Conhecimento.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "s3:ListAllMyBuckets",
            "Resource": "arn:aws:s3:::*"
        },
        {
            "Action": [
                "s3:ListBucket"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:s3:::aws-athena-query-results-us-west-2-123456789"
            ]
        },
        {
            "Action": [
                "s3:GetObject",
                "s3:GetObjectVersion"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:s3:::aws-athena-query-results-us-west-2-123456789/*"
            ]
        },
        {
            "Action": [
                "s3:ListBucketMultipartUploads",
                "s3:GetBucketLocation"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:s3:::aws-athena-query-results-us-west-2-123456789"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:AbortMultipartUpload",
                "s3:ListMultipartUploadParts"
            ],
            "Resource": [
                "arn:aws:s3:::aws-athena-query-results-us-west-2-123456789/*"
            ]
        }
    ]
}

Usando IAM funções existentes na Amazon QuickSight

Se você for QuickSight administrador e tiver permissões para atualizar QuickSight recursos e passar IAM funções, poderá usar as IAM funções existentes no QuickSight. Para saber mais sobre os pré-requisitos para a aprovação de IAM funções QuickSight, consulte o prerequisites descrito na lista anterior.

Use o procedimento a seguir para aprender como transferir IAM funções QuickSight.

Para usar uma IAM função existente no QuickSight

  1. Em QuickSight, escolha o nome da sua conta na barra de navegação no canto superior direito e escolha Gerenciar QuickSight.

  2. Na QuickSight página Gerenciar que se abre, escolha Segurança e permissões no menu à esquerda.

  3. Na página Segurança e Permissões que se abre, em QuickSight Acesso aos AWS serviços, escolha Gerenciar.

  4. Para IAMfunção, escolha Usar uma função existente e, em seguida, faça o seguinte:

    • Selecione na lista o perfil que você deseja usar.

    • Ou, se você não vê uma lista de IAM funções existentes, você pode inserir o IAM ARN para a função no seguinte formato:arn:aws:iam::account-id:role/path/role-name.

  5. Escolha Salvar.