Incrustación con Amazon QuickSight APIs - Amazon QuickSight

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Incrustación con Amazon QuickSight APIs

 Se aplica a: Enterprise Edition 
   Público objetivo: QuickSight desarrolladores de Amazon 

Solo hay unos pocos pasos involucrados en el proceso real de integración de análisis mediante el QuickSight APIs.

Antes de empezar, asegúrate de tener preparados los siguientes elementos:

  • Configure los IAM permisos necesarios para la identidad de la persona que llama utilizada por su aplicación y que la utilizará AWS SDK para realizar API llamadas. Por ejemplo, conceda permiso para permitir la acción quicksight:GenerateEmbedUrlForAnonymousUser o quicksight:GenerateEmbedUrlForRegisteredUser.

  • Para insertar contenido para los usuarios registrados, comparte los QuickSight activos con ellos de antemano. Para los nuevos usuarios que se están autenticando, infórmese sobre cómo conceder acceso a los activos. Una forma de hacerlo es añadiendo todos los activos a una QuickSight carpeta. Si prefiere utilizar las operaciones QuickSight API, utilice las UpdateDashboardPermissions API operaciones DescribeDashboardPermissions y. Para obtener más información, consulta DescribeDashboardPermissionso UpdateDashboardPermissionsconsulta Amazon QuickSight API Reference. Si desea compartir el panel con todos los usuarios de un espacio de nombres o grupo, puede compartir el panel con namespace o group.

  • Si va a integrar paneles, asegúrese de tener el ID de los paneles que desea integrar. El ID del panel de control es el código que aparece en el panel URL de control. También puedes obtenerlo desde el panel de controlURL.

  • QuickSight El administrador debe habilitar de forma explícita los dominios en los que planea incrustar sus QuickSight análisis. Para ello, utilice las opciones Administrar QuickSight, Dominios e Incrustación del menú del perfil, o bien utilice el AllowedDomains parámetro de una GenerateEmbedUrlForRegisteredUser API llamada GenerateEmbedUrlForAnonymousUser o.

    Esta opción solo está visible para QuickSight los administradores. También puede agregar subdominios como parte de un dominio. Para obtener más información, consulte Permita publicar dominios en tiempo de ejecución con QuickSight API.

    Todos los dominios de tu lista estática permitidos (como los de desarrollo, preparación y producción) deben estar permitidos de forma explícita y ellos deben HTTPS utilizarlos. Puede agregar hasta 100 dominios a la lista de permitidos. Puede añadir dominios en tiempo de ejecución con QuickSight API las operaciones.

Una vez cumplidos todos los requisitos previos, la incrustación QuickSight implica los siguientes pasos, que se explican con mayor detalle más adelante:

  1. Para la autenticación, utilice el servidor de aplicaciones para autenticar al usuario. Tras la autenticación en el servidor, genere el panel integrado URL con el AWS SDK que necesite.

  2. En su portal web o aplicación, QuickSight insértelo utilizando lo generadoURL. Para simplificar este proceso, puede utilizar Amazon QuickSight EmbeddingSDK, disponible en NPMJSy GitHub. Esta personalización JavaScript SDK está diseñada para ayudarlo a QuickSight integrarse de manera eficiente en las páginas de su aplicación, establecer los valores predeterminados, conectar los controles, recibir llamadas y gestionar los errores.

Puede utilizar los registros de AWS CloudTrail auditoría para obtener información sobre la cantidad de paneles integrados, los usuarios de una experiencia integrada y las tasas de acceso.