--- schema_version: "1" id: 4dec7d3af46506946aa49a5ae6138b4119b5977cec467114deaba4d25f68f9b5 title: trustedAuthenticationSettings 實體 collection: tableau version: current locale: zh-tw portal_url: https://docs.salesforce.com/tableau/current/zh-tw/server/entity_trusted_auth.md canonical_url: https://help.tableau.com/current/server/zh-tw/entity_trusted_auth.htm source_site: help.tableau.com content_type: documentation content_hash: 6e5a4006c0f5e5b11896e727a109713e1dd68b2e8e4c78c59b8e2dde61407ce2 description: Reference for the trustedAuthenticationSettings entity to configure trusted authentication. --- [跳至主要內容](#main-content) # trustedAuthenticationSettings 實體 在設定受信任的驗證之前，請檢視[受信任的驗證](https://help.tableau.com/current/server/zh-tw/trusted_auth.htm)。 使用下面的組態檔範本建立一個 json 檔案。使用適當的值填寫各個選項之後，使用以下命令傳遞 json 檔案並應用設定： `tsm settings import -f /path/to/file.json` `tsm pending-changes apply` 如果擱置組態需要重新啟動伺服器，`pending-changes apply` 命令將顯示提示，讓您知道即將重新啟動。即使伺服器已停止，也會顯示提示，但在這種情況下不會重新啟動。您可以使用 `--ignore-prompt` 選項隱藏提示，但這樣做不會改變重新啟動行為。如果變更不需要重新啟動，則不會出現提示即可套用變更。有關詳情，請參閱 [tsm pending-changes apply](https://help.tableau.com/current/server/zh-tw/cli_pending-changes.htm#pending-changes-apply)。 ## 組態範本 使用此範本來設定受信任的驗證設定。 **重要事項**所有實體選項均大小寫視為相異。 有關組態檔、實體和金鑰的更多說明，請參閱[組態檔範例](https://help.tableau.com/current/server/zh-tw/config_file_example.htm)。 完成受信任的驗證的初始設定後，使用 [tsm authentication trusted ](https://help.tableau.com/current/server/zh-tw/cli_authentication_tsm.htm#TSMTrusted) 子類別來設定其他值。 { "configEntities": { "trustedAuthenticationSettings": { "\_type": "trustedAuthenticationSettingsType", "trustedHosts": \["webserv1","webserv2","webserv3"\] } } } ## 組態檔參考 以下清單包括可隨 `"trustedAuthenticationSettings"` 實體集一起包括的所有選項。 trustedHosts 必要。 從 Tableau Server 請求受信任票證的 Web 伺服器的 IP 位址或主機名稱。 此選項採用字串清單，這需要以引號傳遞每個 IP 或主機，並用逗號（無空格）在括號中分隔。例如：`["192.168.1.101","192.168.1.102","192.168.1.103"]` 或 `["webserv1","webserv2","webserv3"]`。 您指定的值將覆寫以前的設定。因此，您必須在設定此值時包括主機的完整清單。 tokenLength 可選。 該值可設定為 9 和 255（包括 9 和 255）之間的任意整數。 確定每個受信任票證中的字元數量。預設設定（`24` 個字元）提供 144 位隨機性。除非 `useV2Tickets` 設定為 `true`（不是推薦的最佳做法），否則將忽略此選項。 logLevel 可選。 `all` | `debug` | `info` | `warn` | `error` | `fatal` | `off` 預設值：`info` 指定與建立和兌換受信任的票證相關的處理序記錄層級。請參閱[變更記錄層級](https://help.tableau.com/current/server/zh-tw/logs_debug_level.htm)。 timeoutInSeconds 可選。 預設值：`180` 指定在受信任的票證建立之後使其失效所需的時間長度（以秒為單位）。 tryCount 可選。 整數。 預設值：`10` 指定嘗試建立受信任的票證條目的次數。 use9DigitToken 可選。 `true` | `false` 預設值：`false` 設定為 `true` 時，票證的長度是 9 位數（在版本 8.0 和更低版本中），並忽略 `tokenLength` 選項。此選項用於為舊代碼提供暫時支援。 **警告**：將此選項設定為 `true` 會對受信任票證驗證的安全強度產生嚴重的負面影響。 useV2Tickets 可選。 `true` | `false` 預設值：`false` 指定 Tableau Server 是否應為受信任的票證請求返回舊 URL 格式。舊 URL 格式包括一個由 24 個字元組成的 Base64 編碼字串。從 Tableau Server 10.3 開始，返回的 URL 已更新，並包括一個 Base64 編碼的 UUID，以及一個 24 字元的安全隨機字串。如果您部署的受信任票證包含需要舊 URL 格式的自訂代碼，請僅將此選項設定為 `true`。我們建議改為將自訂代碼更新為接受新 URL 格式。