Pular para o conteúdo
Documentação

Certificados SSL: validade, emissão e renovação

Como acompanhar a validade de todos os certificados do servidor, renovar e saber onde cada certificado é emitido.

R Regis Manze 20/11/2026 4 min de leitura

A tela Certificados SSL reúne em um só lugar todos os certificados que o servidor usa e mostra quantos dias faltam para cada um vencer. Acesse em Rede & SSL → Certificados SSL.

Onde o SSL é feito no miniCP

O lugar em que o certificado fica depende de como o servidor está montado:

Cenário Quem termina o SSL Onde emitir
Com HAProxy na frente O HAProxy Tela HAProxy ou ao criar o domínio. Veja Integração com o HAProxy
Modo NGINX Only ou NGINX + Apache O NGINX do servidor Modo de Operacao → Certificados SSL
Modo Apache Only O Apache, se a porta 443 estiver ligada Veja Apache SSL (porta 443)

A tela Certificados SSL serve para acompanhar e renovar. A emissão é feita nos lugares da tabela acima.

O que a tela lista

O painel procura certificados em quatro origens:

Origem O que é
painel Certificados registrados nos domínios pelo painel (Let's Encrypt ou customizado)
mageweb Certificados na pasta de certificados do painel
letsencrypt Certificados emitidos pelo certbot neste servidor
haproxy Certificados do HAProxy, lidos pela API (só com o HAProxy habilitado)

Para cada certificado aparecem:

Coluna Significado
Dominio Domínio do certificado
Validade Dias até vencer, com cor
Expira em Data de vencimento
Emissor Autoridade que emitiu
Origem Uma das origens acima, com o caminho do arquivo

A lista vem ordenada pelos que vencem primeiro.

Cores da validade

Selo Situação
EXPIRADO ha Nd Já venceu. O navegador mostra erro de segurança
Até 15 dias Vence em breve. Renove
16 a 30 dias Atenção
Mais de 30 dias Em dia

Renovar um certificado

Certificados Let's Encrypt deste servidor

  1. Na linha do certificado, clique em Renovar.
  2. Confirme.

O painel força a renovação no certbot e recarrega o servidor web.

O certbot sempre usa como nome do certificado o próprio domínio. Assim, quando os aliases do domínio mudam e o certificado é emitido de novo, o mesmo certificado é renovado com os nomes novos, em vez de surgir um segundo certificado.

O botão Renovar só aparece em certificados Let's Encrypt e com o certbot instalado. Nos demais, a coluna mostra manual: certificados customizados precisam ser trocados enviando um novo arquivo em Modo de Operacao → Certificado Customizado. Antes de gravar, o painel confere se o certificado e a chave estão em formato PEM, se a chave não tem senha e se os dois formam par. Se algo não bater, ou se o servidor web recusar a configuração, nada muda e o certificado anterior continua valendo.

Atenção: o Renovar desta tela força a emissão de um certificado novo, mesmo que o atual ainda esteja longe de vencer. O Let's Encrypt limita quantos certificados podem ser emitidos para o mesmo domínio por semana. Use só quando precisar.

Certificados do HAProxy

Com o HAProxy habilitado, aparece um aviso no topo da tela e o botão Renovar no HAProxy. Ele pede ao HAProxy que renove os certificados dele. A renovação desses certificados é sempre feita no HAProxy.

Renovação automática

  • Certificados emitidos pelo certbot neste servidor são renovados automaticamente pelo próprio certbot.
  • Certificados do HAProxy são renovados no HAProxy.
  • Certificados customizados não se renovam. Troque o arquivo antes de vencer.

Se a coluna Validade mostrar um certificado do certbot com menos de 30 dias, a renovação automática pode estar falhando. Rode no terminal para ver o erro:

certbot renew --dry-run

As causas mais comuns são o domínio não apontar mais para este servidor ou a porta 80 estar bloqueada.

Receber aviso antes de vencer

Em Configuracoes → Alertas, ligue os alertas e defina Certificado: alertar a (dias) (padrão: 15 dias). O painel avisa por Telegram, webhook ou e-mail quando um certificado entra nesse prazo.

Problemas comuns

Sintoma Causa provável
Tela vazia: Nenhum certificado encontrado Nenhum certificado emitido ainda, ou o SSL é feito fora deste servidor e o HAProxy não está habilitado no painel
Aviso certbot nao instalado Instale o certbot pelo Setup inicial ou ao trocar para um modo com NGINX
Certificado aparece duas vezes O mesmo domínio tem certificado em mais de uma origem (por exemplo, no HAProxy e no servidor). Só um deles atende os visitantes
Certificado customizado recusado O arquivo não está em PEM, a chave tem senha ou certificado e chave não formam par. Corrija e envie de novo
Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!