Integración con Amazon Quick Sight APIs - Amazon Quick Suite

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.

Integración con Amazon Quick Sight APIs

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

Solo hay unos pocos pasos involucrados en el proceso real de integración de análisis con Amazon Quick Sight APIs.

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

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

  • Para incrustarlos para los usuarios registrados, comparte los activos de Amazon Quick Sight 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 carpeta de Amazon Quick Sight. Si prefiere utilizar la API de Amazon Quick Sight, utilice las operaciones DescribeDashboardPermissions y UpdateDashboardPermissions API. Para obtener más información, consulta DescribeDashboardPermissionso consulta UpdateDashboardPermissionsla referencia de la API de Amazon Quick Suite. 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 es el código en la URL del panel. También puede obtenerlo desde la URL del panel.

  • Un administrador de Amazon Quick Sight debe habilitar de forma explícita los dominios en los que planea incrustar sus análisis de Amazon Quick Sight. Para ello, utilice la opción Gestionar Amazon Quick Sight, Dominios e Incrustación del menú del perfil, o bien utilice el AllowedDomains parámetro de una GenerateEmbedUrlForAnonymousUser llamada a la GenerateEmbedUrlForRegisteredUser API.

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

    Todos los dominios de su lista estática de permitidos (como desarrollo, almacenamiento provisional y producción) deben estar explícitamente permitidos, y deben usar HTTPS. Puede agregar hasta 100 dominios a la lista de permitidos. Puede añadir dominios en tiempo de ejecución con las operaciones de la API de Amazon Quick Sight.

Una vez cumplidos todos los requisitos previos, la integración de Amazon Quick Sight implica los siguientes pasos, que se explican con más 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 la URL del panel de control integrada con el AWS SDK que necesite.

  2. En su aplicación o portal web, inserte Amazon Quick Sight mediante la URL generada. Para simplificar este proceso, puede utilizar el SDK de incrustación de Amazon Quick Sight, disponible en NPMJS y. GitHub Este JavaScript SDK personalizado está diseñado para ayudarlo a integrar Amazon Quick Sight de manera eficiente en las páginas de sus aplicaciones, establecer valores predeterminados, conectar controles, recibir llamadas y gestionar 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.