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
- Na linha do certificado, clique em Renovar.
- 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 |