--- schema_version: "1" id: a9b8baca1ebfaf7e56d2f24f2f265a8b06145821339d2d6b6d5821f606579300 title: 将自定义域与 Tableau Cloud 配合使用 collection: tableau version: next locale: zh-cn portal_url: https://docs.salesforce.com/tableau/next/zh-cn/online/custom_domain.md canonical_url: https://help.tableau.com/v0.0/online/zh-cn/custom_domain.htm source_site: help.tableau.com content_type: documentation content_hash: 06c1004de32325304e0c9c9b2a26a7844fb84df433cb85d476f8896da91622a5 description: Use a custom domain to redirect traffic to your Tableau Cloud site, with TLS and SAML considerations. --- [跳转到主要内容](#main-content) # 将自定义域与 Tableau Cloud 配合使用 您可以使用自定义域将流量重定向到您的 Tableau Cloud 站点。自定义域允许您配置子域（如 `analytics.example.com`），以便嵌入和访问已发布的内容，而不会暴露 Tableau 站点详细信息。使用自定义域，您可以使用组织的 URL 将用户定向到内容。 本主题介绍如何在 Tableau Cloud 站点设置中配置自定义域。有关使用 Tableau REST API 配置自定义域的信息，请参见 [Tableau REST API OpenAPI 端点](https://help.tableau.com/current/api/rest_api/zh-cn/REST/TAG/index.html#tag/Custom-Domain-Methods)。 ## 开始之前 若要将自定义域添加到 Tableau Cloud，您必须满足以下用户和 TLS 证书要求。 ### 用户要求 - **Tableau Cloud 站点的管理员访问权限。**您必须对要添加自定义域的 Tableau Cloud 站点具有管理员访问权限。 - **父域的 DNS 配置的管理员权限。**您必须具有管理员权限才能将 CNAME 记录添加到父域的 DNS 配置中。 父域是 DNS 分层结构中的主域。它包含子域或次级域。例如，`example.com` 是父域，而子域（例如 `abc.example.com` 或 `xyz.example.com` ）位于它下面。 ### TLS 证书要求 从受信任的颁发机构（例如 Verisign、Thawte、Comodo、GoDaddy）获取有效的 TLS 证书链文件和私钥。您无法使用您的组织颁发的内部证书。 获取自定义域的 TLS 证书时，请遵循以下准则和要求： - **包含完整证书链的 TLS 证书。**TLS 证书必须按身份证书 > 中间证书 > 根证书的顺序包括完整的证书链。 - **有效的 PEM 编码 x509 证书。**所有证书文件必须是有效的 PEM 编码 x509 证书。 - **SHA-256 用作签名算法。**证书文件必须使用 SHA-2（256 位或 512 位）签名哈希。 - **RSA 用作加密算法。**证书文件必须使用 RSA 加密算法。 - **与自定义域匹配的公用名称。**证书公用名称 (CN) 必须与在 Tableau Cloud 的“设置”页面上输入的自定义域匹配。Tableau 不支持通配符证书（例如 `*.example.com`），也不会检查“使用者备用名称 (SAN)”字段。 - **90 天至 365 天内过期。**证书到期日期必须在颁发之日起 90 天到 365 天内。公开受信任的 TLS 证书的最长有效期为 397 天，其中包括提供商提供的标准 30 天宽限期。 **注意：**添加或替换证书时，它必须自上载日期起至少还有 88 天的剩余有效期。 - **有效的 RSA 私钥文件。**除了证书文件外，上载对应的 TLS 证书密钥文件。密钥文件必须是扩展名为 `.key` 的有效 RSA 私钥，并且位长度为 2048 位或更高。 ### PEM 编码文件示例 此示例显示 PEM 编码的证书和私钥文件的格式。为便于说明，内容已缩短。 > [!IMPORTANT] > > **重要信息：** 证书链文件必须以 `-----BEGIN CERTIFICATE-----` 开头。此外，不要在证书链文件的 `-----END` 和 `-----BEGIN` 部分之间包含注释。 **证书链文件** \-----BEGIN CERTIFICATE----- MIIGiTCCBHGgAwIBAgIIY5dpPr2gQjowDQYJKoZIhvcNAQENBQAwgYsxCzAJBgNV ... A7jcIyoWtoPP1rZ3VjP4LIVVro8pce7MNtD9CzUYN8kQk1iftBKWjcCd20Km -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- MIIGqzCCBJOgAwIBAgIIYifB1rX/1pAwDQYJKoZIhvcNAQELBQAwgYUxCzAJBgNV ... g+qyDLoAy/td0D8ha8SlWt5ee2cAF9Xu7Y9jNe21Ug== -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- MIIDpjCCAyugAwIBAgIQDTYMRISRziTtCzVA2HCg3TAKBggqhkjOPQQDAzBhMQsw ... 7LX35CV+ypuVTbKZkjATTvROgmL5AgTbsAg= -----END CERTIFICATE----- **私钥文件** \-----BEGIN PRIVATE KEY----- MIIEpAIBAAKCAQEAgN9TePjxsgvjZ8QERQILf3YbofaBHGks5E3k9dRP0cx7sw1O ... xpAh+dRkr0vjsj/ZnJyYfaUQDcV4wslFcn6eKoINEQrtBj40P1iqig== -----END PRIVATE KEY----- ## 与 SAML 单点登录 (SSO) 的兼容性 如果您的 Tableau Cloud 站点使用 SAML 身份验证，您必须在添加自定义域后更新身份提供程序 (IdP) 配置。具体而言，请更新 IdP 中的以下值以反映您站点的自定义域： - 实体 ID - ACS URL 有关配置 SAML 身份验证的详细信息，请参见[SAML](https://help.tableau.com/v0.0/online/zh-cn/saml.htm)。 **注意：**从 2026 年 6 月开始，自定义域支持 [SCIM](https://help.tableau.com/current/online/zh-cn/scim_config_online.htm) 集成。 ## 与自定义 OAuth 连接的兼容性 配置新的 OAuth 客户端时，请为“重定向 URL”使用自定义域。举例来说，如果自定义域为 `analytics.example.com`，则重定向 URL 为 `https://analytics.example.com/auth/add_oauth_token`。无论您的自定义域配置如何，现有工作簿都将继续按预期运行。有关自定义 OAuth 客户端的详细信息，请参见[OAuth 连接](https://help.tableau.com/v0.0/online/zh-cn/protected_auth.htm)。 ## 为您的站点添加自定义域 若要将自定义域添加到 Tableau Cloud 站点，请使用以下部分中的步骤。 ### 添加域名 1. 以管理员身份登录到 Tableau Cloud 站点，然后选择“设置”。 2. 在“常规”选项卡上，滚动到“自定义域”。 3. 为您的站点输入域名。值必须是子域。Tableau 不支持为自定义域使用父域，例如 `example.com`。 4. 选择“保存”。 ![三步自定义域设置界面，显示添加域名的有效第一步。](/tableau/next/zh-cn/online/zh-cn/Img/custom_domain_add.png) ### 验证 CNAME 1. 使用步骤 1 中显示的“Tableau 创建域” ，在 DNS 配置中创建 CNAME 记录。此步骤在外部 Tableau Cloud 执行，并且需要组织中的网络管理员访问权限。CNAME 验证在添加自定义域 48 小时后过期，此时您必须重新启动该过程。 > [!TIP] > > **提示：**为 CNAME 记录使用 30–60 分钟的生存时间 (TTL) 值。 2. 选中该复选框以确认您已创建了从所选自定义域到 DNS 配置中的 Tableau CNAME 的 CNAME 记录。 3. 选择“验证”。 ![自定义域设置界面，显示已完成的域名步骤和活动的 CNAME 验证步骤。](/tableau/next/zh-cn/online/zh-cn/Img/custom_domain_validate.png) ### 上载 TLS 证书和私钥 1. 上载与自定义域关联的完整证书链和私钥文件。证书链必须包括根证书、中间证书和最终用户证书。有关证书要求的详细信息，请参见 [TLS 证书要求](#TLS-certificate-requirements)。 2. 选择“保存”。 ![自定义域设置界面，显示已完成的域名和 CNAME 验证步骤以及活动的 TLS 证书上载步骤。](/tableau/next/zh-cn/online/zh-cn/Img/custom_domain_upload_cert.png) 成功上载文件后，预置域最多可能需要 60 分钟。状态通知在预置过程中出现，并在自定义域可用时消失。 ![自定义域界面，显示预置状态横幅和当前配置详细信息。](/tableau/next/zh-cn/online/zh-cn/Img/custom_domain_provision.png) ## 使用自定义域时应该做什么 使用自定义域时，用户界面会稍作更改。 - 地址栏中的 URL 显示自定义域，而不是托管您站点的 Tableau Cloud pod。此更改不会影响登录，用户仍然可以通过 [https://online.tableau.com](https://online.tableau.com/) 访问站点。 - “共享”对话框链接和嵌入代码指向自定义域，而不是托管您站点的 Tableau Cloud pod。这是因为对话框使用当前 URL 中的信息填充字段。对于之前共享或嵌入的内容，URL 将继续引用 Tableau Cloud pod。若要改用自定义域，您必须使用新的“共享”对话框值更新以前的链接。有关共享 Tableau 内容的详细信息，请参见 Tableau Desktop 帮助中的[共享 Web 内容](https://help.tableau.com/current/pro/desktop/zh-cn/shareworkbooks.htm)。 - 对于属于多个站点的用户，在访问具有自定义域的内容时，站点选择器不可用。若要切换站点，请注销并向所需站点进行身份验证。 ## 替换或更新 TLS 证书 在 TLS 证书和密钥文件即将过期时或您的组织需要时替换它们。证书到期日期显示在“设置”页面的“自定义域”部分。 替换 TLS 证书和私钥文件： 1. 以管理员身份登录到 Tableau Cloud 站点，然后选择“设置”。 2. 在“常规”选项卡上，滚动到“自定义域”。 3. 选择“替换证书”，然后按照[上载 TLS 证书](#upload-certificate-and-private-key)中列出的步骤操作。替换证书的剩余有效期必须至少为 88 天。如果证书在上载日期后不到 88 天后过期，则上载将失败。 ![自定义域界面，显示预置状态横幅、当前配置详细信息以及活动证书和私钥上载字段。](/tableau/next/zh-cn/online/zh-cn/Img/custom_domain_replace_update.png) ## 移除自定义域 移除自定义域时，用于共享和嵌入内容的 URL 将不再可用。为避免链接断开，请让用户在移除域之前更新其书签和嵌入的内容。更新后的 URL 必须使用托管其站点的 Tableau Cloud pod 的名称。有关 Tableau Cloud pod 的列表，请参见 [Salesforce 信任](https://status.salesforce.com/products/Tableau)。 若要从站点中移除自定义域，请执行以下操作： 1. 以管理员身份登录到 Tableau Cloud 站点，然后选择“设置”。 2. 在“常规”选项卡上，滚动到“自定义域”。 3. 选择“移除域”\>“移除”。 ![显示“移除域”确认对话框的自定义域界面。](/tableau/next/zh-cn/online/zh-cn/Img/custom_domain_remove.png) ## 疑难解答 ### 添加 CNAME 记录时延迟 DNS 传播 如果在将 CNAME 记录添加到 DNS 配置时遇到延迟，请验证 CNAME 是否反映预期的映射。您可以使用诸如 `dig` 和 `nslookup` 之类的命令行工具来验证 CNAME 映射。 ### 证书错误 若要更正证书错误，请按照屏幕上的说明进行操作，并验证证书是否符合 [TLS 证书要求](#TLS-certificate-requirements)。