Présentation de l'intégration - Amazon QuickSight

Présentation de l'intégration

 S'applique à : Enterprise Edition 

Pour intégrer les analyses, vous utilisez les opérations d'API suivantes :

Quelques étapes sont impliquées dans le processus réel d'intégration de l'analyse. Avant de commencer, assurez-vous d'avoir les éléments suivants en place :

  • Pour authentifier les utilisateurs, disposez d'un rôle IAM pour ajouter un lecteur dans QuickSight et d'un rôle IAM pour récupérer le tableau de bord intégré spécifique.

  • Vous devez connaître l' IdentityType que vous prévoyez d'utiliser avec l'opération GetDashboardEmbedUrl d'API . L'opération GetSessionEmbedUrl d'API n'a pas besoin d'une valeur pour IdentityType.

  • Pour les utilisateurs existants, partagez QuickSight des assets avec eux au préalable. Pour les nouveaux utilisateurs qui s'authentifient, savez comment accorder l'accès aux ressources . Pour cela, vous pouvez ajouter tous les assets à un QuickSight dossier. Si vous préférez utiliser QuickSight l'API , utilisez les opérations DescribeDashboardPermissions d'API UpdateDashboardPermissions et .

  • Si vous intégrez des tableaux de bord, assurez-vous d'avoir l'ID des tableaux de bord à intégrer. L'ID du tableau de bord est le code dans l'URL du tableau de bord. Vous pouvez également l'obtenir à partir d'une copie scriptée du tableau de bord créé avec l'opération DescribeDashboard d'API . Si vous utilisez l'API , vérifiez que vous avez la VersionNumber valeur correcte pour le tableau de bord.

  • Un QuickSight administrateur doit explicitement activer les domaines dans lesquels vous prévoyez d'intégrer vos QuickSight. Pour ce faire, utilisez Gérer QuickSight , Domaines et Intégration dans le menu de profil. Cette option n'est visible que pour QuickSight les administrateurs. Vous pouvez également ajouter des sous-domaines dans le cadre d'un domaine. Pour plus d'informations, consultez Ajout de domaines pour les utilisateurs intégrés. Tous les domaines en cours d'utilisation (par exemple, développement, intermédiaire et production) doivent être explicitement autorisés, et ils doivent utiliser HTTPS. Vous pouvez ajouter jusqu'à 100 domaines à la liste blanche.

Une fois toutes les conditions préalables remplies, l'intégration QuickSight implique les étapes suivantes, qui sont expliquées plus en détail ultérieurement :

  1. Pour l'authentification, utilisez votre serveur d'applications pour authentifier l'utilisateur et obtenir l'URL du tableau de bord intégré à l'aide de l'un des SDKsAWS. Pour les utilisateurs avec IdentityType = Anonymous, aucune authentification n'est nécessaire.

  2. Intégrez dans votre application ou portail QuickSightweb. Pour simplifier ce processus, vous pouvez utiliser le kit SDK Amazon QuickSight d'intégration , disponible sur NPMJS et GitHub. Ce JavaScript kit SDK personnalisé est conçu pour vous aider à intégrer efficacement des tableaux de QuickSight bord dans vos pages d'application, définir des valeurs par défaut, connecter des contrôles et gérer les erreurs.

Vous pouvez utiliser les journaux d'audit AWS CloudTrail pour obtenir des informations sur le nombre de tableaux de bord intégrés, les taux d'accès et les domaines où ils sont intégrés.