KEPLIN Docs

Antivírus

Ligar um antivírus por ICAP, o que acontece a um ficheiro infectado, a quarentena, e as verificações do código das apps e dos pacotes Python.

Os ficheiros que entram nas apps vêm de fora: anexos que os utilizadores enviam, documentos que os scripts recebem, pacotes importados. Com um antivírus ligado, cada ficheiro é verificado antes de se guardar, e um ficheiro infectado nunca chega ao armazenamento da app.

O Keplin não traz antivírus próprio: liga-se ao da empresa pelo ICAP, o protocolo que os antivírus de servidor têm em comum (por exemplo, o ClamAV com o c-icap).

Há duas verificações que não dependem do antivírus e estão sempre ligadas: o código das apps e os pacotes Python dos scripts.

Ligar o antivírus

Só um administrador muda o antivírus.

  1. Na barra lateral, abre Definições e, no grupo Plataforma, a secção Antivírus.
  2. Em Endereço, escreve o servidor ICAP: icap://SERVIDOR:1344, ou icaps://SERVIDOR:11344 com TLS.
  3. Carrega em Procurar serviços. A lista Serviço passa a ter os serviços de antivírus que respondem nesse servidor. Escolhe um. Se o serviço tiver um nome que o Keplin não conhece, escolhe Outro caminho e escreve o caminho que o administrador do antivírus te indicar.
  4. Carrega em Testar. O Keplin envia o ficheiro de teste EICAR, que qualquer antivírus reconhece como infectado, e um ficheiro limpo. O teste passa quando o antivírus reconhece o primeiro e deixa passar o segundo, e o resultado diz como o antivírus sinalizou o ficheiro infectado.
  5. Liga Verificar os ficheiros com o antivírus. O interruptor só liga depois de o teste passar.
  6. Carrega em Gravar.

Substitui o seguinte:

  • SERVIDOR: o IP ou o nome do servidor ICAP.

A secção Antivírus, com o endereço, o serviço escolhido e o resultado do teste
A secção Antivírus, com o endereço, o serviço escolhido e o resultado do teste

O Estado diz o que está em uso, por exemplo «Em uso: SERVIÇO. Testado a DATA: reconheceu o ficheiro EICAR como …», ou «Sem antivírus: os ficheiros não são verificados.»

Quando o teste falha, a mensagem diz a causa: o nome que o servidor não encontra, a porta que recusa a ligação, a firewall que não deixa passar, o certificado que não é aceite, ou um serviço que não reconheceu o EICAR.

Nota

Numa instalação com vários tenants, o antivírus da instalação configura-se no backoffice. Nas Definições de cada tenant, a secção diz qual é o antivírus da plataforma, e Usar o antivírus da minha empresa deixa o tenant usar o seu, desde que o servidor ICAP da empresa aceite ligações da plataforma. Desligar volta ao antivírus da plataforma.

O que acontece a cada ficheiro

Todos os ficheiros das apps passam pelo antivírus: os que os utilizadores enviam nos ecrãs e pelas APIs, os ficheiros dos scripts e da inteligência artificial, as imagens carregadas nos assets, a pasta de um script, as bases SQLite importadas e os pacotes de apps importados.

Resultado O que acontece
Limpo O ficheiro guarda-se.
Infectado O ficheiro é recusado e não chega a ser guardado. Quem o enviou vê a mensagem com o nome da ameaça, por exemplo: «O ficheiro «fatura.pdf» foi recusado: o antivírus encontrou «…». O ficheiro não foi guardado.»
O antivírus não responde O ficheiro guarda-se e fica por verificar. É verificado em segundo plano, logo que o antivírus volte. Um antivírus parado não pára as apps.

Cada ficheiro recusado fica registado na auditoria e avisa por email, pelos alarmes da plataforma (ver Alertas por email).

A quarentena

Os ficheiros já guardados voltam a ser verificados em segundo plano:

  • os que ficaram por verificar;
  • os dos últimos sete dias, quando o antivírus actualiza as assinaturas, no máximo uma vez por dia;
  • todos, quando carregas em Verificar todos os ficheiros outra vez.

Um ficheiro que só se descobre infectado numa destas verificações vai para a quarentena: deixa de se poder abrir e descarregar, e quem o pede vê «O ficheiro … está em quarentena: o antivírus encontrou … Fala com o administrador.» O alarme avisa por email.

No bloco Ficheiros da secção Antivírus estão os contadores Por verificar e Em quarentena e a lista dos ficheiros em quarentena, com a app, a ameaça e a data. Em cada um:

  • Apagar tira o ficheiro do armazenamento e da app. Não se pode desfazer.
  • Libertar devolve o ficheiro às apps. Liberta-o só se tens a certeza de que o antivírus se enganou.

O bloco Ficheiros, com os contadores e a lista da quarentena
O bloco Ficheiros, com os contadores e a lista da quarentena

O código das apps

O código das apps é verificado sempre que se grava: os scripts, os eventos dos ecrãs, os layouts, os widgets, os workflows e os passos das APIs. A verificação procura só o que não tem uso legítimo numa app:

  • uma shell reversa, que dá a outra máquina o controlo do servidor;
  • mineração de criptomoedas;
  • um programa descarregado da internet e executado logo a seguir;
  • código escondido em base64 e executado;
  • uma leitura das palavras-passe ou das permissões do sistema;
  • uma bomba de processos, que deixa o servidor sem recursos.

Quando encontra um destes padrões, o código não é gravado, e a mensagem diz onde e em que linha, por exemplo: «O código não foi gravado: «importar.py», linha 12, tem um programa descarregado da internet e executado logo a seguir.»

Os pacotes Python dos scripts

Antes de instalar as dependências de um script (ver Dependências e ficheiros), o Keplin compara os pacotes que vão ser instalados, incluindo as dependências deles, com a lista pública de pacotes maliciosos da OpenSSF. Um pacote dessa lista não se instala, e a mensagem diz qual é e porquê.

Sem acesso à lista (por exemplo, num servidor sem internet), a instalação continua.

Perguntas frequentes

O teste diz que o servidor não reconheceu o ficheiro EICAR. A análise está desligada nesse serviço, ou o antivírus sinaliza os ficheiros infectados de uma forma que o Keplin não conhece. Confirma o serviço com o administrador do antivírus.

O teste diz que o antivírus bloqueou também o ficheiro limpo. Com essa configuração, o antivírus bloquearia todos os ficheiros. Confirma a configuração do serviço.

O antivírus esteve parado. Os ficheiros enviados entretanto ficaram sem verificação? Ficaram por verificar e são verificados quando o antivírus voltar. O contador Por verificar mostra quantos faltam.