bg-tutorials

Como instalar um certificado SSL no Tableau Server

Neste tutorial, você aprenderá como instalar um certificado SSL no Tableau Server. O Tableau gerencia o SSL através do Tableau Services Manager (TSM), então os passos são os mesmos no Windows e no Linux. Você pode usar a interface web do TSM ou a linha de comando tsm.

Gerar um código CSR

Vamos começar com a geração do CSR (Certificate Signing Request). Um CSR é um bloco de texto codificado que você envia a uma Autoridade Certificadora ao encomendar o certificado. Gerá-lo também cria a chave privada que você instalará posteriormente no Tableau Server. Você tem duas opções:

Mantenha o arquivo da chave privada em local seguro. Envie o CSR à Autoridade Certificadora durante o seu pedido e, depois que a CA validá-lo e emitir seu certificado SSL, continue com a instalação abaixo.

Instalar um certificado SSL no Tableau Server

Passo 1: Prepare seus arquivos de certificado

Após a validação, a Autoridade Certificadora envia por e-mail os arquivos do certificado. Baixe o arquivo compactado e extraia-o na máquina que você usa para acessar o TSM. Você deverá ter:

  • yourdomain.crt, seu certificado SSL principal.
  • yourdomain.ca-bundle, o arquivo de cadeia com os certificados raiz e intermediário (o CA bundle).
  • yourdomain.key, a chave privada que você gerou junto com o CSR.

O Tableau Server exige que os arquivos de certificado e de cadeia sejam x509, codificados em PEM, e salvos com a extensão .crt (não .pem). Se sua CA entregou um arquivo .pem ou .cer, renomeie a extensão para .crt; o conteúdo não muda. A chave privada deve estar em PEM não criptografado, a menos que você forneça a frase secreta durante a configuração.

Observação sobre o tamanho da chave em 2026: o Tableau Server 2025.3 e versões posteriores é executado com OpenSSL 3.4.x e segurança de Nível 2, o que exige chaves com 2048 bits ou mais. Uma chave de 1024 bits proveniente de uma configuração mais antiga será rejeitada, portanto gere um novo par de chaves de 2048 bits (ou mais forte) se necessário.

Passo 2: Instale o certificado com a interface web do TSM

Abra o Tableau Services Manager em um navegador, substituindo <tsm-host> pelo nome do computador que executa o Tableau Server:

https://<tsm-host>:8850

Faça login com uma conta de administrador do TSM e, em seguida, configure o SSL externo:

  • Abra a aba Configuration e selecione Security > External SSL.
  • Em External web server SSL, marque a caixa Enable SSL for server communication.
  • SSL certificate file: envie seu certificado SSL principal (o arquivo .crt).
  • SSL certificate key file: envie sua chave privada (o arquivo .key).
  • SSL certificate key passphrase: deixe em branco, a menos que sua chave seja protegida por frase secreta.
  • SSL certificate chain file: envie seu CA bundle (certificados raiz e intermediário).

Clique em Save Pending Changes, depois vá até o topo da página e clique em Pending Changes, seguido de Apply Changes and Restart. O Tableau Server será reiniciado para aplicar o novo certificado.

Passo 3 (alternativa): Instale o certificado com a linha de comando tsm

Se preferir a linha de comando, abra um terminal no nó do Tableau Server, faça login no TSM se solicitado, e execute o comando de ativação com os caminhos dos seus três arquivos:

tsm security external-ssl enable --cert-file yourdomain.crt --key-file yourdomain.key --chain-file yourdomain.ca-bundle

Se sua chave privada tiver uma frase secreta, adicione a opção –passphrase. A alteração fica pendente, mas ainda não é aplicada, então aplique-a (isso reinicia o Tableau Server):

tsm pending-changes apply

O TSM avisará que ocorrerá uma reinicialização. Para pular o aviso em uma execução automatizada por script, adicione –ignore-prompt. Depois que os serviços voltarem a funcionar, seu certificado SSL estará instalado no Tableau Server.

Teste sua instalação SSL

Depois que o Tableau Server reiniciar, abra-o via HTTPS (porta 443) e confirme que o navegador mostra um cadeado válido, sem avisos. Para uma verificação mais aprofundada, execute uma verificação externa que identifique problemas de cadeia ou de protocolo. Você pode ler o certificado que o Tableau serve diretamente com o OpenSSL:

echo | openssl s_client -connect yourdomain.com:443 -servername yourdomain.com 2>/dev/null | openssl x509 -noout -issuer -subject -dates

Isso exibe o emissor, o titular e as datas de validade do certificado instalado. Para um relatório completo sobre erros ou vulnerabilidades, use nosso SSL Checker.

Perguntas Frequentes

A instalação de SSL no Tableau Server é diferente entre Windows e Linux?

Não. O SSL é gerenciado pelo Tableau Services Manager (TSM), então os passos da interface web e a linha de comando tsm funcionam da mesma forma tanto no Windows quanto no Linux. A única diferença é como você abre um terminal para executar os comandos.

Qual porta a interface web do TSM utiliza?

A interface de administração do TSM funciona na porta 8850 via HTTPS, então você a acessa em https://<tsm-host>:8850. O próprio Tableau Server serve o tráfego dos usuários pela porta HTTPS padrão 443 depois que o SSL externo é ativado.

Por que meus arquivos de certificado precisam da extensão .crt?

O Tableau Server exige que os arquivos de certificado e de cadeia sejam x509, codificados em PEM, e salvos com a extensão .crt. Se sua CA enviou um arquivo .pem ou .cer, renomeie a extensão para .crt. O conteúdo do arquivo é idêntico, então renomear não altera o certificado.

Preciso reiniciar o Tableau Server depois de instalar o certificado?

Sim. As alterações de SSL ficam em espera como alterações pendentes e só entram em vigor após uma reinicialização. Na interface web, você escolhe Apply Changes and Restart; pela linha de comando, você executa tsm pending-changes apply, que reinicia o Tableau Server automaticamente.

Qual tamanho de chave o Tableau Server exige?

O Tableau Server 2025.3 e versões posteriores usa OpenSSL 3.4.x com segurança de Nível 2, que exige uma chave privada de 2048 bits ou mais. Chaves menores que 2048 bits são rejeitadas, então gere um novo par de chaves de 2048 bits ou mais forte se estiver atualizando a partir de um certificado mais antigo.

Economize 10% em certificados SSL ao fazer seu pedido hoje!

Emissão rápida, criptografia forte, 99,99% de confiança no navegador, suporte dedicado e garantia de reembolso de 25 dias. Código do cupom: SAVE10

Uma imagem detalhada de um dragão em voo
Escrito por

Redator de conteúdo experiente, especializado em certificados SSL. Transformação de tópicos complexos de segurança cibernética em conteúdo claro e envolvente. Contribua para melhorar a segurança digital por meio de narrativas impactantes.