將 Tableau Server 連線到客戶資料平台

本主題介紹如何從 Tableau Server 透過 OAuth 驗證連線the至 Salesforce Customer Data Platform。

在 Tableau Server 中使用 Salesforce Customer Data Platform 需要執行本主題中描述的步驟。

步驟 1:設定連接器

  1. Tableau Exchange 連接器站台下載最新的 Salesforce Customer Data Platform 連接器(Salesforce_CDP.taco 檔)。
  2. 將 .taco 檔移動到 Tableau 連接器資料夾:
  • Windows:C:\Users[Windows User]\Documents\My Tableau Repository\Connectors
  • Linux:/opt/tableau/connectors/var/opt/tableau_server/data/tabsvc/vizqlserver/Connectors/
  1. 重新啟動 Tableau Server。

步驟 2:安裝客戶資料平台 JDBC 驅動程式

附註:Tableau Server 版本 2023.1 僅與 JDBC 驅動程式版本 18 及更高版本相容。

  1. 從 Salesforce CDP GitHub 站台下載最新的 JDBC 驅動程序(Salesforce-CDP-jdbc-[版本].jar 文件): https://github.com/forcedotcom/Salesforce-CDP-jdbc/releases
  2. 將下載的 Salesforce-CDP-jdbc-[version].jar 檔案移動到以下位置:
  • Windows:C:\Program Files\Tableau\Drivers
  • Linux: /opt/tableau/tableau_driver/jdbc

步驟 3:建立與 Salesforce 連線的應用程式

建立 API 範圍後,使用以下程序建立與 Salesforce 連線的應用程式,以處理來自 Tableau Server 的 OAuth 委派。

  1. 以管理員身分登入 Salesforce Customer Data Platform 帳戶,按一下右上方的使用者名稱,然後選取「設定」

  2. 在左側窗格的應用程式下,選取應用程式管理器

  3. 在「已連線的應用程式」區段中,按一下新建已連線的應用程式

  4. 「基本資訊」中,為已連線應用程式命名(例如 Example.com),並逐步點選 API 欄位,以便其以正確的格式自動填入,然後輸入該應用程式的聯絡電子郵件地址。

  5. API「啟用 OAuth 設定」區段中,選取啟用 OAuth,執行以下操作:

    1. 在出現的新 OAuth 設定中,對於回呼 URL,輸入 Tableau Server 的完整網域名稱 (FQDN),使用 https 協定,並將以下文字附加到 URL:/auth/add_oauth_token

      例如:https://example.com/auth/add_oauth_token

    2. 將下列項目從可用 OAuth 範圍移到所選 OAuth 範圍

      • 透過 API (api) 管理使用者資料
      • 隨時代表您執行請求 (refresh_token、offline_access)
      • 管理 Customer Data Cloud 設定檔資料 (cdp_profile_api)
      • 對客戶資料平台資料執行 ANSI SQL 查詢 (cdp_query_api)

  6. 完成後,請按一下「儲存」

  7. 移至「應用程式管理員」清單,巡覽到已連線應用程式,按一下下拉箭頭,然後選取「管理」

儲存應用程式後,「API(啟用 OAuth 設定)」區段將填充以下識別碼,您將使用這些識別碼設定 Tableau Server:

  • 取用者金鑰
  • 取用者密碼
  • 回呼 URL

    附註:儲存取用者金鑰、密碼和回呼 URL,以在稍後使用。



將 OAuth 與 Customer Data Platform 一同使用

考慮將自訂 OAuth 用戶端設定為 1) 如果是為伺服器設定,則覆寫 OAuth 用戶端;或 2) 啟用支援安全連線到需要唯一 OAuth 用戶端的資料。

在 Salesforce 中建立已連線應用程式並且擁有取用者金鑰、取用者密碼和回呼 URL 後,可以針對 Customer Data Platform OAuth 連線設定 Tableau Server。開始收集以下資訊。

  • 取用者金鑰:取用者金鑰,在 Tableau 中也稱為用戶端識別碼,由步驟 4 結束時的程序產生。在以下 tsm 命令中的 [your_consumer_key] 使用這個值。
  • 取用者密碼:取用者密碼,在 Tableau 中也稱為用戶端密碼,是從步驟 4 結束時的程序產生。在以下 tsm 命令中的 [your_consumer_secret] 使用這個值。
  • 回呼 URL:回呼 URL,在 Tableau 中也稱為重新導向 URL,是 Tableau Server URLhttps://example.com 和附加至其的 「/auth/add_oauth_token」。在以下 tsm 命令中的 [your_callback_url] 使用這個值。
  • 設定 Id:在後續在後續 tsm customer_360_audience 中使用的 oauth.config.id 參數的值。
使用 TSM 命令進行 OAuth 設定

執行以下 tsm 命令。 設定 OAuth。

tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"customer_360_audience\", \"oauth.config.client_id\":\"[your_consumer_key]\", \"oauth.config.client_secret\":\"[your_consumer_secret]\", \"oauth.config.redirect_uri\":\"[your_callback_url]\"}]" --force-keys

tsm pending-changes apply

設定多個連接器

若要設定多個連接器,則必須在單個命令中包括所有連接器。例如: 

tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"custom_360_audience\", \"oauth.config.client_id\":\"[your_consumer_key]\", \"oauth.config.client_secret\":\"[your_consumer_secret]\", \"oauth.config.redirect_uri\":\"[your_callback_url]\"}, {\"oauth.config.id\":\"dremio\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sqldb\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys

tsm pending-changes apply

步驟 1:註冊 OAuth 用戶端識別碼和用戶端密碼

完成以下過程以將自訂 OAuth 用戶端註冊到您的站台。

  1. 使用網站管理員認證登入 Tableau Server,並巡覽到「設定」頁面。
  2. OAuth 用戶端登錄檔下,選取「新增 OAuth 用戶端」按鈕。
  3. 對於「連線類型」,選取客戶資料平台。
  4. 對於 OAuth 提供者,選取「自訂 IDP」
  5. 輸入「用戶端識別碼」
  6. 輸入「用戶端密碼」
  7. 輸入「重新導向 URL」
  8. 對於選擇 OAuth 組態檔,選取「選擇檔案」按鈕上傳組態檔。
  9. 選取「新增 OAuth 用戶端」按鈕以完成註冊過程。
  10. 選取「設定」頁面底部或頂部的「儲存」按鈕以儲存變更。

步驟 2:驗證和更新儲存的認證

為了幫助確保能不間斷進行資料存取,您(和您的站台使用者)必須刪除以前儲存的所有認證並重新新增它們。

  1. 巡覽至「帳戶設定」」頁面。
  2. 「儲存的資料來源認證」下,在現有儲存的認證旁選取「刪除」
  3. 在同一連接器旁,選取「新增」
  4. 按照提示連線到 Customer Data Platform 連接器。
  5. 選取「儲存」

步驟 3:通知使用者更新他們儲存的認證

確保通知站台使用者更新其儲存的 Customer Data Platform 連接器認證。站台使用者可以使用「為資料連線管理已儲存認證」中描述的過程來更新他們儲存的認證。

另請參閱
感謝您的意見回饋!