Tableau Lightning Web コンポーネントとトークン認証によるシングル サインオン (SSO) の設定
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 では必須です。
重要:
• Salesforce コンソール アプリは Tableau Lightning Web コンポーネントの使用をサポートしていません。
• ケース レコード ページでは、Chatter メールでの Tableau Lightning Web コンポーネントの使用をサポートしていません。
信頼できる 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 のシームレス認証を有効にする
Tableau View および Tableau Pulse LWC は、設定なしで Lightning App Builder で使用できます。ただし、Tableau Pulse LWC が機能するにはトークン認証が必要です。
Salesforce 設定を構成する
次の手順は、Salesforce 管理者が 1 回だけ完了する必要があります。
- Salesforce アプリで、右上隅にある歯車を選択し、[設定] を選択します。
- 左側のナビゲーション ペインで、[Quick Find (クイック検索)] 検索バーに「Tableau」と入力します。
- [Tableau Embedding (Tableau 埋め込み)] 設定ページを選択します。
- [トークンベースのシングル サインオン認証を有効にする] のチェックボックスを選択してください。
注: 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 アプリケーション ビルダー」を参照してください。
注: [ケース レコード] ページでは、Chatter メールでの Tableau Lightning Web コンポーネントの使用をサポートしていません。
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 ビューの埋め込み
すべてのビューが同じサイトからのものである限り、Salesforce Lightning ページに複数の Tableau ビューを埋め込むことができます。Tableau は 1 つのセッションのみをサポートしており、そのセッションはサイトに固有です。最後に許可されたセッションにより、以前のセッションは消去されます。
複数のサイトからの Tableau ビューを埋め込むには、サイト固有の別の Lightning ページを作成する必要があります。
モバイル向け Tableau LWC シングル サインオン
注: Tableau View および Pulse LWC は、iOS 17.2.1 以降で利用できます。
モバイル ユーザーで問題が起こるのを防ぐために、次のベスト プラクティスを検討してください。
- 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 ビュー] ペインからすべてのプロパティをコピーして、新しいコンポーネントに上書きします。
- 古いコンポーネントの削除アイコンを選択します。
エラー: Tableau Pulse LWC を有効にするには、Salesforce 管理者に連絡して Tableau のシームレス認証を設定してください (Tableau Pulse LWC のみ)
このエラーを解決するには、このページの手順に従って、Tableau LWC のシームレス認証を有効にしてください。