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_failpara ver as tentativas e porlogin_blocked(login) oucluster_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
- Ligue a chave Habilitado no quadro Alertas e Notificacoes.
- Preencha um ou mais canais (veja as tabelas abaixo).
- Ajuste os Limiares.
- Salve as configurações.
- 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.