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,vizportalMetadataApiebackgrounderMetadataApiTLS mútuo (mTLS), que requer um certificado do cliente e uma chave, além do certificado do servidor:
activemqMTLS,coordinationServiceNota: 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
--passphrasee--client-passphrasepara 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
serverAuthouclientAuthisoladamente.É 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:
Usar
tsm security internal-cert listpara visualizar os certificados internos configurados.Usar
tsm security internal-cert resetpara redefinir um certificado interno de um serviço especificado de volta ao certificado autoassinado padrão.Usar
tsm security internal-cert setde configurar um certificado interno para um serviço especificado.Usar
tsm security coordination-service-internal-cert setconfigurar um certificado interno para o serviço de coordenação.
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):
Usar
tsm security internal-cert listpara visualizar os certificados internos configurados.Usar
tsm security internal-cert reset-allpara redefinir os certificados internos de todos os serviços aplicáveis de volta ao certificado padrão e autoassinado.Usar
tsm security internal-cert set-allconfigurar um certificado interno para 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.
Usar
tsm security coordination-service-internal-cert listpara exibir o certificado interno configurado para o Serviço de coordenação.Usar
tsm security coordination-service-internal-cert resetredefinir um certificado interno do Serviço de Coordenação de volta ao certificado padrão, autoassinado.Usar
tsm security coordination-service-internal-cert setpara configurar um certificado personalizado para o Serviço de coordenação.
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.
