# 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.