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

74 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.