---
title: "Como configurar o Tomcat"
slug: "how-to-configure-tomcat"
updated: 2026-11-06T15:21:53Z
published: 2026-11-06T15:21:53Z
canonical: "docs.senhasegura.io/how-to-configure-tomcat"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senhasegura.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/v4-2/docs/pt/how-to-configure-tomcat#verifica%C3%A7%C3%A3o-p%C3%B3spublica%C3%A7%C3%A3o).
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.

Atenção

Se o Tomcat servir vários hosts SSL na mesma porta, a verificação através de um Network Connector pode alcançar um host diferente daquele com o novo certificado, e a publicação falha mesmo que o novo certificado esteja em uso.