翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
を使用した埋め込み QuickSight APIs
適用先: Enterprise Edition |
対象者: Amazon QuickSight デベロッパー |
を使用して分析を埋め込む実際のプロセスには、いくつかのステップしかありません QuickSight APIs。
作業を開始する前に、以下の準備が整っていることを確認します。
-
アプリケーションで使用される発信者 ID に必要なIAMアクセス許可を設定します。このアクセス許可は、 AWS SDKを使用してAPI呼び出しを行います。たとえば、
quicksight:GenerateEmbedUrlForAnonymousUser
またはquicksight:GenerateEmbedUrlForRegisteredUser
アクションを許可するアクセス許可を付与します。 -
登録済みユーザーに を埋め込むには、事前に QuickSight アセットを共有します。新規認証ユーザーの場合、アセットへのアクセスを許可する方法を理解する必要があります。これを行う 1 つの方法は、すべてのアセットを 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 個のドメインを追加できます。API オペレーションを使用して QuickSight、実行時にドメインを追加できます。
すべての前提条件が完了したら、埋め込みには次のステップ QuickSight が含まれます。詳細については、後で説明します。
-
認証では、アプリケーションサーバーを使用してユーザーを認証します。サーバーで認証した後、必要な URL AWS SDKを使用して埋め込みダッシュボードを生成します。
-
ウェブポータルまたはアプリケーションで、生成された QuickSight を使用して を埋め込みますURL。このプロセスを簡素化するために、 NPMJS
および でSDK利用可能な Amazon QuickSight Embedding を使用できますGitHub 。このカスタマイズされた JavaScript SDK は、アプリケーションページ QuickSight への効率的な統合、デフォルトの設定、コントロールの接続、コールバックの取得、エラーの処理に役立つように設計されています。
AWS CloudTrail 監査ログを使用して、埋め込みダッシュボードの数、埋め込みエクスペリエンスのユーザー、およびアクセス率に関する情報を取得できます。