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á.
# Criação de um perfil de permissões personalizado no Amazon Quick
| |
| --- |
| Aplica-se a: Enterprise Edition |
| |
| --- |
| Público-alvo: administradores e desenvolvedores do Amazon Quick |
Na edição Enterprise, você pode restringir a funcionalidade que as pessoas podem acessar no Amazon Quick. Você pode configurar permissões personalizadas nos níveis de conta, função (administrador, autor, leitor) e usuário para todos os tipos de identidade no Quick. As *permissões personalizadas em nível de usuário* substituem as permissões de nível de perfil padrão ou personalizadas existentes de um perfil de um usuário específico. As *permissões personalizadas em nível do usuário* e as *permissões personalizadas em nível de perfil* substituem as *permissões personalizadas em nível de conta*.
As limitações a seguir se aplicam às permissões personalizadas.
+ Não é possível conceder permissões que excedam o nível do perfil padrão atribuído ao usuário. Por exemplo, se um usuário tiver acesso de leitor, você não poderá conceder permissões para que esse usuário edite painéis.
+ Para personalizar as permissões de usuário ou função, você precisa ser um administrador do Amazon Quick com as seguintes permissões do IAM:
+ `quicksight:CreateCustomPermissions`
+ `quicksight:DeleteCustomPermissions`
+ `quicksight:DescribeCustomPermissions`
+ `quicksight:ListCustomPermissions`
+ `quicksight:UpdateCustomPermissions`
+ `quicksight:DescribeAccountCustomPermissions`
+ `quicksight:UpdateAccountCustomPermissions`
+ `quicksight:DeleteAccountCustomPermissions`
Você pode criar perfis de permissão personalizados para restringir o acesso a qualquer combinação dos seguintes recursos. Os recursos principais podem ser usados para restringir o acesso aos conjuntos de recursos de um ativo inteiro. Quando os recursos dos pais são desativados, todos os recursos associados aos filhos também serão desativados.
Recursos sem recursos principais não podem ser desativados com esse mecanismo. Em vez disso, eles devem ser restritos como recursos individuais.
## Capacidades rápidas para pais
| Capacidade dos pais | Funcionalidade |
| --- | --- |
| Análises | Restringe todos os recursos relacionados à análise |
| Painéis | Restringe todos os recursos relacionados aos painéis |
| Ações | Restringe todos os recursos relacionados às ações |
| Automatize | Restringe todos os recursos relacionados à automação |
| Agentes de bate-papo | Restringe todos os recursos relacionados ao Chat Agent |
| Extensões | Restringe todos os recursos relacionados às extensões |
| Fluxos | Restringe todos os recursos relacionados ao Flows |
| Base de conhecimento | Restringe todos os recursos relacionados à Base de Conhecimento |
| Pesquisa | Restringe todos os recursos relacionados à pesquisa |
| Cenários | Restringe todos os recursos relacionados ao Scenarios |
| Espaços | Restringe todos os recursos relacionados ao Spaces |
| Histórias | Restringe todos os recursos relacionados ao Stories |
| Tópicos | Restringe todos os recursos relacionados aos tópicos |
## Funcionalidades rápidas
| Recurso | Comportamento do Amazon Quick | Capacidade dos pais |
| --- | --- | --- |
| Crie agentes de bate-papo | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Agentes de bate-papo |
| Compartilhar agentes de bate-papo | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Agentes de bate-papo |
| Permita que os criadores compartilhem sem aprovação | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Fluxos |
| Use modelos Bedrock para refinamento de saída | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Fluxos |
| Habilite o agente de interface do usuário para realizar tarefas do navegador | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Fluxos |
| Todos os usuários qualificados podem revisar e aprovar as solicitações de compartilhamento do Flows | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Fluxos |
| Crie espaços | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Espaços |
| Compartilhe espaços | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Espaços |
| Use a internet para melhorar os resultados | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Compartilhamento de análises | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Análises |
| Adicionar ou executar a detecção de anomalias | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Análises |
| Folha de impressão | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Exportar planilha para PDF | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Criação ou atualização de temas | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Compartilhar painéis | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Painel |
| Exportar imagens visuais para CSV | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Exportar imagens visuais para o Excel | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Criação ou atualização de todos os conjuntos de dados | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Criando ou atualizando somente conjuntos de dados do SPICE | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Compartilhar conjuntos de dados | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Visualizando a capacidade do SPICE da conta | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Criação ou atualização de todas as fontes de dados | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Compartilhamento de fontes de dados | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Gerenciando pastas compartilhadas | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Criação de pastas compartilhadas | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Gerenciando pastas compartilhadas |
| Renomeando pastas compartilhadas | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Gerenciando pastas compartilhadas |
| Criação ou atualização de relatórios de e-mail agendados | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Inscrever-se para receber relatórios de e-mail agendados | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Painel |
| Anexos CSV em relatórios de e-mail agendados | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Anexos do Excel em relatórios de e-mail agendados | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Anexos em PDF em relatórios de e-mail agendados | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Conteúdo em relatórios de e-mail agendados | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Criação ou atualização de alertas de limite | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | -- |
| Edite imagens visuais com IA | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Análises |
| Crie cálculos com IA | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Análises |
| Criar resumo executivo | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Painéis |
| Criação ou atualização de todas as bases de conhecimento | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Base de conhecimento |
| Compartilhe todas as bases de conhecimento | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/create-custom-permissions-profile.html) | Base de conhecimento |
## Características do conector de ação
Além dos recursos listados nas seções anteriores, você pode restringir o acesso a conectores de ação individuais. Cada conector de ação oferece suporte às seguintes permissões:
+ **Ação de criação e atualização** — restringe a capacidade de criar ou atualizar ações para o conector.
+ **Ação de compartilhamento** — restringe a capacidade de compartilhar ações para o conector.
+ **Usar ação** — restringe a capacidade de usar ações para o conector.
Essas permissões estão disponíveis na guia **Conectores de ação** do perfil de permissões personalizado. Para obter uma lista dos conectores de ação disponíveis, consulte Conectores de [ação](https://docs.aws.amazon.com/quick/latest/userguide/action-integrations.html).
Perfis de permissões personalizados podem ser criados para contas do Amazon Quick integradas ao IAM Identity Center, ao Active Directory ou para contas do Amazon Quick que tenham usuários gerenciados pelo Amazon Quick. O tipo de identidade que uma conta do Amazon Quick usa determina a forma como um administrador do Amazon Quick configura um perfil de permissões personalizado.
O procedimento a seguir mostra como controlar o acesso aos recursos do Amazon Quick e aos respectivos recursos.
**Para controlar o acesso aos recursos e recursos do Amazon Quick**
1. Faça login no console do Amazon Quick.
1. Selecione **Gerenciar rápido**.
1. No menu de navegação esquerdo do Admin Console, selecione **Permissões** e, em seguida, selecione **Permissões personalizadas**.
1. Em **Permissões personalizadas**, em **Perfis**, selecione **Novo perfil** ou escolha editar o perfil padrão.
1. Em **Novo perfil**, faça o seguinte:
+ Em **Restringir recursos** — Escolha se deseja permitir recursos específicos para seu sistema marcando ou desmarcando as opções apropriadas.
+ Em **Restringir recursos** — Escolha se deseja permitir recursos específicos marcando ou desmarcando as opções apropriadas.
## Criação de um perfil de permissões personalizado para uma conta Amazon Quick integrada ao IAM Identity Center ou ao Active Directory
Os administradores de contas do Amazon Quick podem usar o procedimento a seguir para criar um perfil de permissões personalizado para uma conta do Amazon Quick integrada ao IAM Identity Center ou ao Active Directory.
**Para criar um perfil de permissões personalizado para uma conta Amazon Quick integrada ao IAM Identity Center ou ao Active Directory**
1. Faça login no [Console de gerenciamento da AWS](https://aws.amazon.com//console).
1. Abra o Amazon Quick.
1. O console do Amazon Quick Admin é aberto. Escolha **Permissões personalizadas**.
1. A página **Gerenciar permissões personalizadas** é aberta. Escolha uma das seguintes opções.
+ Para criar um novo perfil de permissões personalizadas, escolha **Criar**.
+ **Para editar ou visualizar um perfil de permissões personalizado existente, escolha as reticências (três pontos) ao lado do perfil que você deseja e, em seguida, escolha Editar.**
1. Se você quiser criar ou atualizar um perfil de permissões personalizadas, faça seleções para os itens a seguir.
+ Em **Nome**, insira um nome para o seu perfil de permissões personalizadas.
+ Em **Restrições**, escolha as opções que você deseja negar. Qualquer opção que você não escolher é permitida. Por exemplo, se você não quiser que os usuários criem ou atualizem fontes de dados, mas queira que eles possam fazer todo o resto, escolha somente **Criar ou atualizar fontes de dados**.
1. Selecione **Criar** ou **Atualizar** para confirmar suas escolhas. Para voltar sem fazer nenhuma alteração, escolha **Voltar**.
1. Depois de fazer as alterações, registre o nome do perfil de permissões personalizadas. Forneça o nome do perfil de permissões personalizadas aos usuários da API para que eles possam aplicar o perfil de permissões personalizadas aos perfis ou aos usuários.
## Criação de um perfil de permissões personalizado para uma conta do Amazon Quick que usa usuários gerenciados do Amazon Quick
Os administradores de contas do Amazon Quick podem usar o procedimento a seguir para criar um perfil de permissões personalizado para uma conta do Amazon Quick que usa usuários gerenciados pelo Amazon Quick.
**Para criar um perfil de permissões personalizado para usuários gerenciados do Amazon Quick**
1. Abra o [console do Quick](https://quicksight.aws.amazon.com/).
1. Em qualquer página no console do Amazon Quick, escolha **Manage Quick** no canto superior direito.
Somente administradores do Amazon Quick têm acesso à opção de menu **Gerenciar Rápido**. Se você não tiver acesso ao menu **Manage Quick**, entre em contato com o administrador do Amazon Quick para obter ajuda.
1. Escolha **Permissões personalizadas**. Você também pode escolher a seção **Gerenciar usuários** e, em seguida, escolher **Gerenciar permissões personalizadas**.
1. A página **Gerenciar permissões personalizadas** é aberta. Escolha uma das seguintes opções.
+ Para criar um novo perfil de permissões personalizadas, escolha **Criar**.
+ **Para editar ou visualizar um perfil de permissões personalizado existente, escolha as reticências (três pontos) ao lado do perfil que você deseja e, em seguida, escolha Editar.**
1. Se você quiser criar ou atualizar um perfil de permissões personalizadas, faça seleções para os itens a seguir.
+ Em **Nome**, insira um nome para o seu perfil de permissões personalizadas.
+ Em **Restrições**, escolha as opções que você deseja negar. Qualquer opção que você não escolher é permitida. Por exemplo, se você não quiser que os usuários criem ou atualizem fontes de dados, mas concorda que façam qualquer outra coisa, selecione apenas **Criar ou atualizar fontes de dados**.
1. Selecione **Criar** ou **Atualizar** para confirmar suas escolhas. Para voltar sem fazer nenhuma alteração, escolha **Voltar**.
1. Depois de fazer as alterações, registre o nome do perfil de permissões personalizadas. Forneça o nome do perfil de permissões personalizadas aos usuários da API para que eles possam aplicar o perfil de permissões personalizadas aos perfis ou aos usuários.
Depois de criar um perfil de permissões personalizado, use o Amazon Quick APIs para adicionar ou alterar o perfil de permissões personalizado atribuído a um usuário, função ou conta. Usuários com permissões suficientes também podem usar o [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-custompermissions.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-custompermissions.html) CloudFormation recurso para gerenciar perfis de permissões personalizados do Amazon Quick. Use os tópicos a seguir para saber mais sobre o gerenciamento de perfis de permissões personalizados com o Amazon Quick APIs.
+ [Aplique um perfil de permissões personalizado a uma função do Amazon Quick com a API Amazon Quick](https://docs.aws.amazon.com/quicksight/latest/user/customizing-permissions-to-the-quicksight-console-apply-role.html)
+ [Aplique um perfil de permissões personalizado a um usuário com a Amazon Quick API](https://docs.aws.amazon.com/quicksight/latest/user/customizing-permissions-to-the-quicksight-console-apply-iam-user.html)
## Aplique um perfil de permissões personalizado a uma função do Amazon Quick com a API Amazon Quick
Depois de criar um perfil de permissões personalizado, use o Amazon Quick APIs para adicionar ou alterar o perfil de permissões personalizado atribuído a uma função.
Antes de começar, você precisa instalar e configurar a AWS CLI. Para obter mais informações sobre a instalação da AWS CLI, consulte [Instalar ou atualizar a versão mais recente da CLI e Configurar a AWSAWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) [no Guia do](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) usuário. AWS Command Line Interface Você também precisa de permissões para usar a Amazon Quick API.
O exemplo a seguir chama a API `UpdateRoleCustomPermission` para atualizar as permissões personalizadas atribuídas a um perfil.
```
aws quicksight update-role-custom-permission \
--role ROLE \
--aws-account-id AWSACCOUNTID \
--namespace default \
--custom-permissions-name PERMISSIONNAME \
--region REGION
```
O exemplo a seguir retorna o perfil de permissões personalizadas atribuído a um perfil.
```
aws quicksight describe-role-custom-permission \
--role ROLE \
--aws-account-id AWSACCOUNTID \
--namespace default \
--region REGION
```
O exemplo a seguir exclui um perfil de permissões personalizadas de um perfil.
```
aws quicksight delete-role-custom-permission \
--role ROLE \
--aws-account-id AWSACCOUNTID \
--namespace default \
--region REGION
```
## Aplique um perfil de permissões personalizado a um usuário com a Amazon Quick API
O exemplo a seguir aplica um perfil de permissões personalizadas a um usuário.
```
aws quicksight update-user-custom-permission \
--aws-account-id AWSACCOUNTID \
--namespace default \
--user-name USER_NAME \
--custom-permissions-name myCustomPermission
```
O exemplo a seguir exclui um perfil de permissões personalizadas de um usuário.
```
aws quicksight delete-user-custom-permission \
--aws-account-id AWSACCOUNTID \
--namespace default
```
O exemplo a seguir adiciona permissões personalizadas a um novo usuário do Amazon Quick IAM.
```
aws quicksight register-user \
--iam-arn arn:aws:iam::AWSACCOUNTID:user/USER \
--identity-type IAM \
--user-role AUTHOR \
--custom-permissions-name custom-permissions-profile-name \
--email EMAIL \
--aws-account-id AWSACCOUNTID \
--namespace default \
```
Você também pode associar um usuário existente do IAM a um novo perfil de permissões. O exemplo a seguir atualizou o perfil de permissões personalizadas de um usuário existente do IAM.
```
aws quicksight update-user \
--user-name USERNAME \
--role AUTHOR \
--custom-permissions-name custom-permissions-profile-name \
--email EMAIL \
--aws-account-id AWSACCOUNTID \
--namespace default \
```
O exemplo abaixo remove um usuário existente de um perfil de permissões.
```
aws quicksight update-user \
--user-name USERNAME \
--role AUTHOR \
--unapply-custom-permissions \
--email EMAIL \
--aws-account-id AWSACCOUNTID \
--namespace default
```
Para testar as permissões personalizadas aplicadas a um perfil ou usuário, faça login na conta do usuário. Quando um usuário faz login no Amazon Quick, ele recebe o maior privilégio ao qual tem acesso. O perfil privilegiado mais alto que um usuário pode receber é o de administrador. O menor papel privilegiado que um usuário pode receber é o de Leitor. Para obter mais informações sobre funções no Amazon Quick, consulte [Gerenciamento do acesso de usuários dentro do Amazon Quick](https://docs.aws.amazon.com/quicksight/latest/user/managing-users.html).
Se você atribuir um perfil de permissões personalizadas que restringe o compartilhamento da fonte de dados ao perfil do autor, esse autor não poderá mais acessar os controles que permitem o compartilhamento da fonte de dados. Em vez disso, o autor afetado tem permissões somente de visualização na fonte de dados.
## Aplicar um perfil de permissões personalizadas a uma conta
**Para aplicar um perfil de permissões personalizadas a uma conta**
1. Abra o [console do Quick](https://quicksight.aws.amazon.com/).
1. No canto superior direito, escolha o ícone do perfil.
1. Escolha **Gerenciar rápido**. Somente administradores do Amazon Quick poderão visualizar esta página.
1. Escolha **Permissões personalizadas**. Você também pode escolher a seção **Gerenciar usuários** e, em seguida, escolher **Gerenciar permissões personalizadas** se sua conta do Quick usar usuários gerenciados rapidamente.
1. Localize a permissão personalizada da conta desejada. No menu de opções, em **Ações**, escolha **Definir como perfil de conta**.
### Aplique um perfil de permissões personalizado a uma conta usando o Quick APIs
Depois de criar um perfil de permissões personalizado, use a API rápida para adicionar ou alterar o perfil de permissões personalizado atribuído a uma conta.
Antes de começar, você precisará instalar e configurar a AWS CLI. Para obter mais informações sobre a instalação da AWS CLI, consulte [Instalar ou atualizar a versão mais recente da CLI e Configurar a AWSAWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) [no guia do usuário da](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) interface de linha de comando. AWS Você também precisa das seguintes permissões do IAM: `quicksight:UpdateAccountPermission`, `quicksight:DescribeAccountPermission` e `quicksight:DeleteAccountCustomPermission`.
O exemplo a seguir chama a API `UpdateAccountPermission` para atualizar as permissões personalizadas atribuídas a uma conta.
```
aws quicksight update-account-custom-permission \
--aws-account-id AWSACCOUNTID \
--custom-permissions-name PERMISSIONNAME \
--region REGION
```
O exemplo a seguir retorna o perfil de permissões personalizadas atribuído a uma conta.
```
aws quicksight describe-account-custom-permission \
--aws-account-id AWSACCOUNTID \
--region REGION
```
O exemplo a seguir cancela a aplicação de um perfil de permissões personalizadas de uma conta.
```
aws quicksight delete-account-custom-permission \
--aws-account-id AWSACCOUNTID \
--region REGION
```