Incorporação com as APIs QuickSight - Amazon 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á.

Incorporação com as APIs QuickSight

 Aplica-se a: Enterprise Edition 
   Público-alvo: QuickSight desenvolvedores da Amazon 

Há apenas algumas etapas envolvidas no processo real de incorporação de análises usando as 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:GenerateEmbedUrlForAnonymousUser ou quicksight: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 UpdateDashboardPermissions da API DescribeDashboardPermissions e. 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 com namespace ou com group.

  • 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 AllowedDomains parâmetro de uma chamada de GenerateEmbedUrlForRegisteredUser API GenerateEmbedUrlForAnonymousUser ou API.

    Essa opção só é visível para QuickSight administradores. Você também pode adicionar subdomínios como parte de um domínio. Para ter 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:

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

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