Pular para o conteúdo
Documentação

Proteção de login e alertas (Telegram, webhook, e-mail)

Como funciona o bloqueio de IPs por tentativas de login e como configurar alertas por Telegram, webhook e e-mail.

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

O miniCP bloqueia automaticamente IPs que erram a senha muitas vezes e pode avisar você por Telegram, webhook ou e-mail quando algo sai do normal no servidor.

Proteção contra força bruta no login

A proteção vale para a tela de login do painel (administradores e clientes) e também para os tokens da API (/api/v1) e do cluster (/cluster/*). Não há nada para configurar.

Regra Valor
Falhas para bloquear 5 tentativas erradas
Janela de contagem 15 minutos
Tempo de bloqueio 15 minutos

Contam como falha a senha errada, a tentativa com um usuário que não está cadastrado no painel e o envio de um token errado para a API ou para o cluster. As falhas de login, API e cluster somam na mesma contagem por IP, e o bloqueio vale para os três. Um login certo zera a contagem daquele IP.

Durante o bloqueio, a tela de login mostra "Muitas tentativas. Aguarde N min." e não testa a senha. A API e o cluster recusam as chamadas daquele IP, mesmo com o token certo.

Cada login bem-sucedido começa uma sessão nova: nada de uma sessão anterior aberto no mesmo navegador é reaproveitado.

Dica: se o CmCP ou outro sistema parar de acessar o servidor depois de uma troca de token, confira se ele já recebeu o token novo: enquanto usar o antigo, ele acumula falhas e acaba bloqueando o próprio IP.

Uma conta de cliente suspensa não entra no painel: a tela de login mostra "Sua conta esta suspensa. Fale com o suporte.". Essa tentativa não conta para o bloqueio.

Ver IPs bloqueados

  • No Dashboard, a faixa de saúde mostra o aviso N IP(s) bloqueado(s) por brute-force enquanto houver bloqueios ativos.
  • Na Auditoria, filtre por login_fail para ver as tentativas e por login_blocked (login) ou cluster_blocked (token do cluster) para ver os bloqueios, com o IP de cada um.

O bloqueio expira sozinho depois de 15 minutos. Não há botão para liberar um IP antes disso. Reiniciar o serviço do painel também limpa os bloqueios.

Atenção: com o painel atrás do HAProxy, o IP considerado é o do visitante, lido do fim do cabeçalho X-Forwarded-For (o valor que o próprio balanceador acrescenta). Assim, um cabeçalho forjado pelo visitante não burla o bloqueio por tentativas nem a lista de IPs permitidos da API. Se o proxy na frente não for reconhecido pelo painel, todos os acessos parecem vir do IP do proxy, e um bloqueio afetaria todo mundo.

Dica: esta proteção cobre só o login do painel, a API e o cluster. Para bloquear excesso de requisições aos sites, use Protecao contra bots.

Alertas

Os alertas são configurados em Configuracoes, aba Alertas.

O que é verificado

A cada 5 minutos o painel verifica:

Verificação Quando alerta
Serviços Apache, NGINX, MariaDB, PostgreSQL, Redis, Varnish ou PHP-FPM fora do estado ativo (só os instalados e usados pelo modo de operação).
Disco Disco raiz acima do limite definido.
Certificados Certificado SSL vencendo dentro do prazo definido, ou já expirado.
Réplicas Réplica com sincronização automática ligada e erros no último sync.
Atualização Nova versão do miniCP disponível.

Os mesmos canais também recebem os avisos de site fora do ar e site recuperado (tela Disponibilidade) e de IPs bloqueados pela Protecao contra bots.

Configurar

  1. Ligue a chave Habilitado no quadro Alertas e Notificacoes.
  2. Preencha um ou mais canais (veja as tabelas abaixo).
  3. Ajuste os Limiares.
  4. Salve as configurações.
  5. Clique em Enviar alerta de teste e confira se a mensagem chegou.

Atenção: salve antes de testar. O teste usa os canais já salvos.

Telegram

Campo O que informar
Bot Token Token do bot criado com o @BotFather. Vazio mantém o atual.
Chat ID ID do chat, grupo ou canal que vai receber. Grupos costumam começar com -100.

Adicione o bot ao grupo antes de testar.

Webhook

Campo O que informar
URL Endereço que recebe um POST em JSON.

Formato enviado:

{
  "host": "nome-do-servidor",
  "title": "Disco em 92%",
  "message": "Uso do disco raiz em 92% (limite 90%). Livre: 8000 MB.",
  "text": "[miniCP@nome-do-servidor] Disco em 92%\nUso do disco raiz..."
}

Use para integrar com Slack, Discord, Teams, n8n ou um sistema próprio.

E-mail (SMTP)

Campo O que informar
Servidor SMTP Endereço do servidor de envio.
Porta Padrão 587. O painel tenta STARTTLS.
Usuario e Senha Credenciais SMTP. O usuário também é usado como remetente.
Destinatario E-mail que recebe os alertas.

O assunto chega como [miniCP@nome-do-servidor] título do alerta.

Limiares

Campo Padrão Faixa
Disco: alertar acima de (%) 90 50 a 99
Certificado: alertar a (dias) 15 1 a 60
Anti-spam: reenviar apos (horas) 6 1 a 168

O anti-spam evita repetir o mesmo alerta. Um serviço parado, por exemplo, gera um aviso e só volta a avisar depois do intervalo definido, se continuar parado.

Dica: o limite de disco dos alertas também define quando o Dashboard marca o disco como ponto de atenção.

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!