A Auditoria registra quem fez o quê no painel, quando e de qual IP. Use para investigar uma mudança inesperada, conferir acessos ou acompanhar o uso da API.
Acesse pelo menu Monitoramento > Auditoria.
O que é registrado
| Evento | Exemplo de ação na tela |
|---|---|
| Login com sucesso | login, com o papel (admin, admin:readonly, cliente) |
| Login com senha errada | login_fail, com o usuário tentado (também quando a conta está suspensa) |
| IP bloqueado por excesso de tentativas | login_blocked |
| IP bloqueado por tokens do cluster inválidos | cluster_blocked |
| Sessão de cliente encerrada por suspensão ou remoção da conta | client_session_closed |
| Saída do painel | logout |
| Arquivo aberto no gerenciador de arquivos do administrador | file_view, com o caminho do arquivo |
| Tentativa de abrir um arquivo protegido no gerenciador do administrador | file_view_denied, com o caminho do arquivo |
| Toda ação que grava no painel admin ou do cliente | O endereço da tela, por exemplo /admin/domains/add |
| Ações específicas | backup_run, backup_config, cwp_migrate, migrate_resync, admin_add, admin_remove, domain_env (variáveis de ambiente de um domínio alteradas) e outras |
| Backup que terminou parcial (dump de algum banco falhou) | backup_run marcado como falha, com os bancos que ficaram de fora |
Migração dos logs das contas para /var/log/minicp/users (uma vez por servidor, na atualização para a 2.66.0) |
user_logs_v2, com a quantidade de arquivos movidos |
| Ações pela API de escrita | api_domain_create, api_domain_update, api_domain_delete, api_haproxy_add, api_haproxy_remove |
| Geração de tokens da API | api_token |
Toda ação de gravação (formulário enviado, botão de salvar, criar, excluir, reiniciar) entra automaticamente, mesmo sem um nome específico. Nesse caso a coluna Acao mostra o endereço da tela e a coluna Detalhe mostra campos como domínio, usuário, serviço ou versão.
Consultas (abrir telas, listar dados) não são registradas. A exceção é a leitura de arquivos pelo gerenciador de arquivos do administrador, que sempre entra como file_view ou file_view_denied.
Atenção: senhas e tokens nunca vão para a auditoria. O detalhe só inclui campos seguros, como nome do domínio ou do serviço.
Quem aparece na coluna Usuario
| Valor | Significado |
|---|---|
root ou nome da conta |
Administrador ou cliente logado no painel. |
api |
Ação feita por um sistema externo pela API (/api/v1) com token de escrita. |
sistema |
Tarefa automática do painel, como backup agendado ou liberação de IP pela proteção contra bots. |
Quando um administrador usa acessar como um cliente, as ações aparecem com o nome do cliente.
IP registrado
Com o painel atrás do HAProxy, o IP real do visitante é lido do fim do cabeçalho X-Forwarded-For (o valor acrescentado pelo próprio balanceador). Um cabeçalho forjado pelo visitante não muda o IP que aparece aqui, nem burla a lista de IPs da API ou o bloqueio por tentativas.
Consultar a auditoria
A tela mostra as entradas mais recentes primeiro, com até 500 linhas.
Colunas: Quando, Usuario, IP, Acao e Detalhe.
Linhas com fundo vermelho são falhas: senha errada, IP bloqueado, ação da API que não deu certo, arquivo protegido, backup parcial.
Para filtrar:
- Digite um termo no campo filtrar (usuario, acao, ip...).
- Clique na lupa.
O filtro procura o texto em qualquer coluna. Exemplos úteis:
login_failpara ver tentativas de senha errada;apipara ver tudo o que a API fez;file_viewpara ver os arquivos que os administradores abriram;backup_runpara conferir backups, inclusive os parciais;- um IP para ver tudo o que veio dele;
- um domínio para ver as mudanças nele.
Dica: o Dashboard mostra as últimas ações no quadro Atividade recente, com atalho para esta tela.
Onde fica o arquivo
O registro completo fica em:
/var/log/minicp-audit.log
Cada linha é um objeto JSON, acessível só pelo root. Para buscar além do que a tela mostra:
grep '"login_fail"' /var/log/minicp-audit.log | tail -n 50
grep '"user": "api"' /var/log/minicp-audit.log
A rotação deste arquivo segue a configuração em Configuracoes, aba Logs, em Rotacao de Logs (logrotate). Na mesma aba, Log Remoto (rsyslog) pode encaminhar os logs do painel para um servidor central.
Atenção: a tela lê só o fim do arquivo. Depois de uma rotação, eventos antigos ficam nos arquivos rotacionados em
/var/log/.