Tableau Lightning Web コンポーネントとシームレスな認証の構成
Tableau Lightning Web コンポーネント (LWC) を使用すると、Salesforce の顧客は、Tableau ビューと Tableau Pulse メトリクスを Salesforce Lightning ページにドラッグ アンド ドロップできます。
- Tableau ビュー コンポーネントを使用すると、Tableau Cloud または Tableau Server から埋め込みビューを追加できます。
- Tableau Pulse コンポーネントを使用すると、Tableau Cloud から Tableau Pulse 埋め込みメトリクスを追加できます。
Tableau LWC のシームレスな認証を使用すると、サインインせずに、接続済みアプリの信頼できるトークンを使用して Tableau コンテンツを表示できます。シームレスな認証は、Tableau ビュー LWC ではオプションですが、Tableau Pulse LWC では必須です。
信頼できる URL を追加する
Lightning ページに追加する Tableau ビューまたは Pulse URL は、信頼できる URL として追加する必要があります。
- Salesforce アプリで、右上隅にある歯車を選択し、[設定] を選択します。
- 左側のナビゲーション ペインで、[Quick Find (クイック検索)] 検索バーに「Trusted URLs (信頼できる URL)」と入力します。
- [Trusted URLs (信頼できる URL)] 設定ページを選択します。
- [New Trusted URL (新しい信頼できる URL)] を選択します。
- 設定ページの指示に従って、[API 名] と [URL] を入力します。注: URL は https:// で始まる必要があります。
- [CSP Context (CSP コンテキスト)] では、[すべて]を選択します。
- [CSP Directives (CSP ディレクティブ)] では、すべてのボックスをオンにします。
- [保存] を選択します。
Tableau LWC をオンにしてシームレスな認証を設定する
Salesforce 設定を構成する
次の手順は、Salesforce 管理者が 1 回だけ完了する必要があります。
- Salesforce アプリで、右上隅にある歯車を選択し、[設定] を選択します。
- 左側のナビゲーション ペインで、[Quick Find (クイック検索)] 検索バーに「Tableau」と入力します。
- [Tableau Embedding (Tableau 埋め込み)] 設定ページを選択します。
- [Tableau Lightning Web コンポーネントをオンにする] のチェックボックスと [トークンベースのシングル サインオン認証をオンにする] のチェックボックスを選択します。
注: Tableau Pulse LWC を構成するには、これらのボックスを両方ともオンにする必要があります。Tableau View LWC の場合、トークン認証を設定せず、代わりにコンポーネントの読み込み時に手動でサインインすることを選択できます。
Tableau View LWC をモバイルで使用するには、トークンベースの認証をオンにし、シームレスな認証を設定する必要があります。 - [Select Tableau User Identity field (Tableau ユーザー アイデンティティ フィールドの選択)] では、組織レベルのユーザー フィールドを設定して、Tableau でユーザーを認証できるようにします。Tableau ユーザー名に対応する Salesforce ユーザー フィールドを選択する必要があります。ドロップダウンには現在のユーザーのフィールド値が表示され、値が定義されていない場合は Null が表示されます。Tableau ユーザー名と一致するユーザー フィールドがない場合は、空のフィールド (フェデレーション ID やカスタム フィールドなど) を選択します。次に、空のフィールドにユーザーの Tableau ユーザー名を入力します。
注: Tableau ユーザー アイデンティティ フィールドの設定はすべてのユーザーに適用され、個別に設定する必要はありません。
- 変更内容を保存します。
- Tableau 管理者の場合は、次のセクションで Tableau 設定を構成する間、Salesforce 設定の [Tableau Embedding (Tableau 埋め込み)] タブを開いたままにしておきます。管理者ではない場合は、発行 URL と JWKS URI を Tableau 管理者と共有します。
Tableau 設定を構成する
1 つのタブで、Salesforce 組織の [Tableau Embedding (Tableau 埋め込み)] 設定ページを開きます。別のタブで、Tableau サイトに移動し、次の手順に従って接続済みアプリを設定します。
Tableau Server の場合は、以下の手順を実行します。
- Tableau Server 管理者として、Tableau サービス マネージャー (TSM) の Web インターフェイスにサインインします。
- [ユーザー ID とアクセス] に移動し、[認可サーバー] タブを選択します。
- [埋め込みコンテンツの OAuth アクセスを有効にする] チェックボックスをオンにします。
- [発行者 URL] と [JWKS URI] を入力します。これらは、Salesforce 組織の [Tableau 埋め込み] 設定ページにあります。Salesforce 組織の設定ページにある [コピー] ボタンを使用して、発行者 URL の値をコピーし、それを TSM Web インターフェイスに貼り付けます。JWKS URI の値に対してもこのプロセスを繰り返します。
- [保留中の変更を保存] を選択します。
- ページの右上隅にある [保留中の変更] を選択し、[変更を適用して再起動] を選択して、Tableau Server を停止してから再起動します。
注: TSM Web インターフェイスでは JWKS URI フィールドはオプションとしてマークされていますが、この値は Tableau LWC のシームレスな認証を使用するために必要です。
詳細については、「EAS を Tableau Server に登録する」(新しいウィンドウでリンクが開く)を参照してください。
Tableau Cloud の場合は、以下の手順を実行します。
- Tableau の [設定] ページを開き、[接続済みアプリ] タブを選択します。
- [新しい接続済みアプリ] のドロップダウンから [OAuth 2.0 信頼] を選択します。
- [接続済みアプリの作成] ダイアログで、[発行者 URL] と [JWKS URI] を入力します。これらの URL と URI は、Salesforce 組織の [Tableau ビュー埋め込み] 設定ページにあります。Salesforce 組織の設定ページにある [コピー] ボタンを使用して、発行元 URL の値をコピーし、それを Tableau 設定ページに貼り付けます。JWKS URI の値に対してもこのプロセスを繰り返します。
- [接続済みアプリを有効にする] のチェックボックスをオンにします。
- [作成] を選択します。
重要: [接続アプリの作成] ダイアログでは、JWKS URI フィールドがオプションとして示されていますが、この値は Tableau LWC のシームレスな認証を使用するために必要です。
注: 接続済みアプリには、外部認証サーバーという名前が付けられます。
詳細については、「EAS を Tableau Cloud に登録する」(新しいウィンドウでリンクが開く)を参照してください。
このサイトのホスト マッピングを作成する場合は、[接続済みアプリ] タブを開いたままにしておきます。このページの URL と [サイト ID のコピー] ボタンを使用して、次のセクションのホスト マッピング フィールドに値を入力できます。
ホスト マッピングを設定または編集する
ホスト マッピングを作成または編集するには、次の手順に従います。
ヒント: Tableau ユーザー アイデンティティ フィールドの設定はすべてのユーザーに適用され、個別に設定する必要はありません。
新しいホスト マッピングを作成する
- Salesforce アプリで、右上隅にある歯車を選択し、[設定] を選択します。
- 左側のナビゲーション ペインで、[Quick Find (クイック検索)] 検索バーに「Tableau」と入力します。
- [Tableau Embedding (Tableau 埋め込み)] 設定ページを選択します。
- [Tableau Host Mapping (Tableau ホスト マッピング)] セクションで、[Create New (新規作成)] を選択します。
- ホスト マッピングの詳細を入力します。
- Tableau サイト URL: マッピングする Tableau サイトの URL を入力します。既定のサイトを使用するオンプレミス インストールでない限り、URL にはサイト名が含まれている必要があります。注: このサイトのホスト マッピングを作成する場合は、[接続済みアプリ] タブを開いたままにしておきます。このページの URL と [サイト ID のコピー] ボタンを使用して、次のセクションのホスト マッピング フィールドに値を入力できます。
- Tableau サイト ID: マッピングする Tableau サイトのサイト ID を入力します。[接続済みアプリ] 設定ページまたは [共有] ダイアログで [サイト ID のコピー] ボタンを使用できます。
- Tableau サイトのホスト タイプ: [Tableau Cloud] または [Tableau Server] を選択します。
- [保存] を選択します。または、保存せずに [Tableau Embedding (Tableau 埋め込み)] 設定ページに戻る場合は、[キャンセル] を選択します。
ホスト マッピングを編集する
既存のマッピングのサイト ID とホスト タイプを更新できます。サイトの URL を変更する必要がある場合は、既存のマッピングを削除し、正しい URL で新しいマッピングを作成します。- Salesforce アプリの [Tableau Embeddings (Tableau 埋め込み)] 設定ページで、既存のホスト マッピングの横にある [編集] を選択します。
- 必要に応じて、[Tableau site ID (Tableau サイト ID)] フィールドまたは [Tableau site host type (Tableau サイトのホスト タイプ)] フィールドを編集します。
- [保存] を選択します。または、保存せずに [Tableau Embedding (Tableau 埋め込み)] 設定ページに戻る場合は、[キャンセル] を選択します。
Lightning アプリケーション ビルダーを使用して Tableau LWC を Lightning ページに追加する
Tableau LWC は、アプリ ページ、ホーム ページ、レコード Lightning ページのみで使用できます。Lightning ページ タイプと Lightning アプリケーション ビルダーの使用の詳細については、Salesforce ヘルプの「Lightning アプリケーション ビルダー」を参照してください。
Tableau ビューまたは Tableau Pulse LWC を既存の Lightning ページに追加するには、次の手順に従います。
- 編集する Lightning ページに移動します。
- 右上にある歯車アイコンを選択します。
- [ページの編集] を選択します。
- 以下の [Add a Tableau LWC to a Lightning page (Tableau LWC を Lightning ページに追加する)] セクションに進みます。
Tableau View または Tableau Pulse LWC を新しい Lightning ページに追加するには、次の手順に従います。
- Salesforce アプリで、右上隅にある歯車を選択し、[設定] を選択します。
- ナビゲーション ペインで、[Quick Find (クイック検索)] 検索バーに「Lightning アプリケーション ビルダー」と入力します。
- [Lightning アプリケーション ビルダー] 設定ページを選択します。
- [新規] を選択します。
- 作成するページ タイプを選択します。Tableau LWC は、アプリ ページ、ホーム ページ、レコード ページで使用できます。
- [次へ] を選択します。
- 名前を入力して、新しいページのレイアウトを選択し、[完了] を選択します。
Tableau LWC を Lightning ページに追加する
- ページの左側にあるコンポーネント リストから、Tableau View コンポーネントまたは Tableau Pulse コンポーネントをページにドラッグ アンド ドロップします。
- IDP を構成します。
ページを保存してアクティブ化する
- Tableau ビューまたは Tableau Pulse LWC の追加と構成が完了したら、[保存] を選択します。
- 新しいページを作成した場合は、ユーザーに表示されるようにページをアクティブ化するよう求められます。[アクティブ化] を選択します。
- [アクティベーション] ページの [Page Settings (ページの設定)] タブで、名前を入力してアイコンを選択し、表示設定を選択します。
- (オプション) [アクティベーション] ページの [Lightning エクスペリエンス] タブで、ページをさまざまな Lightning エクスペリエンス アプリに追加できます。
- (オプション) [アクティベーション] ページの [Mobile Navigation (モバイル ナビゲーション)] タブで、ページをモバイル ナビゲーション メニューに追加できます。
注: Tableau Pulse LWC はモバイルでは利用できません。 - [保存] を選択します。
複数の Tableau ビューの埋め込み
すべてのビューが同じサイトからのものである限り、Salesforce Lightning ページに複数の Tableau ビューを埋め込むことができます。Tableau は 1 つのセッションのみをサポートしており、そのセッションはサイトに固有です。最後に許可されたセッションにより、以前のセッションは消去されます。
複数のサイトからの Tableau ビューを埋め込むには、サイト固有の別の Lightning ページを作成する必要があります。
モバイルでの Tableau ビュー LWC のシームレスな認証
注: Tableau View LWC は iOS 17.2.1 以降で利用できます。Tableau Pulse LWC は現在、iOS または Android では利用できません。
モバイル ユーザーで問題が起こるのを防ぐために、次のベスト プラクティスを検討してください。
- Lightening ページのタイプ: モバイル ユーザーはアプリ ページとレコード ページにアクセスできますが、ホーム ページにはアクセスできません。
注: レコード ページは、特定のタイプのレコードに関連付ける必要があります。
- デスクトップとモバイルの両方のユーザーに同じページを使用する場合は、[有効化] を選択して、Lightning ページがデスクトップとモバイルの両方のフォーム ファクターの組織の既定として設定されていることを確認します。
- カスタマイズされたビジュアル体験を提供するために、デスクトップとモバイル用に個別の Lightning ページを作成することを検討してください。Tableau ビュー コンポーネントの高さは固定されており、さまざまな画面サイズに合わせて動的に調整されません。
- スクロール バーをビューに追加するには、Tableau ビュー コンポーネントのプロパティ ペインから [ツールバーの表示] を選択します。
- アプリ ページのタイプでは、[有効化] を選択して [Lightning エクスペリエンス] タブを選択します。ページを LightningBolt リストに追加すると、モバイルでページが見つけやすくなります。
- モバイルでは、iOS は既定でサイト間のトラフィックをブロックします。モバイルの設定を開き、Salesforce 設定を選択して、[Web サイト間のトラッキングを許可する] をオンにします。詳細については、「Web サイト間のトラッキングの有効化」(新しいウィンドウでリンクが開く)を参照してください。
Tableau ビュー LWC のシームレスな認証のトラブルシューティング
Salesforce と Tableau の構成を検証する
発行者 URL と JWKS URI の値が Salesforce 設定と Tableau 設定の両方で一致し、JWKS URI が id/keys で終わっていることを確認します。
- Tableau Cloud の場合は、1 つのタブで [Salesforce 設定] の [Tableau 埋め込み] ページを開きます。別のタブで、[Tableau 設定] の [接続済みアプリ] タブを開きます。[接続済みアプリ] タブで、[外部認証サーバー] を選択し、[編集] を選択します。[発行者 URL] と [JWKS URI] の値が一致し、JWKS URI が id/key で終わっていることを確認します。
- Tableau Server の場合は、1 つのタブで [Salesforce 設定] の [Tableau 埋め込み] ページを開きます。次に、Tableau サービス マネージャー (TSM) Web インターフェイスにサインインし、[ユーザー ID とアクセス] に移動して、[認可サーバー] タブを開きます。
ホスト マッピングの確認: ホスト マッピングを保存した場合は、そのマッピングに正しいサイト ID とホスト タイプがあることを確認します。
JWT トークンを検証する
Tableau ビュー Lightning Web コンポーネントのプロパティ エディターで、[デバッグ モード] を選択し、JWT トークンが期待どおりに動作していることを確認します。
- コンソール ログを開き、トークンをコピーします。
- jwt.io(新しいウィンドウでリンクが開く) Web サイトに移動し、トークンを [エンコード済み] フィールドに貼り付けます。
- 次のことを確認してください。
- 件名 (「sub」) は Tableau ユーザー名と一致しています。
- Tableau Cloud の場合、対象ユーザー (「aud」) は「tableau+SiteID」です。
Tableau Server の場合、対象ユーザー (「aud」) は「tableau」です。 - スコープ (「scp」) には、「tableau:views:embed」と「tableau:insights:embed」の両方が含まれます。
- 発行者 (「iss」) EAS サーバーは正確です。
ページの有効化を確認する
場合によっては、ユーザーが Lightning ページを作成しても、有効化されていない、またはどこにも割り当てられていないため、ユーザーがそれを見つけることができないことがあります。[有効化] を選択して、Lightning ページが目的のフォーム ファクターの組織の既定として設定されていることを確認します。
ヒント: デバッグするときは、リッチ テキスト コンポーネントをページにドラッグ アンド ドロップすると便利です。ページ タイプと埋め込もうとしているビュー URL の簡単な説明を追加します。これにより、エンド ユーザーが表示しているページが管理者が編集しているページであることを確認できます。
Tableau ビュー LWC がシームレスな認証なしで動作していることを確認する (Tableau ビュー LWC のみ)
- Lightning ページの [Tableau ビュー] ペインで、[既定の認証トークン] のチェックボックスをオフにし、変更を保存します。
- 別のタブで Tableau にサインインしている場合は、サインアウトします。ビュー URL に移動すると、Tableau サインイン ページにリダイレクトされることを確認します。サインインしないでください。
- Lightning ページに移動します。Tableau ビュー LWC には [Tableau にサインイン] ボタンが表示されます。
- [Tableau にサインイン] を選択し、Tableau の認証資格情報を入力してサインインします。
注: ビューが読み込まれない場合は、Tableau への認証に広範な問題があることを示しています。
エラー: LWC コンポーネントのバージョンはサポートされなくなりました (Tableau View LWC のみ)
このエラーを解決するには、次の手順に従ってください。
- [コンポーネント] リストで「Tableau」を検索し、新しい [Tableau ビュー] コンポーネントをページにドラッグ アンド ドロップします。
- 古いコンポーネントの [Tableau ビュー] ペインからすべてのプロパティをコピーして、新しいコンポーネントに上書きします。
- 古いコンポーネントの削除アイコンを選択します。