| 宣告 | 名稱 | 描述或所需值 |
「kid」 | 主要識別碼 | 必需（在標頭中）。來自身分提供者的唯一金鑰識別碼。 |
「iss」 | 簽發者 | 必需（在標頭或作為聲明）。唯一簽發者 URI 會標識受信任的已連線應用程式及其簽署金鑰。 |
「alg」 | 演算法 | 必需（在標頭中）。JWT 簽署演算法。javadoc.io 文件中 Class JWSAlgorithm 頁面中列出了支援的演算法名稱。可以使用 vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms設定簽章演算法。 |
「sub」 | 主體 | 經過驗證的 Tableau Server 使用者的使用者名稱。 |
「aud」 | 受眾 | 值必須是：「 |
「exp」 | 到期時間 | 有效的 JWT 不得到期。JWT 的過期時間（UTC 時間）必須在設定的最長有效期內。可以使用 vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes命令配置最大有效期限。 |
「jti」 | JWT ID | JWT ID 宣告為 JWT 提供唯一識別碼，並且區分大小寫。 |
「scp」 | 範圍 | 如果是嵌入工作流程，支援的值包括： 「 附註：
有關 REST API 授權工作流程，請參閱支援 JWT 授權的 REST API 方法。 如果是 使用 REST API 進行驗證的中繼資料 API 工作流程，唯一支援的範圍是 對於使用 REST API 進行驗證的 VizQL 資料服務工作流程，唯一支援的範圍是 |
https://tableau.com/groups | 動態群組成員資格 | 僅用於內嵌工作流程。 值必須與 Tableau Serve 中的一個或多個群組的名稱相符。有關詳情，請參閱使用聲明的動態群組成員資格。 |
| （使用者屬性） | （使用者屬性值） | 僅用於內嵌工作流程。 從 Tableau Server 2025.1 開始，您可以在 JWT 中包含使用者屬性。然後，在內嵌內容中使用使用者屬性函數時，Tableau 會檢查經過驗證的使用者的內容，並決定哪些資料可以在執行時顯示。 附註：
|
| 錯誤程式碼 | 彙總 | 描述 | 潛在的解決方案或解釋 |
| 5 | SYSTEM_USER_NOT_FOUND | 找不到 Tableau 使用者 | 要解決此問題，請驗證 JWT 中的「 sub」（主題）宣告值為經過驗證的 Tableau Server 的「使用者名稱」。此值區分大小寫。 |
| 16 | LOGIN_FAILED | 登入失敗 | 此錯誤通常是由 JWT 中的以下宣告問題之一引起的：
|
| 67 | FEATURE_NOT_ENABLED | 不支援隨需存取 | 僅可透過獲得授權的 Tableau Cloud 站台進行隨需存取。 |
| 10081 | COULD_NOT_RETRIEVE_IDP_METADATA | 缺少 EAS 元中繼資料端點 | 要解決此問題，請驗證 EAS 配置正確並且呼叫正確的簽發者。 |
| 10082 | AUTHORIZATION_SERVER_ISSUER_NOT_SPECIFIED | 缺少簽發者 | 要解決此問題，請驗證呼叫的是正確的簽發者。要變更簽發者 URL，可以使用 vizportal.oauth.external_authorization_server.issuer命令。 |
| 10083 | BAD_JWT | JWT 標頭含有問題 | JWT 標頭中缺少「kid」（密碼 ID）或「clientId」（簽發者）宣告。要解決此問題，請確保包含此資訊。 |
| 10084 | JWT_PARSE_ERROR | JWT 含有問題 | 要解決此問題，請驗證以下內容：
|
| 10085 | COULD_NOT_FETCH_JWT_KEYS | JWT 找不到金鑰 | 找不到密碼。 要解決此問題，請驗證呼叫的是正確的簽發者。要變更簽發者 URL，可以使用 vizportal.oauth.external_authorization_server.issuer命令。 |
| 10087 | BLOCKLISTED_JWS_ALGORITHM_USED_TO_SIGN | JWT 簽章演算法的問題 | 要解決此問題，可以移除簽章演算法。有關詳情，請參閱 vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms。 |
| 10088 | RSA_KEY_SIZE_INVALID | JWT 簽章要求問題 | 要解決此問題，請使用 EAS 或 IdP 驗證 JWT 是否使用大小為 2048 的 RSA 金鑰進行簽章。 |
| 10091 | JTI_ALREADY_USED | 需要唯一的 JWT | JWT 已經用於身份驗證過程。要解決此問題，EAS 或 IdP 必須產生新的 JWT。 |
| 10092 | NOT_IN_DOMAIN_ALLOW_LIST | 未指定內嵌內容的網域 | 要解決此問題，請確保將 unrestrictedEmbedding 設定設定為 true，或者讓 domainAllowlist 參數包括使用 Tableau REST API 中更新站台的內嵌設定的方法內嵌 Tableau 內容的網域。 |
| 10094 | MISSING_REQUIRED_JTI | 缺少 JWT ID | 要解決此問題，請驗證 JWT 中包含「jti」（JWT ID）。 |
| 10096 | JWT_EXPIRATION_EXCEEDS_CONFIGURED_EXPIRATION_PERIOD | 「exp」（到期時間）超過預設的最大有效期限。要解決此問題，請查看有效 JWT 所需的已註冊宣告並確保使用正確的值。要更改最長有效期限，可以使用 vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes命令。 | |
| 10097 | SCOPES_MALFORMED | 範圍宣告問題 | 如果 JWT 中缺少「scp」(Scope) 宣告，或未作為清單類型傳遞，則會出現此錯誤。要解決此問題，請驗證 JWT 中包含「scp」，並作為清單類型傳遞。有關 JWT 的疑難排解說明，請參閱 auth0 站台上的偵錯工具。 |
| 10098 | JWT_UNSIGNED_OR_ENCRYPTED | JWT 未簽章或加密 | Tableau 不支援未簽章或加密的 JWT。 |
| 10099 | SCOPES_MISSING_IN_JWT | 缺少範圍宣告 | JWT 缺少所需的「scp」（範圍）宣告。要解決此問題，請驗證 JWT 中包含「scp」。有關 JWT 的疑難排解說明，請參閱 auth0 站台上的偵錯工具。 |
| 10100 | JTI_PERSISTENCE_FAILED | 意外的 JWT ID 錯誤 | 出現「jti」（JWT 識別碼）意外錯誤。要解決此問題，必須產生具有新的「jti」的新 JWT。 |
| 10103 | JWT_MAX_SIZE_EXCEEDED | JWT 超出最大大小 | 當 JWT 大小超過 8000 位元時，可能會發生此錯誤。要解決此問題，請確保僅將必要的宣告傳遞給 Tableau Server。 |