在 QuickSight API 中嵌入 - 亚马逊 QuickSight
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

重要：我们已经重新设计了 Amazon QuickSight 分析工作空间。您可能会遇到无法反映 QuickSight 控制台新外观的屏幕截图或程序化文本。我们正在更新屏幕截图和过程文本。

要查找特征或项目，请使用快速搜索栏。

有关新外观 QuickSight的更多信息，请参阅在 Amazon 上引入全新的分析体验 QuickSight。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 QuickSight API 中嵌入

 适用于：企业版 
   目标受众：Amazon QuickSight 开发者 

使用 QuickSight API 嵌入分析的实际过程只涉及几个步骤。

开始之前，请确保下列事项已准备就绪：

  • 为将使用 Amazon 软件开发工具包进行 API 调用的应用程序使用的来电者身份设置所需的 IAM 权限。例如，授予允许 quicksight:GenerateEmbedUrlForAnonymousUser 或 quicksight:GenerateEmbedUrlForRegisteredUser 操作的权限。

  • 要为注册用户嵌入，请事先与他们共享 QuickSight 资源。对于新的身份验证用户，请知晓如何授予对资产的访问权限。一种方法是将所有资源添加到一个 QuickSight 文件夹。如果您更喜欢使用 QuickSight API，请使用DescribeDashboardPermissions和 UpdateDashboardPermissions API 操作。有关更多信息，请参阅 Amazon QuickSight API 参考UpdateDashboardPermissions中的DescribeDashboardPermissions或。如果您想与命名空间或用户组中的所有用户共享控制面板，则可以与 namespace 或 group 共享控制面板。

  • 如果您要嵌入控制面板，请确保拥有要嵌入的控制面板 ID。控制面板 ID 是控制面板 URL 中的代码。您也可以从控制面板 URL 中获得该信息。

  • QuickSight 管理员必须明确启用您计划在其中嵌入 QuickSight 分析的域。您可以使用配置文件菜单中的 “管理” QuickSight、“域名” 和 “嵌入” 来执行此操作，也可以使用GenerateEmbedUrlForAnonymousUser或 GenerateEmbedUrlForRegisteredUser API 调用的AllowedDomains参数。

    此选项仅对 QuickSight 管理员可见。您也可以将子域添加为域的一部分。有关更多信息，请参阅 允许在运行时使用 QuickSight API 列出域名。

    必须显式允许静态允许列表中的所有域（如开发、暂存和生产），并且这些域必须使用 HTTPS。最多可以向允许列表添加 100 个域。您可以在运行时通过 QuickSight API 操作添加域名。

完成所有先决条件后，嵌入 QuickSight 涉及以下步骤，稍后将详细说明这些步骤：

  1. 对于身份验证，请使用您的应用程序服务器对用户进行身份验证。在服务器中进行身份验证后，使用所需的 Amazon SDK 生成嵌入式控制面板 URL。

  2. 在您的门户网站或应用程序中， QuickSight 使用生成的 URL 进行嵌入。为了简化此过程，你可以使用 NPMJS 和 NPMJS 上提供的亚马逊 QuickSight 嵌入软件开发工具包。GitHub此自定义 JavaScript SDK 旨在帮助您高效地 QuickSight 集成到应用程序页面、设置默认值、连接控件、获取回调和处理错误。

您可以使用 Amazon CloudTrail 审计日志来获取有关嵌入式仪表板数量、嵌入式体验的用户和访问率的信息。

主题