Files
Investidor-V2/docs/investmoz/malware-scanning-2026-10-05.md
T
nala e65cb26901
tests / ci (push) Canceled after 0s
varias alteracoes
2026-10-06 14:50:12 +02:00

10 KiB
Raw Blame History

Antimalware de documentos e anexos — 5 de Outubro de 2026

Âmbito implementado

Os ficheiros continuam a usar o registo canónico documents e o armazenamento privado existente. Uploads da biblioteca, anexos de zonas, pedidos de investimento, processos Terra/DUAT e documentos de texto da área de IA são colocados em quarentena técnica e enviados para ScanDocumentForMalware. O estado técnico é separado da revisão editorial. Um resultado limpo só liberta o ficheiro para o estado técnico active; não altera a classificação privada, não o publica nem o associa automaticamente a um catálogo.

O worker calcula SHA-256 antes e depois da análise, compara com o registo do documento e grava cada tentativa em document_malware_scans, incluindo hash, resultado, motor/versão, versão temporal das assinaturas, duração e motivo. Resultados infectados, falhados ou inconclusivos mantêm o ficheiro em quarentena. Descarregamentos, selecção pública, catálogo público e ingestão de IA verificam estado limpo e correspondência do hash. O histórico não é apagado automaticamente. malware:scan-pending --dry-run inventaria pendências e --apply --limit=N processa lotes limitados; não publica registos.

Estados: pending, scanning, clean, infected, inconclusive, failed. A interface de anexos distingue análise em curso, ausência de ameaça detectada, ameaça detectada e análise não concluída. Gestores podem repetir tentativas de ficheiros inconclusivos/falhados; um ficheiro detectado como infectado exige substituição.

Scanner local observado

  • Windows 11 Pro ARM64, ClamAV oficial 1.5.4 ARM64 em %LOCALAPPDATA%\InvestMoz\ClamAV\1.5.4\clamav-1.5.4.win.arm64.
  • SHA-256 do pacote comparado com o digest da release oficial antes de extrair.
  • freshclam actualizou a base oficial; malware:health reportou assinaturas 28144, data UTC 2026-10-05T08:24:24Z, com cerca de 1,5 horas quando verificado.
  • clamd correu no momento da validação e escuta apenas em 127.0.0.1:3310; sem porta exposta na rede local ou Internet. Configuração local: clamd-investmoz.conf, fora do repositório; 2 threads, fila 16, timeout 120 s, ficheiro 25 MiB, análise 100 MiB, stream 25 MiB, profundidade 10, máximo 1.000 ficheiros e alertas para ficheiros cifrados/limites.
  • O protocolo utilizado é INSTREAM, sem partilhar ficheiros com serviços públicos.

O Docker Compose contém um modelo com ClamAV privado, sem publicação de TCP/3310; apenas aplicação e worker pertencem à rede Docker privada do scanner. O modelo Linux usa loopback. Estes são modelos de implantação, não prova de instalação no alojamento. O servidor Linux remoto não estava acessível nesta validação.

Evidência executada

  • php artisan malware:health: disponível; ClamAV 1.5.4; assinaturas recentes; listener confirmado em loopback.
  • php artisan test --filter=ClamDScannerIntegrationTest: 2 testes, 7 assertions — ficheiro benigno aceite como sem ameaça detectada; limite de tamanho produz resultado inconclusivo; endpoint indisponível também produz estado inconclusivo.
  • ClamDQueueWorkerIntegrationTest: comando real queue:work --once ligado à base isolada investmoz_test processou upload privado; verificou hash, histórico e ausência de publicação.
  • Testes da biblioteca e anexos de zonas validaram que a libertação técnica preserva classificação privada e que a publicação continua explícita e condicionada a direitos/revisão editorial.
  • A invocação directa do ficheiro padrão de teste EICAR foi bloqueada pela política de execução do ambiente. Não foi usado malware real nem contornada essa barreira. A detecção positiva necessita de uma execução autorizada do ficheiro de teste padrão ou de uma validação operacional equivalente antes do aceite final.

Pendências de operação

  1. Configurar e validar scanner, actualização de assinaturas e worker no alojamento real. O worker de QA foi exercitado; isso não comprova o worker remoto.
  2. Acrescentar monitorização e alertas operacionais para indisponibilidade, assinaturas desactualizadas, fila, falhas e idade dos itens pendentes. malware:health dá uma verificação manual; ainda não está ligado a um sistema de alertas.
  3. Executar testes adicionais de timeout do socket, documento cifrado/protegido por senha e limite de descompressão com artefactos padrão benignos num ambiente autorizado.
  4. Inventariar em modo seco todos os documentos antigos e processar apenas em lotes revistos. A migração marca os registos anteriores como pending; nenhum ficheiro é apagado, aprovado ou publicado automaticamente. Não foi executada migração na base activa.
  5. Definir retenção administrativa para ficheiros suspeitos e histórico. Até existir política, os ficheiros suspeitos permanecem preservados no armazenamento privado.

Operação e recuperação

Manter o daemon em loopback (ou a rede privada isolada descrita no Compose), actualizar assinaturas por canal oficial e confirmar php artisan malware:health. Manter o worker activo com timeout inferior a retry_after (150 s e 210 s, respectivamente). Para itens parados, listar com php artisan malware:scan-pending --dry-run, rever a contagem e executar lotes limitados com --apply --limit=50. Reprocessamento não remove histórico nem altera publicação. Em falha do scanner, corrigir serviço/configuração e repetir explicitamente; não marcar o ficheiro como limpo manualmente.

Rollback

Desactivar os pontos de entrada do worker mantém documentos não analisados bloqueados. Não remova a migração nem as colunas/histórico após haver resultados. Reverter o código para uma versão sem a barreira de download/publicação antes de preservar dados seria inseguro; qualquer rollback de aplicação deve manter bloqueio de acesso aos ficheiros ainda não analisados e conservar document_malware_scans.

Final QA run — 5 October 2026

  • php artisan test: 285 tests, 3,017 assertions, all passing. PostgreSQL target: isolated investmoz_test at 127.0.0.1:55441; the QA cluster was stopped after testing. No active database migration was run.
  • node --test tests/frontend/*.test.mjs: 144 passing.
  • npm.cmd run types:check: passing.
  • npm.cmd run build: passing. Existing warnings: optional fontaine is absent and the services bundle exceeds 500 kB.
  • PHP syntax checks passed for the scanner, worker, commands, controller, and affected feature tests. The document library TSX passed vp fmt --check.
  • php artisan documents:scan-pending --limit=50 with explicit QA connection variables: zero rows eligible; dry-run made no changes.
  • Browser QA against the isolated router: desktop 1440 px and mobile 390 px both HTTP 200, no horizontal overflow, keyboard skip link focused first, empty catalogue shown, zero JS errors. The active catalogue remains empty.
  • The local development scanner remains running only on loopback; the temporary database and QA web server were stopped.

Windows/Laragon persistence

Two user-level Scheduled Tasks were registered (no system-wide service or firewall rule): InvestMoz ClamAV Loopback Scanner starts clamd at user sign-in; InvestMoz ClamAV Signature Update runs at sign-in and every two hours. Both use the local per-user ClamAV installation and limited user token. The update task was started manually after registration and completed with exit code 0; malware:health then passed. The daemon task was restarted and observed loading 3,628,118 signatures before binding 127.0.0.1:3310; startup took about 12 seconds. During startup the portal fails closed and leaves files pending/quarantined.

To remove these per-user tasks, run Unregister-ScheduledTask -TaskName 'InvestMoz ClamAV Loopback Scanner','InvestMoz ClamAV Signature Update' -Confirm:$false. Removing them does not delete signature databases or scan history. The current loopback daemon is running under the user session; on the next sign-in the scheduled task starts it again.

Follow-up security tests and activation check — 5 October 2026

  • Added a streaming ZIP metadata guard: malformed ZIPs, missing ZIP inspection support, more than 1,000 entries, or declared expanded content above 100 MiB remain inconclusive. This check runs before ClamAV.
  • The first real-daemon test with a harmless ZIP declaring 110 MiB returned clean from local ClamAV 1.5.4 despite MaxScanSize 100M and AlertExceedsMax yes being loaded. The application-side limit guard now rejects that fixture as archive_decompression_limit; the same over-limit case passed after the correction. This is not evidence that ClamAV's own limit alert fired.
  • A harmless AES-encrypted ZIP was scanned by local ClamAV and returned inconclusive with encrypted_or_password_protected.
  • A local controlled TCP fixture completed the ClamD handshake and timed out during INSTREAM. The scanner now returns inconclusive/scanner_timeout; this validates the timeout handling path, not daemon capacity.
  • php artisan test --filter=ClamDScannerIntegrationTest: 5 tests / 20 assertions passed. ClamDQueueWorkerIntegrationTest: 1 / 9 passed; PortalServicesTest: 9 / 289 passed; InvestmentZoneTest: 10 / 161 passed. All used isolated PostgreSQL investemoz_test on 127.0.0.1:55441.
  • The standard positive-detection fixture remains blocked by the execution policy. It was not recreated, encoded differently, or otherwise bypassed; positive detection is still pending an authorized validation route.
  • The active database was confirmed read-only as PostgreSQL 17.11, investemoz, 127.0.0.1:5432. It still has the 2026-10-05 catalogue and malware migrations pending. An automated attempt to create a backup file using pg_dump was rejected by the execution policy, so no backup was created and no active migration or document import/publication was attempted.
  • No Laravel queue worker task exists. Only the per-user ClamAV daemon/signature tasks are registered. The shared default queue is not started automatically because it may contain non-malware application jobs.
  • The public library remains empty. Official INM catalogue records identify two document candidates (BR 89/2017 rectification of Law 13/2016 and BR 248/2025 supplement with Laws 7–12/2025); their local PDF bytes still need comparison with the official copies, and a manager must record per-file rights/version metadata and publish explicitly after active schema activation. The Lei 22/2022 candidate is the corrected 2nd supplement version; the main-gazette version is explicitly marked ineffective by INM.
  • Hosting was not defined or reached; Linux and Docker files are deployment templates only.