Pular para o conteúdo
Documentação

Auditoria: registro de ações e acessos

O que o miniCP registra na auditoria (logins, ações no painel, ações da API e tarefas automáticas) e como consultar.

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

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:

  1. Digite um termo no campo filtrar (usuario, acao, ip...).
  2. Clique na lupa.

O filtro procura o texto em qualquer coluna. Exemplos úteis:

  • login_fail para ver tentativas de senha errada;
  • api para ver tudo o que a API fez;
  • file_view para ver os arquivos que os administradores abriram;
  • backup_run para 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/.

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!