> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Scanner Antivírus

> Procura vírus nos arquivos do servidor uma vez por semana e decide o que fazer com o que achar: só avisar, mover para a quarentena ou apagar. O programa por trás é o ClamAV.

**Caminho no painel:** menu da esquerda > Configuração > cartão **Ferramentas** >
**Scanner Antivírus**

![Tela Scanner Antivírus: Está ativado, Ação em caso de infecção e a opção de enviar relatório mesmo sem infecção](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/ferramentas-antivirus.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=5b9e8f35e9db809e0165724dfaa005aa)

1. Ajuste os campos, explicados abaixo.
2. Clique em **Salvar**.

As mudanças valem na hora, e o painel responde *"As configurações foram
atualizadas."*

| Campo | Vem com | O que faz |
| - | - | - |
| **Está ativado** | marcado | liga ou desliga a verificação semanal |
| **Ação em caso de infecção** | **Nenhuma ação / somente relatório** | o que fazer com o arquivo achado. As três opções estão logo abaixo |
| **Enviar relatório de verificação por e-mail mesmo se nenhuma infecção for encontrada** | desmarcado | manda o relatório também quando a verificação sai limpa |

**Está ativado é o mesmo interruptor da tarefa semanal.** Conferido no banco do
painel: desmarcar aqui desligou a linha **Executar uma verificação de vírus**, em
**Intervalos de Manutenção**, e marcar religou.

## Quando ela roda, e como rodar agora

![Linha Executar uma verificação de vírus em Intervalos de Manutenção, com o intervalo de 7 dias, a janela de 01 até 02 horas e os quatro ícones de ação](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/ferramentas-intervalos-antivirus.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=b78631ee054a59ffeabe3f51fa3f2c85)

O horário não fica nesta tela, e sim em **CONFIGURAÇÕES** >
[Intervalos de Manutenção](/keyhelp-admin/intervalos-de-manutencao),
na linha **Executar uma verificação de vírus**: **a cada 7 dias,
entre 1h e 2h** da hora do servidor. **Conferido no registro:** neste servidor ela
rodou toda quinta-feira à 1h desde a instalação, sem falhar nenhuma semana, até
uma verificação feita à mão numa terça; desde então roda às quartas, à 1h. A tela
não tem campo de dia da semana: o intervalo é de 7 dias, e aqui a primeira
execução caiu na primeira madrugada depois da instalação, que era de quinta.
**Rodar à mão muda esse dia**, como se vê abaixo.

Os quatro ícones da coluna **AÇÕES** são, da esquerda para a direita:

| Ícone | Nome | O que faz |
| - | - | - |
| lápis | **Editar** | muda o intervalo e a janela de horário |
| seta de tocar | **Iniciar agora** | roda a verificação no minuto seguinte |
| lista | **Mostrar registros** | abre o relatório das verificações |
| engrenagem | **Configurar** | volta para esta tela |

**Iniciar agora não mostra mensagem.** A linha ganha a etiqueta **Será iniciado**,
e a verificação começa no minuto seguinte. Medido em cinco verificações à mão e
em três semanais: cada uma levou **cerca de 3 minutos** neste servidor, de menos
de 3 a 3 min 13 s, com cerca de 4 mil arquivos, e de 20 a 40 segundos disso
foram para atualizar a base de vírus.

**Rodar na hora conta como execução.** A coluna **ÚLTIMA EXECUÇÃO** passa a mostrar
a hora dela, **e os 7 dias da verificação semanal passam a contar dali.** Medido:
com a última verificação à mão numa terça às 12:45, a de quinta não rodou, e a
semanal seguinte rodou na quarta da outra semana, à 1h, a primeira hora do prazo
depois dos 7 dias.

## O que a verificação faz, e onde ver o resultado

A cada execução, na ordem:

1. Atualiza a base de vírus. O ClamAV não fica rodando no servidor o tempo todo: o painel o chama só para a verificação.
2. Verifica as pastas do campo **Verificar diretórios**.
3. Aplica a **Ação em caso de infecção** e escreve o relatório.

O relatório fica em **Mostrar registros**, que leva a **Status do Sistema** >
[Registros](/keyhelp-admin/registros), com o arquivo **Executar uma verificação de vírus | avscan.log**
escolhido.

![Relatório de uma verificação: o arquivo achado, as pastas verificadas, o resumo e a mudança para a quarentena](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/ferramentas-antivirus-registro.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=4d0917d41ebe4d23dc611c8cefc3eda3)

## A ação em caso de infecção

**Medido com o EICAR**, um arquivo de teste inofensivo que todo antivírus reconhece
como vírus de propósito, posto na pasta de uma conta de teste. Uma verificação
para cada opção:

| Ação | O que aconteceu com o arquivo | O que o relatório mostra |
| - | - | - |
| **Nenhuma ação / somente relatório** | **ficou no lugar** | o arquivo e o nome da ameaça |
| **Mover a infecção para a quarentena** | saiu da pasta do cliente e foi para `/var/spool/clamav/quarantine/`, com `.QUARANTINE-` e um código no fim do nome | a seção *MOVE INFECTIONS TO QUARANTINE*, com a origem e o destino |
| **Excluir infecção (não recomendado)** | **apagado** | a seção *DELETE INFECTIONS*, com o arquivo removido |

**Quem achou o arquivo de teste foi uma das assinaturas adicionais**, e o
relatório põe esse tipo de achado numa seção à parte, *INFECTIONS (UNOFFICIAL)*.

> [!NOTE]
>
> **O painel não tem tela para ver nem devolver o que foi para a quarentena**
>
> Procurado nos modelos de tela do painel: a quarentena só aparece nesta tela de
> ajuste. A pasta nasce na primeira vez que algo vai para ela, e **só o
> administrador do sistema (root) lê**. Ao lado dos arquivos fica um mapa,
> `_quarantine_mapping_file.json`, com o caminho de onde cada um saiu.
>
> Devolver um arquivo, portanto, é trabalho de quem administra o servidor, pelo
> terminal, copiando de volta para o caminho que o mapa indica.

**O cliente não é avisado.** O e-mail vai só para os administradores, e com a
quarentena ou a exclusão o arquivo some da pasta dele sem nenhum recado.

## Quem recebe o relatório por e-mail

**Todas as contas de administrador do painel.** Medido: a cada verificação que
mandou e-mail, o Registro de Eventos anotou um envio para cada administrador,
*"Email notification anti\_virus\_scanner\_report sent to ..."*.

| Verificação | A caixa de relatório | Mandou e-mail |
| - | - | - |
| achou alguma coisa | desmarcada ou marcada | **sim** |
| limpa | desmarcada | **não** |
| limpa | marcada | **sim** |

O aviso é o evento **verificação de antivírus**, da tela
[Notificações](/keyhelp-admin/notificacoes). É lá que se desliga o
e-mail ou se põe um endereço de cópia.

## Pastas verificadas e pastas excluídas

![Campos Verificar diretórios, com as três pastas de fábrica, e Excluir caminhos do escaneamento, vazio](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/ferramentas-antivirus-diretorios.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=3fb528278991455d78955636e89e2a3b)

| Campo | Vem com | Observação |
| - | - | - |
| **Verificar diretórios** | `/home/users/`, `/tmp/` e `/var/tmp/` | a primeira é a pasta de todas as contas de cliente. A tela aceita os caminhos separados por espaço, vírgula, ponto e vírgula ou linha |
| **Excluir caminhos do escaneamento** | vazio | arquivos ou pastas que a verificação pula. A tela diz que aceita `*` como curinga |

**Caminho sem a barra do começo é aceito e corrigido.** Conferido: `home/users/`
foi gravado como `/home/users/`.

**A exclusão funciona com o caminho exato e com curinga.** Medido com três
arquivos de teste numa verificação só:

| Arquivo | Regra em **Excluir caminhos do escaneamento** | Resultado |
| - | - | - |
| um em `files/` | o caminho exato do arquivo | **pulado** |
| um em `tmp/` | `/home/users/*/tmp/*` | **pulado** |
| outro em `files/` | nenhuma | achado |

Com o campo vazio de novo, a verificação seguinte achou os três.

## Assinaturas adicionais

![Opções de assinaturas adicionais: Melhor taxa de detecção, Boa taxa de detecção, marcada, e Configuração customizada, com a lista de endereços da opção marcada](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/ferramentas-antivirus-assinaturas.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=6165c71846aea6759adbeeaa2198bcd7)

Além da base oficial do ClamAV, o painel baixa listas de assinaturas de outras
fontes. A tela mostra a lista de cada opção quando ela é escolhida:

| Opção | Endereços |
| - | - |
| **Melhor taxa de detecção** | 27, da SaneSecurity e do URLhaus |
| **Boa taxa de detecção**, a de fábrica | 18, da SaneSecurity. A tela a recomenda para servidor com poucos recursos |
| **Configuração customizada** | um campo livre, um endereço por linha |

> [!WARNING]
>
> **Endereço inválido na configuração customizada some sem aviso**
>
> Medido: salvar só com um texto que não é endereço gravou a **lista vazia**, e o
> painel respondeu *"As configurações foram atualizadas."*, a mensagem de sempre.
> Com um endereço válido e um inválido juntos, ficou só o válido. Quem errar a
> digitação fica sem assinatura adicional nenhuma, achando que configurou. Depois
> de salvar, abra a tela de novo e confira o que ficou no campo.

**A troca vale na verificação seguinte, que acerta a pasta de assinaturas antes
de verificar.** Medido, uma verificação para cada opção:

| Depois de escolher | Listas adicionais no servidor |
| - | - |
| **Melhor taxa de detecção** | as 9 que faltavam foram baixadas: de 18 para **27** |
| **Configuração customizada**, com um endereço | **as outras 26 foram apagadas**, ficou só a do endereço |
| **Boa taxa de detecção** de novo | as mesmas **18** do começo |

Com a lista customizada de um endereço só, o arquivo de teste foi achado pela
assinatura **oficial** do ClamAV, *Eicar-Test-Signature*, na seção normal do
relatório. A base oficial continua valendo com qualquer opção desta tela.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **Os administradores nunca recebem relatório** | sem infecção, o e-mail só sai com a caixa de relatório marcada; ou o evento foi desligado em **Notificações** | marcar a caixa, ou conferir o evento **verificação de antivírus** |
| **Um cliente diz que um arquivo sumiu** | a ação é quarentena ou exclusão, e a verificação achou o arquivo | procurar o arquivo em **Mostrar registros**. Se foi para a quarentena, quem administra o servidor devolve pelo mapa |
| A verificação semanal mudou de dia | alguém usou **Iniciar agora**, e os 7 dias passaram a contar dali | nada a fazer: ela segue do novo dia |
| A verificação parou de rodar | **Está ativado** foi desmarcado, aqui ou na linha de **Intervalos de Manutenção** | marcar e salvar |
| A lista customizada ficou vazia | um endereço inválido foi descartado sem aviso | escrever os endereços completos, com `https://`, e conferir depois de salvar |
| Todos os administradores receberam aviso de vírus de um teste | o evento vai para todas as contas de administrador | avisar antes de testar, ou ajustar o evento em **Notificações** |

## Ver também

* [Notificações](/keyhelp-admin/notificacoes), onde fica o evento do relatório
* [Proteção Contra Spam e Vírus de E-mail](/keyhelp-admin/protecao-contra-spam-e-virus-de-email), o antivírus das mensagens, que é outro ajuste
* [Estatísticas da Web (AWStats)](/keyhelp-admin/estatisticas-da-web-awstats), outra tarefa que se roda na hora pela mesma tela de Intervalos de Manutenção


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.