Einbetten mit Amazon QuickSight APIs - Amazon QuickSight

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Einbetten mit Amazon QuickSight APIs

 Gilt für: Enterprise Edition 
   Zielgruppe: QuickSight Amazon-Entwickler 

Der eigentliche Prozess der Einbettung von Analysen mithilfe von sind nur wenige Schritte erforderlich. QuickSight APIs

Stellen Sie vor dem Beginn sicher, dass Sie über die folgenden Tools bereit haben:

  • Richten Sie die erforderlichen IAM-Berechtigungen für die Anruferidentität ein, die von Ihrer Anwendung verwendet wird, die das AWS SDK für API-Aufrufe verwendet. Erteilen Sie beispielsweise die Erlaubnis, die Aktion quicksight:GenerateEmbedUrlForAnonymousUser oder quicksight:GenerateEmbedUrlForRegisteredUser zuzulassen.

  • Um Inhalte für registrierte Benutzer einzubetten, teilen Sie sie QuickSight vorher mit ihnen. Neue Benutzer, die sich authentifizieren, sollten wissen, wie sie Zugriff auf die Ressourcen gewähren können. Eine Möglichkeit, dies zu tun, besteht darin, alle Assets einem QuickSight Ordner hinzuzufügen. Wenn Sie lieber die QuickSight API verwenden möchten, verwenden Sie die Operationen DescribeDashboardPermissions und UpdateDashboardPermissions API. Weitere Informationen finden Sie unter DescribeDashboardPermissionsoder UpdateDashboardPermissionsin der Amazon QuickSight API-Referenz. Wenn Sie das Dashboard mit allen Benutzern in einem Namespace oder einer Gruppe teilen möchten, können Sie das Dashboard mit namespace oder group teilen.

  • Wenn Sie Dashboards einbetten, stellen Sie sicher, dass Sie die ID der Dashboards haben, die Sie einbetten möchten. Die Dashboard-ID ist der Code in der URL des Dashboards. Sie können ihn auch über die Dashboard-URL abrufen.

  • Ein QuickSight Administrator muss Domains, in die Sie Ihre QuickSight Analysen einbetten möchten, explizit aktivieren. Sie können dies tun, indem Sie im Profilmenü die Optionen Verwalten QuickSight, Domains und Einbetten verwenden, oder Sie können den AllowedDomains Parameter eines GenerateEmbedUrlForAnonymousUser oder GenerateEmbedUrlForRegisteredUser API-Aufrufs verwenden.

    Diese Option ist nur für QuickSight Administratoren sichtbar. Sie können auch Subdomains als Teil einer Domain hinzufügen. Weitere Informationen finden Sie unter Erlaube das Auflisten von Domains zur Laufzeit mit der API QuickSight .

    Alle Domains in Ihrer statischen Zulassungsliste (z. B. Entwicklung, Staging und Produktion) müssen explizit zugelassen sein und HTTPS verwenden. Sie können der Liste der zulässigen Domains bis zu 100 Domains hinzufügen. Sie können Domänen zur Laufzeit mit QuickSight API-Vorgängen hinzufügen.

Nachdem alle Voraussetzungen erfüllt sind, QuickSight umfasst das Einbetten die folgenden Schritte, die später näher erläutert werden:

  1. Verwenden Sie zur Authentifizierung Ihren Anwendungsserver, um den Benutzer zu authentifizieren. Generieren Sie nach der Authentifizierung auf Ihrem Server die eingebettete Dashboard-URL mit dem AWS SDK, das Sie benötigen.

  2. Binden Sie das Produkt QuickSight mithilfe der generierten URL in Ihr Webportal oder Ihre Anwendung ein. Um diesen Vorgang zu vereinfachen, können Sie das Amazon QuickSight Embedding SDK verwenden, das auf NPMJS und verfügbar ist. GitHub Dieses maßgeschneiderte JavaScript SDK soll Ihnen helfen, Seiten effizient QuickSight in Ihre Anwendungsseiten zu integrieren, Standardeinstellungen festzulegen, Steuerelemente zu verbinden, Rückrufe zu erhalten und Fehler zu behandeln.

Mithilfe von AWS CloudTrail Überwachungsprotokollen können Sie Informationen über die Anzahl der eingebetteten Dashboards, die Benutzer einer eingebetteten Oberfläche und die Zugriffsraten abrufen.

Themen