Configuração de certificados personalizados internos para o Tableau Server

Versão: adicionado na versão 2026.3.0

Por padrão, o Tableau Server usa certificados autoassinados para criptografar as comunicações entre serviços e componentes internos.A partir da versão 2026.3.0, os administradores do servidor têm a opção de substituir esses certificados gerados pelo TSM por certificados personalizados emitidos por sua própria PKI corporativa ou autoridade de certificação (CA).Este tópico explica como configurar o Tableau Server para usar certificados personalizados em suas comunicações internas entre serviços, em vez dos certificados autoassinados padrão.(Alguns certificados são específicos de um serviço e outros são para componentes que usam vários serviços.Para simplificar, usamos o termo “serviços” aqui para incluir ambos os casos.)

Observação: os certificados personalizados e comandos do tsm para configurar Tableau Server discutidos aqui são específicos para a comunicação interna entre os serviços do Tableau Server.Esses certificados são diferentes do SSL externo (gateway), que é voltado para navegadores e outros clientes externos.Para obter informações sobre como configurar o SSL externo, consulte Configurar o SSL para tráfego de HTTP externo e do Tableau Server.Recomendamos usar um certificado separado para o SSL do gateway externo.

Por que usar certificados personalizados?

Nem toda instalação do Tableau Server precisa de certificados personalizados, mas para empresas que precisam atender aos requisitos de conformidade de setores regulamentados (FIPS, por exemplo), a capacidade de usar certificados personalizados em vez dos certificados autoassinados é crucial.Eles também podem ser necessários para resolver verificações de segurança que sinalizam certificados internos autoassinados.Suas equipes de TI e segurança devem informar se você precisa usar certificados personalizados.

Serviços compatíveis com certificados personalizados

Os seguintes serviços internos oferecem suporte a certificados personalizados.Use o nome do serviço com a opção --name de tsm security internal-cert set e tsm security internal-cert reset.Para ver os nomes de serviços disponíveis, execute tsm security internal-cert list sem a opção --name.

  • TLS simples (certificado do servidor e chave, com uma cadeia opcional):

    apiGateway, gatewayInternal, hyper, jmx, thrift, tsigLogs, relationshipService, recommendationsService, vizportalMetadataApi e backgrounderMetadataApi

  • TLS mútuo (mTLS), que requer um certificado do cliente e uma chave, além do certificado do servidor:

    activemqMTLS, coordinationService

    Nota: o serviço de coordenação também pode ser configurado com seu próprio comando se optar por usar um certificado separado para isso.Para obter mais informações, consulte (Opcional) Configuração de um certificado personalizado separado para o serviço de coordenação abaixo.

Além disso, tsm security internal-cert set-all orquestra os seguintes subsistemas preexistentes:

  • SSL do repositório (PostgreSQL), SSL do controlador do TSM e OpenSearch (Servidor de índice e pesquisa).

    Ao usar set-all, o certificado do servidor é mapeado para os certificados de nó e de serviço, o certificado do cliente é mapeado para o cliente ActiveMQ e o administrador do OpenSearch, e a cadeia é mapeada para a autoridade de certificação do OpenSearch.

Requisitos de certificado

Os certificados e as chaves que você fornece para esses comandos devem atender aos seguintes requisitos:

  • Os certificados devem ser certificados X.509 codificados por PEM.As chaves privadas devem estar no formato PKCS#1 ou PKCS#8.

  • Os algoritmos de chave RSA e ECC (EC/ECDSA) são aceitos.As chaves DSA são rejeitadas.

  • Chaves criptografadas são aceitas.Use as opções --passphrase e --client-passphrase para fornecer a frase secreta.

  • Fornecer um arquivo de cadeia é opcional, mas a maioria das implantações exige um.Para uma autoridade de certificação privada ou interna, a autoridade de certificação raiz deve ser incluída na cadeia.A autoridade de certificação raiz pode ser omitida apenas se o certificado tiver sido emitido por uma autoridade de certificação pública conhecida em que a JVM já confia.A autoridade de certificação raiz também deve ser instalada no sistema operacional e no armazenamento confiável do Java em todos os nós.

  • Verificação do nome do host: o certificado do controlador do TSM deve incluir o nome de domínio totalmente qualificado (FQDN) do nó do controlador como o nome comum (CN) ou como um nome alternativo do assunto (SAN) do DNS—por exemplo, DNS:<value returned by the Linux hostname command>.Isso por si só atende à validação.Outros certificados internos não validam nomes de host no momento.Para manter o certificado válido se o controlador do TSM for movido para um nó diferente, emita o certificado com SANs que cubram todos os nós no cluster que possam executar o controlador ou use um SAN curinga para o domínio compartilhado (por exemplo, DNS:*.corp.example.com).

  • Uso estendido de chave (EKU): não defina o EKU como serverAuth ou clientAuth isoladamente.É possível deixar a EKU sem definição ou defini-la para ambos os valores, mas não para um individualmente.

Configurar Tableau Server com certificados personalizados para comunicação interna

O Tableau Server recurso de certificados personalizados apresenta uma série de novos comandos da CLI do TSM.Eles permitem que os administradores designem certificados que o Tableau Server deve usar para a comunicação entre serviços internos.Os novos comandos incluem uma série de subcomandos em tsm security internal-cert e uma série semelhante de subcomandos em tsm security coordination-service-internal-cert que são específicos do serviço de coordenação.

Configuração de certificados personalizados para serviços individuais

Um administrador do servidor pode definir um certificado personalizado para serviços individuais.

Para configurar certificados personalizados por serviço individual:

Configuração de certificados personalizados em massa

Um administrador do servidor também pode definir certificados personalizados em massa, para todos os serviços aplicáveis.

Para configurar certificados personalizados em massa (todos os serviços aplicáveis):

Observação: Para excluir serviços específicos ao usar os comandos set-all ou reset-all, use a opção --exclude <service>.

(Opcional) Configuração de um certificado personalizado separado para o serviço de coordenação

O certificado do serviço de coordenação (ZooKeeper) pode ser configurado separadamente usando os comandos tsm security coordination-service-internal-cert e tem requisitos e limitações específicos.Talvez você queira configurar o serviço de coordenação separadamente por motivos de segurança ou para limitar o impacto se algo der errado e for necessário redefinir um certificado.

Se houver problemas com o certificado do serviço de coordenação, é necessário executar etapas específicas para evitar uma reinstalação completa com backup do Tableau Server.Para obter mais informações, consulte Recuperação de um certificado personalizado do serviço de coordenação.

Tópicos relacionados

Agradecemos seu feedback!Seu feedback foi enviado. Obrigado!