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á.
| Aplica-se a: Enterprise Edition |
| Público-alvo: QuickSight desenvolvedores da Amazon |
Existem apenas algumas etapas envolvidas no processo real de incorporação de análises usando o. QuickSight APIs
Antes de começar, certifique-se de ter os seguintes itens em vigor:
-
Configure as permissões necessárias do IAM para a identidade do chamador usada pelo seu aplicativo que usará o AWS SDK para fazer chamadas de API. Por exemplo, conceda permissão para possibilitar a ação
quicksight:GenerateEmbedUrlForAnonymousUserouquicksight:GenerateEmbedUrlForRegisteredUser. -
Para incorporar para usuários registrados, compartilhe QuickSight ativos com eles com antecedência. Para novos usuários autenticados, saiba como conceder acesso aos ativos. Uma forma de fazer isso é adicionar todos os ativos a uma QuickSight pasta. Se você preferir usar a QuickSight API, use as operações
UpdateDashboardPermissionsda APIDescribeDashboardPermissionse. Para obter mais informações, consulte DescribeDashboardPermissionsou UpdateDashboardPermissionsna Amazon QuickSight API Reference. Se desejar compartilhar o painel com todos os usuários em um namespace ou em um grupo, você poderá compartilhar o painel comnamespaceou comgroup. -
Se você estiver realizando a incorporação de painéis, certifique-se de ter o ID dos painéis que deseja incorporar. O ID do painel corresponde ao código no URL do painel. Também é possível obtê-lo no URL do painel.
-
Um QuickSight administrador deve habilitar explicitamente os domínios nos quais você planeja incorporar suas análises. QuickSight Você pode fazer isso usando o Gerenciar QuickSight, Domínios e Incorporação no menu do perfil ou pode usar o
AllowedDomainsparâmetro de uma chamada deGenerateEmbedUrlForRegisteredUserAPIGenerateEmbedUrlForAnonymousUserou API.Essa opção só é visível para QuickSight administradores. Você também pode adicionar subdomínios como parte de um domínio. Para obter mais informações, consulte Permitir listar domínios em tempo de execução com a API QuickSight .
Todos os domínios na sua lista de permissões estáticas (como desenvolvimento, preparação e produção) devem ser permitidos explicitamente e devem usar HTTPS. Você pode adicionar até cem domínios à lista de permissões. Você pode adicionar domínios em tempo de execução com operações de QuickSight API.
Depois que todos os pré-requisitos estiverem concluídos, a incorporação QuickSight envolve as seguintes etapas, que serão explicadas com mais detalhes posteriormente:
-
Para a autenticação, use o servidor de aplicações para autenticar o usuário. Após a autenticação em seu servidor, gere a URL do painel incorporado usando o AWS SDK de que você precisa.
-
Em seu portal ou aplicativo da web, incorpore QuickSight usando a URL gerada. Para simplificar esse processo, você pode usar o Amazon QuickSight Embedding SDK, disponível no NPMJS
e. GitHub Esse JavaScript SDK personalizado foi projetado para ajudar você a se QuickSight integrar com eficiência às páginas do seu aplicativo, definir padrões, conectar controles, obter retornos de chamada e lidar com erros.
Você pode usar registros AWS CloudTrail de auditoria para obter informações sobre o número de painéis incorporados, usuários de uma experiência incorporada e taxas de acesso.
Tópicos
Incorporando QuickSight painéis da Amazon com a API QuickSight
Incorporando QuickSight imagens da Amazon com o QuickSight APIs
Incorporando a funcionalidade completa do QuickSight console da Amazon para usuários registrados
Incorporando o Amazon Q na experiência QuickSight generativa de perguntas e respostas
Incorporando a barra de pesquisa do Amazon QuickSight Q (Classic)
Incorporando análises usando o GetDashboardEmbedURL and GetSessionEmbedURL Operações de API
