Tableau Cloud 說明

附註：

• 在執行此處所述的步驟之前，必須依照 針對 OpenID Connect 設定身分識別提供者 中的說明設定 OpenID 提供者。
• 或者，可以使用 OpenID Connect 方法(連結在新視窗開啟)透過 Tableau REST API 為 Tableau Cloud 設定 OIDC 驗證。附註：僅適用於 Tableau Cloud。
• 對於 Tableau Cloud，Tableau REST API 和 tabcmd 不支援 OIDC 單一登入 (SSO)。若要使用 tabcmd 或 Tableau REST API(連結在新視窗開啟)，使用者必須使用個人存取權杖 (PAT) 登入 Tableau Cloud。
• 對於 TCM，Tableau Cloud Manager REST API 不支援 OIDC SSO。若要使用 TCM REST API(連結在新視窗開啟)，使用者必須使用 PAT 登入 TCM。

• 用戶端 ID：此值由 IdP 簽發，並指定已註冊的 Tableau Cloud 或 TCM 的識別碼。這可讓 IdP 知道驗證請求來自哪裡。

• 用戶端密碼：這是 Tableau Cloud 或 TCM 用於驗證來自 IdP 的回應真實性的權杖。此值應妥善保管。

• 設定網址：該值指定使用者經過驗證後 IdP 重新導向到的 URL。URL 必須包括主機與協定（例如，https://admin.okta.com/oauth2/default/.well-known/openid-configuration），但 Tableau 會提供 URL 端點。此 URL 會指定提供者設定探索文件的位置，該文件包含 OpenID 提供者中繼資料。

  附註：若 IdP 未提供設定 URL，請使用以 .well-known/openid-configuration 結尾的 URL。對於 Tableau Cloud，請考慮使用 Tableau REST API 中的 OpenID Connect 驗證方法(連結在新視窗開啟)來設定 OIDC。

可選參數

附註：僅適用於 Tableau Cloud。

以下可選參數可以使用 Tableau REST API 中的 OpenID Connect 驗證方法(連結在新視窗開啟)進行設定。

• 提示： 提示使用者重新驗證並同意。預設情況下，使用者同意處於開啟狀態。

• 自訂範圍：用於查詢 IdP 的自訂範圍使用者相關值。

• 用戶端驗證：權杖端點驗證方法。預設值為 'client_secret_basic'。支援 'client_secret_post' 的值。

• 基本 ACR 值：用於驗證的基本驗證內容參考類別值的清單。

• 自願 ACR 值：用於驗證的自願驗證內容參考類別值的清單。

若要成功登入 Tableau Cloud 或 TCM，必須在 OpenID Connect (OIDC) IdP 中佈建指定使用者，然後將其對應到 Tableau Cloud 或 TCM 上的使用者帳戶。OIDC 依賴於宣告的方法與其他應用程式共用使用者帳戶屬性。Tableau Cloud 或 TCM 依賴 IdP 宣告將使用者帳戶從 IdP 對應到託管在 Tableau Cloud 或 TCM 上的帳戶。宣告包含使用者帳戶屬性，例如電子郵件、名稱等。若要瞭解 Tableau Cloud 或 TCM 如何將 IdP 宣告對應到使用者帳戶，請參閱 驗證概述。

附註：宣告區分大小寫。

• 使用者名稱：預設情況下，Tableau 期望 IdP 傳遞使用者名稱宣告。根據您的 IdP，您可能需要將 Tableau Cloud 設定為使用其他 IdP 聲宣告。附註：Tableau 中的使用者名稱是不可變的，且無法隨時更新。

• 名稱宣告：可以指定名稱或既定名稱和姓氏來檢索使用者的 DisplayName。

對於 Tableau Cloud

1. 以站台管理員身分登入到 Tableau Cloud 並選取「設定」>「驗證」。

2. 在「驗證」標籤上，按一下「新增設定」按鈕，選取「OpenID Connect (OIDC)」，然後輸入設定名稱。

3. 請依照下列步驟設定 Tableau Cloud 以進行 OIDC 驗證：

   1. 在步驟 1 中，輸入 IdP 提供的所需資訊，包括用戶端 ID、用戶端密碼和設定 URL。

   2. 在步驟 2 中，複製將貼上到 IdP 入口網站中的 Tableau Cloud 重新導向 URL，以在使用者進行驗證後重新導向使用者。

   3. 在步驟 3 中，輸入宣告以確保使用者使用者名稱和顯示名稱的正確對應。

   4. 在步驟 4 中，如果您的 IdP 支援，可以選擇啟用單一登出 (SLO)。

   5. 在步驟 5 中，可以選擇使用者在存取內嵌檢視時進行驗證的方式：在單獨的彈出視窗中或使用內嵌 iFrame。

      附註：可以在「驗證」頁面的「嵌入視圖的預設驗證類型」區段下選取內嵌檢視的驗證類型（位於 OIDC 設定步驟下方）。

4. 完成後，按一下「儲存變更」按鈕。

附註：編輯 OIDC 設定時，用戶端密碼是隱藏的，需要重新輸入才能儲存任何變更。

對於 TCM

1. 以雲端管理員身分登入 TCM，並選取設定 > 驗證。

2. 在「驗證」索引標簽上，選取「啟用其他驗證方法」核取方塊。

3. 從下拉式功能表中選取 OpenID Connect (OIDC)，然後按一下設定（必需）下拉箭頭。

4. 請依照下列步驟設定 TCM，以進行 OIDC 驗證：

   1. 在步驟 1 中，輸入 IdP 提供的所需資訊，包括用戶端 ID、用戶端密碼和設定 URL。

   2. 在步驟 2 中，複製將貼上到 IdP 入口網站中的 TCM 重新導向 URL，以便在使用者進行驗證後對其進行重新導向。

   3. 在步驟 3 中，輸入宣告，以確保使用者的使用者名稱和顯示名稱對應正確。

   4. 在步驟 4 中，如果您的 IdP 支援，可以選擇啟用單一登出 (SLO)。

5. 完成後，按一下「儲存變更」按鈕。

附註：編輯 OIDC 設定時，用戶端密碼是隱藏的，需要重新輸入才能儲存任何變更。

我們強烈建議測試設定以避免任何遭受封鎖的情境。測試設定有助於確保在將使用者的驗證類型變更為 OIDC 之前已正確設定 OIDC。為成功測試設定，請確保至少有一個您可以以該身分登入的使用者，該使用者已在 IdP 中佈建並新增至 Tableau Cloud 或 TCM，並已設定 OIDC 驗證類型。

附註： 如果不確定宣告是什麼，請完成設定並測試設定。測試設定將產生一個新窗格，其中包含宣告對應詳情，包括使用者名稱和顯示名稱宣告。某些 IdP 可能會將電子郵件地址對應到 Tableau 使用者名稱。

對於 Tableau Cloud

1. 在選取 OpenID Connect (OIDC) 的「驗證」索引標籤上，在步驟 6 下按一下「測試設定」按鈕。一個新窗格將會顯示，其中包含有關設定的詳情。

2. 完成後，請按照以下步驟將使用者新增至站台，從而完成 OIDC 設定。

對於 TCM

1. 在已選取 OpenID Connect (OIDC) 的情況下，在「驗證」索引標簽上，在步驟 5 下按一下「測試設定」按鈕。一個新視窗將會顯示，其中包含有關設定的詳細資料。

2. 完成後，請按照以下步驟將使用者新增至租用戶，以完成 OIDC 設定。

本節所述的步驟在 Tableau Cloud 或 TCM 的使用者頁面上執行。

1. 完成上述步驟後，返回 Tableau Cloud 站台或 TCM。

2. 從左側窗格中，選取「使用者」頁面。

3. 請遵循下列主題之一中所述的程序：

   • 對於 Tableau，請參閱向網站新增使用者

   • 對於 TCM，請參閱使用 Tableau Cloud Manager 管理使用者

使用下列部分對 Tableau Cloud 或 TCM 中的 OpenID Connect (OIDC) 問題進行疑難排解。

許多身分提供程式支援 OIDC 通訊協定。OIDC 通訊協定是一個開放和靈活的標準，因此，並非所有標準實現都是相同的。管理員在為 OIDC 設定 Tableau Cloud 或 TCM 時遇到的大多數問題都是不同身分提供程式實作 OIDC 的方式所導致的。若在 Tableau 中設定 OIDC 時遇到錯誤，我們建議您與 IdP 合作解決這些問題。

對於 Tableau Cloud

即使 Tableau Cloud 已設定為使用 OIDC，使用 tabcmd、Tableau REST API(連結在新視窗開啟) 或 Tableau 資料擷取命令列公用程式(連結在新視窗開啟)（隨 Tableau Desktop 提供）登入 Tableau Cloud 時，也不會使用 OIDC 驗證。

對於 TCM

同樣，即使 TCM 已設定為使用 OIDC，登入 Tableau Cloud Manager REST API(連結在新視窗開啟) 時，也不會使用 OIDC 驗證。

在某些情況下，登入 Tableau Cloud 或 TCM 可能會失敗，並顯示下列訊息：

登入失敗：使用者 <username_from_IdP> 的身分提供程式驗證失敗。無法在 Tableau Cloud 中找到使用者。

此錯誤通常表示 Tableau 中儲存的使用者名稱與 IdP 提供的使用者名稱不相符。若要解決此問題，請確保使用者名稱值相符。例如，若 Jane Smith 的使用者名稱在 IdP 中儲存為「jsmith@example.com」，則其在 Tableau Cloud 或 TCM 中也必須儲存為「jsmith@example.com」。