--- schema_version: "1" id: b9a0cf5218490e1e020f0af5a903fab49355956821c4b1c2ec6400a6e510738e title: Usar um domínio personalizado com Tableau Cloud collection: tableau version: current locale: pt-br portal_url: https://docs.salesforce.com/tableau/current/pt-br/online/custom_domain.md canonical_url: https://help.tableau.com/current/online/pt-br/custom_domain.htm source_site: help.tableau.com content_type: documentation content_hash: f6a8d57e500ee5398d8429a0a42c432e51996019011cec7587d3cb614b5ccc44 description: Use a custom domain to redirect traffic to your Tableau Cloud site, with TLS and SAML considerations. --- [Pular para o conteúdo principal](#main-content) # Usar um domínio personalizado com Tableau Cloud Você pode usar um domínio personalizado para redirecionar o tráfego para o seu site Tableau Cloud. Um domínio personalizado permite que você configure um subdomínio, como `analytics.example.com`, para incorporar e acessar conteúdo publicado sem expor os detalhes do site do Tableau. Com um domínio personalizado, você pode direcionar usuários para o conteúdo usando a URL da sua organização. Este tópico descreve como configurar um domínio personalizado nas configurações do site do Tableau Cloud. Para obter informações sobre como configurar um domínio personalizado usando a API REST do Tableau, consulte [Endpoints OpenAPI da API REST do Tableau](https://help.tableau.com/current/api/rest_api/pt-br/REST/TAG/index.html#tag/Custom-Domain-Methods). ## Antes de começar Para adicionar um domínio personalizado ao Tableau Cloud, você deve atender aos requisitos de certificado de usuário e TLS a seguir. ### Requisitos de usuário - **Acesso do administrador ao site do Tableau Cloud.** Você deve ter acesso de administrador ao site do Tableau Cloud no qual deseja adicionar um domínio personalizado. - **Privilégios de administrador para a configuração DNS do domínio pai.** Você deve ter privilégios de administrador para adicionar registros CNAME à configuração DNS do domínio pai. Um domínio pai é o domínio primário em uma hierarquia de DNS. Contém domínios filhos ou subdomínios. Por exemplo, `example.com` é um domínio pai, enquanto subdomínios como `abc.example.com` ou `xyz.example.com` ficam abaixo dele. ### Requisitos do certificado TLS Adquira um arquivo de cadeia do certificado TLS válido e uma chave privada de uma autoridade confiável (por exemplo, Verisign, Thawte, Comodo, GoDaddy). Você não pode usar um certificado interno emitido por sua organização. Ao adquirir um certificado TLS para o domínio personalizado, siga estas diretrizes e requisitos: - **Certificado TLS que inclui a cadeia de certificado completa.** O certificado TLS deve incluir a cadeia de certificado completa na ordem do certificado de identidade > certificado intermediário > certificado raiz. - **Certificados x509 codificados por PEM válidos.** Todos os arquivos de certificado devem ser certificados x509 codificados por PEM válidos. - **SHA-256 é usado como o algoritmo de assinatura.** Os arquivos de certificado devem usar o hash de assinatura SHA-2 (256 bits ou 512 bits). - **RSA é usado como o algoritmo de criptografia.** Os arquivos de certificado devem usar o algoritmo de criptografia RSA. - **Nome comum que corresponde ao domínio personalizado.** O nome comum (CN) do certificado deve corresponder ao domínio personalizado inserido na página Configurações do Tableau Cloud. O Tableau não oferece suporte a certificados curinga (wildcard), como `*.example.com`, nem verifica o campo Subject Alternate Name (SAN). - **Expiração dentro de 90 dias a 365 dias.** A data de expiração do certificado deve estar entre 90 e 365 dias a partir da data de emissão. O período máximo de validade para certificados TLS publicamente confiáveis é de 397 dias, o que inclui o período de carência padrão de 30 dias do provedor. **Observação:** quando você adiciona ou substitui um certificado, ele deve ter pelo menos 88 dias de validade restante a partir da data de carregamento. - **Arquivo de chave privada RSA válido.** Além do arquivo de certificado, faça upload de um arquivo de chave do certificado TLS correspondente. O arquivo de chave deve ser uma chave privada RSA válida com extensão `.key` e ter um comprimento de 2048 bits ou superior. ### Exemplo de arquivo codificado por PEM Este exemplo mostra o formato para arquivos de certificado codificado por PEM e de chave privada. O conteúdo foi encurtado para fins de ilustração. > [!IMPORTANT] > > **Importante:** o arquivo de cadeia de certificado deve começar com `-----BEGIN CERTIFICATE-----`. Além disso, não inclua comentários entre as seções `-----END` e `-----BEGIN` do arquivo de cadeia de certificado. **Arquivo de cadeia de certificado** \-----BEGIN CERTIFICATE----- MIIGiTCCBHGgAwIBAgIIY5dpPr2gQjowDQYJKoZIhvcNAQENBQAwgYsxCzAJBgNV ... A7jcIyoWtoPP1rZ3VjP4LIVVro8pce7MNtD9CzUYN8kQk1iftBKWjcCd20Km -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- MIIGqzCCBJOgAwIBAgIIYifB1rX/1pAwDQYJKoZIhvcNAQELBQAwgYUxCzAJBgNV ... g+qyDLoAy/td0D8ha8SlWt5ee2cAF9Xu7Y9jNe21Ug== -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- MIIDpjCCAyugAwIBAgIQDTYMRISRziTtCzVA2HCg3TAKBggqhkjOPQQDAzBhMQsw ... 7LX35CV+ypuVTbKZkjATTvROgmL5AgTbsAg= -----END CERTIFICATE----- **Arquivo de chave privada** \-----BEGIN PRIVATE KEY----- MIIEpAIBAAKCAQEAgN9TePjxsgvjZ8QERQILf3YbofaBHGks5E3k9dRP0cx7sw1O ... xpAh+dRkr0vjsj/ZnJyYfaUQDcV4wslFcn6eKoINEQrtBj40P1iqig== -----END PRIVATE KEY----- ## Compatibilidade com logon único (SSO) do SAML Se o seu site do Tableau Cloud usar a autenticação SAML, você deverá atualizar a configuração do seu provedor de identidade (IdP) após adicionar um domínio personalizado. Especificamente, atualize os seguintes valores no seu IdP para refletir o domínio personalizado do site: - ID da entidade - URL do ACS Para obter mais informações sobre como configurar a autenticação SAML, consulte [SAML](https://help.tableau.com/current/online/pt-br/saml.htm). **Observação:** a partir de junho de 2026, os domínios personalizados são compatíveis com a integração do [SCIM](https://help.tableau.com/current/online/pt-br/scim_config_online.htm). ## Compatibilidade com conexões OAuth personalizadas Ao configurar um novo cliente OAuth, use seu domínio personalizado para a URL de redirecionamento. Por exemplo, se o seu domínio personalizado for `analytics.example.com`, a URL de redirecionamento será `https://analytics.example.com/auth/add_oauth_token`. As pastas de trabalho existentes continuam funcionando conforme o esperado, independentemente da sua configuração de domínio personalizado. Para obter mais informações sobre clientes OAuth personalizados, consulte [Conexões OAuth](https://help.tableau.com/current/online/pt-br/protected_auth.htm). ## Adicionar um domínio personalizado ao seu site Para adicionar um domínio personalizado ao seu site do Tableau Cloud, use as etapas nas seções a seguir. ### Adicionar nome de domínio 1. Entre em um site do Tableau Cloud como um administrador e selecione Configurações. 2. Na guia Geral, role até Domínio personalizado. 3. Insira um nome de domínio para o seu site. O valor deve ser um subdomínio. O Tableau não oferece suporte a domínios pais, como `example.com`, para o domínio personalizado. 4. Selecione Salvar. ![Uma interface de configuração de domínios personalizados de três etapas mostrando uma primeira etapa ativa para adicionar um nome de domínio.](/tableau/current/pt-br/online/pt-br/Img/custom_domain_add.png) ### Validar CNAME 1. Usando o Domínio criado pelo Tableau exibido na Etapa 1, crie um registro CNAME em sua configuração DNS. Esta etapa é realizada fora do Tableau Cloud e requer acesso de administrador de rede em sua organização. A validação CNAME expira 48 horas após a adição do domínio personalizado, quando você deve reiniciar o processo. > [!TIP] > > **Dica:** use um valor de vida útil (TTL) de 30 a 60 minutos para o registro CNAME. 2. Marque a caixa de seleção para confirmar que você criou um registro CNAME do domínio personalizado escolhido para o CNAME do Tableau em sua configuração DNS. 3. Selecione Validar. ![Uma interface de configuração de domínios personalizados mostrando uma etapa concluída de nome de domínio e uma etapa de validação CNAME ativa.](/tableau/current/pt-br/online/pt-br/Img/custom_domain_validate.png) ### Carregar o certificado TLS e a chave privada 1. Carregue os arquivos da cadeia de certificado completa e da chave privada associados ao domínio personalizado. A cadeia de certificado deve incluir certificados raiz, intermediários e de usuário final. Para obter mais informações sobre os requisitos de certificado, consulte [Requisitos do certificado TLS](#TLS-certificate-requirements). 2. Selecione Salvar. ![Uma interface de configuração de domínio personalizado mostrando as etapas concluídas de validação de nome de domínio e CNAME e uma etapa de upload do certificado TLS ativo.](/tableau/current/pt-br/online/pt-br/Img/custom_domain_upload_cert.png) Depois que os arquivos forem carregados com sucesso, o provisionamento do domínio pode levar até 60 minutos. Uma notificação de status aparece enquanto o provisionamento está em andamento e desaparece quando o domínio personalizado está disponível. ![Uma interface de domínio personalizado que mostra um banner de status de provisionamento e detalhes da configuração atual.](/tableau/current/pt-br/online/pt-br/Img/custom_domain_provision.png) ## O que esperar ao usar um domínio personalizado Quando você usa um domínio personalizado, algumas alterações na interface do usuário se aplicam. - A URL na barra de endereço mostra o domínio personalizado em vez do pod do Tableau Cloud que hospeda seu site. Essa alteração não afeta o logon. Os usuários ainda podem acessar o site em [https://online.tableau.com](https://online.tableau.com/). - O link da caixa de diálogo Compartilhar e o código inserido apontam para o domínio personalizado em vez do pod do Tableau Cloud que hospeda seu site. Isso acontece porque a caixa de diálogo preenche campos usando informações da URL atual. Para o conteúdo que foi compartilhado ou inserido anteriormente, a URL continua a fazer referência ao pod do Tableau Cloud. Para usar o domínio personalizado, atualize os links anteriores usando os novos valores da caixa de diálogo Compartilhar. Para obter mais informações sobre como compartilhar o conteúdo do Tableau, consulte [Compartilhar conteúdo da Web](https://help.tableau.com/current/pro/desktop/pt-br/shareworkbooks.htm) na ajuda do Tableau Desktop. - Para usuários que são membros de vários sites, o seletor de sites não está disponível ao acessar conteúdo com um domínio personalizado. Para alternar sites, saia e autentique-se no site que você deseja. ## Substituir ou atualizar o certificado TLS Substitua o certificado TLS e os arquivos de chave à medida que se aproximam do vencimento ou quando sua organização exigir. A data de expiração do certificado é exibida na seção Domínio personalizado da página Configurações. Para substituir os arquivos de certificado TLS e de chave privada: 1. Entre em um site do Tableau Cloud como um administrador e selecione Configurações. 2. Na guia Geral, role até Domínio personalizado. 3. Selecione Substituir certificado e siga as etapas listadas em [Carregar certificado TLS](#upload-certificate-and-private-key). O certificado de substituição deve ter pelo menos 88 dias de validade restante. Se o certificado expirar em menos de 88 dias a partir da data de carregamento, o carregamento falhará. ![Uma interface de domínio personalizado mostrando um banner de status de provisionamento, detalhes da configuração atual e campos de upload de certificado ativo e de chave privada.](/tableau/current/pt-br/online/pt-br/Img/custom_domain_replace_update.png) ## Remover o domínio personalizado Quando você remove um domínio personalizado, as URLs usadas para compartilhar e inserir conteúdo não estão mais disponíveis. Para evitar links quebrados, peça aos usuários que atualizem seus favoritos e qualquer conteúdo incorporado antes de remover o domínio. As URLs atualizadas devem usar o nome do pod Tableau Cloud que hospeda o site. Para obter a lista de pods do Tableau Cloud, consulte [Salesforce Trust](https://status.salesforce.com/products/Tableau). Para remover o domínio personalizado do seu site: 1. Entre em um site do Tableau Cloud como um administrador e selecione Configurações. 2. Na guia Geral, role até Domínio personalizado. 3. Selecione Remover domínio > Remover. ![Uma interface de domínio personalizado exibindo uma caixa de diálogo de confirmação da ação Remover domínio.](/tableau/current/pt-br/online/pt-br/Img/custom_domain_remove.png) ## Solução de problemas ### Propagação de DNS atrasada ao adicionar um registro CNAME Se ocorrer um atraso ao adicionar o registro CNAME à sua configuração DNS, verifique se o CNAME reflete o mapeamento esperado. Você pode usar ferramentas de linha de comando, como `dig` e `nslookup`, para verificar o mapeamento CNAME. ### Erros de certificado Para corrigir erros de certificado, siga as instruções na tela e verifique se o certificado atende aos [requisitos do certificado TLS](#TLS-certificate-requirements).