10 KiB
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.
freshclamactualizou a base oficial;malware:healthreportou assinaturas 28144, data UTC2026-10-05T08:24:24Z, com cerca de 1,5 horas quando verificado.clamdcorreu no momento da validação e escuta apenas em127.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 realqueue:work --onceligado à base isoladainvestmoz_testprocessou 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
- 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.
- Acrescentar monitorização e alertas operacionais para indisponibilidade, assinaturas desactualizadas, fila, falhas e idade dos itens pendentes.
malware:healthdá uma verificação manual; ainda não está ligado a um sistema de alertas. - 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.
- 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. - 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: isolatedinvestmoz_testat127.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: optionalfontaineis 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=50with 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
cleanfrom local ClamAV 1.5.4 despiteMaxScanSize 100MandAlertExceedsMax yesbeing loaded. The application-side limit guard now rejects that fixture asarchive_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
inconclusivewithencrypted_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 PostgreSQLinvestemoz_teston127.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 usingpg_dumpwas 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.