Como configurar o Tomcat

Este documento fornece informações sobre como configurar o perfil de publicação Tomcat para que seja possível instalar e publicar certificados no servidor.

Requisitos

O serviço do Tomcat no servidor deve se chamar tomcat. O Segura® reinicia o Tomcat com systemctl stop tomcat e systemctl start tomcat, ou com o comando service tomcat, e o nome do serviço é fixo.

Modos de publicação

O Segura® publica o certificado em um de dois modos, dependendo dos campos preenchidos:

• Keystore: se você preencher os campos Nome da keystore, Alias do certificado e Senha da keystore, o Segura® publica o certificado diretamente na keystore e ignora o arquivo server.xml.
• server.xml: se algum desses campos estiver vazio, o campo Caminho do arquivo de configuração (server.xml) é obrigatório.

Configurar o Tomcat

Para configurar o Tomcat, veja os passos a seguir:

1. No Segura™, na barra de navegação, passe o mouse sobre o Menu de produtos e selecione Certificate Manager.
2. No menu lateral, selecione Publicações > Perfis de publicação.
3. Clique no botão de ações e selecione Tomcat.
4. Na aba Configurações, preencha os seguintes campos:
   1. No campo Nome do perfil *, insira o nome do perfil.
   2. No campo Username da credencial, insira o nome da credencial.
   3. (Opcional): Marque a opção Utilizar uma credencial cadastrada para acessar todos os dispositivos, e, no campo Credencial de acesso cadastrada do sistema, selecione uma credencial de acesso cadastrada no Segura™.
5. Clique em Continuar.
6. Na aba Tomcat, preencha os seguintes campos:
   1. No campo Nome da keystore, insira o caminho completo da keystore. Por exemplo: /opt/tomcat9/keystore.jks. Caso a keystore não exista, ela é criada automaticamente.
   2. No campo Alias do certificado, insira o alias do certificado. Caso o alias não exista, ele é criado automaticamente.
   3. No campo Senha da keystore, selecione a credencial que contém a senha da keystore. A credencial precisa estar previamente cadastrada no Segura®.
   4. (Opcional): No campo Caminho do certificado intermediário, insira o caminho do certificado intermediário no keystore.
   5. No campo Caminho do arquivo de configuração (server.xml), insira o caminho do arquivo de configuração do Tomcat.
   6. No campo Versão do Tomcat, selecione a versão do Tomcat.
   7. Opcional: No campo Porta, insira a porta que o Segura® utiliza para verificar o servidor após a publicação. Insira apenas dígitos, de 1 a 65535. Se deixar o campo vazio, o Segura® pula a verificação. Veja Verificação pós-publicação.
7. Clique em Continuar.
8. Na aba Dispositivos, selecione o servidor Tomcat.
   1. O dispositivo deve ter sido cadastrado no Segura™.
   2. As abas Dispositivos e Revisão incluem uma coluna somente leitura Network Connector que mostra Sim ou Não, dependendo se o dispositivo tem o Network Connector configurado.

Verificação pós-publicação

Se você informou uma porta no campo Porta, o Segura® se conecta ao servidor nessa porta depois de instalar o certificado e compara o fingerprint do certificado apresentado pelo servidor com o fingerprint do certificado publicado. Se o servidor não responder, o Segura® tenta novamente após 5, 10, 15, 15, 15 e 15 segundos.

• Se os fingerprints forem iguais, a publicação é concluída com sucesso.
• Se os fingerprints forem diferentes, a publicação falha.
• Se o servidor não responder após todas as tentativas, a publicação ainda termina com sucesso, e o log de execução registra um aviso.

Se você deixou o campo Porta vazio, o log de execução registra TLS verification skipped: no port configured.

Os detalhes de execução não exibem a senha da keystore.

Comportamento do Network Connector

A publicação no Tomcat utiliza o Network Connector do dispositivo tanto para a instalação quanto para a verificação pós-publicação. Através de um Network Connector, a verificação se conecta sem SNI.