Einbetten mit 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 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 AWS SDK zum API Tätigen von Anrufen verwendet wird. Erteilen Sie beispielsweise die Erlaubnis, die Aktion quicksight:GenerateEmbedUrlForAnonymousUser oder quicksight:GenerateEmbedUrlForRegisteredUser zuzulassen.

  • Um Inhalte für registrierte Benutzer einzubetten, teilen Sie QuickSight sie 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 verwenden möchten QuickSight API, verwenden Sie die UpdateDashboardPermissions API Operationen DescribeDashboardPermissions und. Weitere Informationen finden Sie unter DescribeDashboardPermissionsoder UpdateDashboardPermissionsin der QuickSight APIAmazon-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 URL der Code im Dashboard. Sie können ihn auch über das Dashboard abrufenURL.

  • Ein QuickSight Administrator muss Domains, in die Sie Ihre QuickSight Analysen einbetten möchten, explizit aktivieren. Sie können dazu im Profilmenü die Optionen Verwalten QuickSight, Domänen und Einbetten verwenden, oder Sie können den AllowedDomains Parameter eines GenerateEmbedUrlForRegisteredUser API Aufrufs GenerateEmbedUrlForAnonymousUser oder 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 Erlauben Sie das Auflisten von Domains zur Laufzeit mit dem QuickSight API.

    Alle Domänen in Ihrer statischen Zulassungsliste (z. B. Entwicklung, Staging und Produktion) müssen explizit zugelassen werden und sie müssen verwendenHTTPS. Sie können der Liste der zulässigen Domains bis zu 100 Domains hinzufügen. Sie können Domänen zur Laufzeit mithilfe von 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 das eingebettete Dashboard URL mit dem AWS SDK, was Sie benötigen.

  2. Integrieren Sie es QuickSight mithilfe der generierten Daten in Ihr Webportal oder Ihre AnwendungURL. Um diesen Vorgang zu vereinfachen, können Sie Amazon QuickSight Embedding verwendenSDK, das auf NPMJSund GitHubverfügbar ist. Diese individuelle Anpassung JavaScript SDK soll Ihnen helfen, Seiten effizient QuickSight in Ihre Anwendung 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