Monitor de exploração em tempo de execução para pipelines de documentos/imagens da Apple (iOS/macOS) — conceito EXPMON: agente Frida + regras comportamentais. Primeiro alvo: a cadeia de glifos CVE-2026-86950.
O hotcell instrumenta APIs reais de renderização da Apple com Frida e correlaciona o comportamento observado com descobertas estáticas opcionais do elegant-bouncer. É um monitor defensivo experimental, inspirado no EXPMON. Uma sessão silenciosa não é prova de que um arquivo é seguro, e as regras de glifos não foram validadas contra um corpus de exploits em ambiente real.
A versão 0.3 é uma aplicação Rust: CLI, ciclo de vida do Frida, renderizador nativo da Apple, adaptador estático, correlação e geração de relatórios. O agente JavaScript do Frida e as regras YAML estão embutidos no executável. Python não é necessário.
Use Rust 1.88 ou mais recente. Compilações para macOS exigem as Command Line Tools da Apple (xcode-select --install), incluindo Clang/libclang para gerar os bindings do Frida.
cargo build --release --locked
./target/release/hotcell --version
# Install from this checkout.
cargo install --path . --locked
A primeira compilação baixa o devkit nativo fixado do Frida 17.19.0. Uma pequena cópia local dos bindings Rust seleciona esta versão qualificada; consulte vendor/frida-sys. As varreduras em tempo de execução usam um subprocesso do mesmo executável chamando CoreGraphics/ImageIO diretamente. Nenhum compilador, Python, arquivo de agente separado ou Frida instalado separadamente é necessário no host de varredura.
Para varredura estática e reprodução de relatórios sem a dependência do Frida:
cargo build --release --locked --no-default-features
As builds Linux com o recurso padrão também exigem os arquivos de desenvolvimento do libclang
(apt-get install libclang-dev no Debian/Ubuntu). Ambas as configurações de recursos
são testadas em Linux arm64 com Rust 1.88. A renderização de arquivos em tempo de execução requer macOS;
consulte resultados de qualificação e lacunas restantes.
# Scan every PDF page or image frame in one monitored process.
hotcell scan --file document.pdf --out report/
# Static only; requires elegantbouncer on PATH or HOTCELL_BOUNCER pointing at it.
hotcell scan --file document.pdf --static-only --out report/
# Runtime only.
hotcell scan --file image.png --no-static --minutes 1 --out report/
# Enumerate candidate processes, then attach by name or PID.
hotcell list
hotcell watch --target Preview --minutes 5
hotcell watch --target 12345 --target 12346 --minutes 5
# iOS monitoring requires an accessible Frida device/process.
hotcell watch --device usb --target WhatsApp
# Replay raw observations with the embedded or another rule pack.
hotcell report --session report/SESSION.session.json --out replay/
hotcell report --session report/SESSION.session.json --rules custom.yaml
scan carrega e verifica o agente antes de retomar o renderer, registra chamadas
de renderização reais e exige um handshake de conclusão reconhecido. Ele grava uma
pré-visualização PNG da primeira página/frame. Varreduras de arquivos em tempo de execução exigem macOS.
Isto não reproduz a cadeia de entrega QuickLook/PDFKit/PaperKit:
o qlmanage do sistema pode rejeitar a injeção, e o QuickLook pode renderizar em serviços
separados. watch monitora apenas os processos anexados; ele não segue
automaticamente serviços XPC ou processos filhos. O macOS pode recusar a anexação a aplicações
protegidas; o relatório registra essa falha.
Cada execução grava uma sessão JSON e um relatório Markdown. O JSON contém sinais brutos, identidade do processo, timestamps em segundos, contexto, capacidades, erros e veredictos. Relatórios com sinais brutos do Python v0.2 permanecem reproduzíveis. Relatórios legados sem sinais brutos são rejeitados porque seu veredicto não pode ser recalculado fielmente. A reprodução também rejeita timestamps ausentes ou malformados e unidades de timestamp não suportadas; ela nunca substitui a hora atual pelas observações salvas.
| Veredicto | Significado |
|---|---|
log | Nenhum limiar de pontuação atingido; não significa seguro |
investigate | Pontuação de pelo menos 35 sem uma cadeia correspondida com peso suficiente |
exploit-likely | Pontuação de pelo menos 100 com uma cadeia de regras correspondida; uma heurística, não uma prova |
O status da varredura é separado do veredicto. Hooks ausentes são listados. Falhas do agente,
timeouts de renderização, entradas malformadas/não suportadas e erros do scanner estático produzem
incomplete e status de saída 2. Uma execução concluída sai com 0, incluindo execuções com
achados; os consumidores devem inspecionar o veredicto do relatório. Um scanner estático opcional
ausente é divulgado e a varredura em tempo de execução continua; --static-only o exige.
Você não pode combinar --static-only e --no-static.
Os resultados estáticos analisam a tabela de resumo de arquivo único do ELEGANTBOUNCER e linhas de ameaça
legadas. Falhas de inicialização, saídas diferentes de zero, timeouts e saída não reconhecida são
incompletas. Definir HOTCELL_BOUNCER torna o estágio estático obrigatório: um scanner configurado
ausente ou inutilizável marca a varredura como incompleta mesmo se a renderização
for bem-sucedida. Sem essa substituição, um scanner ausente é relatado como indisponível
e a varredura em tempo de execução ainda pode ser concluída. --no-static o ignora explicitamente.
Os achados estáticos permanecem disponíveis quando a varredura em tempo de execução falha.
CTFontCreatePathForGlyph,
usando uma assinatura nativa de retorno de struct. Os limites estão em unidades de espaço do usuário; a
API pública não expõe os limites de ponto fixo internos do rasterizador.aa_cache_render é relatado como ausente quando não exportado.
Caminhos de renderização que não chamam essas APIs exportadas podem evadir essas regras.src/ Rust CLI, lifecycle, Apple renderer, rules and reporting
assets/hotcell_agent.js embedded Frida instrumentation
assets/default.yaml embedded default rules (override with --rules)
vendor/frida-sys/ bindings pinned to the qualified native devkit
tests/ Rust regression, CLI, and opt-in native tests
docs/coverage.md verified coverage and remaining limits
cargo test --locked
cargo test --locked --no-default-features
cargo fmt --all -- --check
cargo clippy --locked --all-targets -- -D warnings
# macOS tests that instrument only their own benign processes.
cargo test --locked -- --ignored --test-threads=1
Os testes nativos compilam uma pequena sonda de teste em Objective-C, injetam o agente embutido real, escaneiam fixtures benignas de PDF/PNG, verificam entradas malformadas, comparam limites de glifos nativos e observados, exercitam comprimentos de mapeamento de 64 bits e reproduzem relatórios. Glifos superdimensionados são sinais de teste controlados, não exploits reais.