74 lines
10 KiB
Markdown
74 lines
10 KiB
Markdown
# 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.
|