Lucas RayanandClaude Sonnet 5
1b974bb90d
Acauã: Network Detection & Threat Hunting, heuristic analysis over a rolling 7-day window using deterministic math (time series, graph theory, information theory) instead of opaque ML models. Third product in the Ciberfauna ecosystem, alongside Guará and Sabiá. Follows the ecosystem's established conventions: OpenWolf project memory, bilingual PT-BR/EN docs and UI, Gitea Actions CI/CD on the same self-hosted runners, Conventional Commits, SemVer, logo and productName handling, MIT OR Apache-2.0 licensing. Architecture decision (made with the project owner after a dedicated consultation, not the original blueprint's suggested stack): Rust throughout, not Python/FastAPI/React. Most of the statistics (Bowley skew, MADM, Shannon entropy, PCR, Z-score, novel-edge detection, pivot chains) reduces to SQL over an embedded DuckDB/Parquet store; only the spectral analysis and graph centrality need host-language code, and both have workable Rust crates. Documented in full, including six corrections to the original blueprint's math (Rayleigh/Schuster instead of a degenerate Lomb-Scargle over bare timestamps, an explicit sentinel for Bowley skew's Q3=Q1 case, Jensen-Shannon instead of unbounded KL, a dedicated long-connection detector, JA4 vs. JA4+ licensing caution, deterministic per-alert evidence), in docs/architecture.md. Skeleton only: crates/acaua-core has the four detection pillars, fusion, storage, zeek log parsing and the updater as typed stubs that compile and return a clear "skeleton" status rather than real detection logic — that is separate, future work. crates/acaua-cli has serve/analyze/doctor/update. apps/gui is a minimal Tauri shell. Also already includes the one-click desktop self-update mechanism shared with Guará and Sabiá (AppImage/.deb/Windows installer), even with no release published yet, for consistency across the ecosystem. No Gitea repository exists for this project yet; this is a local-only commit. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VAyr8d7HuAdUGB6aA5xmDD
2.1 KiB
2.1 KiB
Política de segurança
English · Português
O Acauã é software defensivo, mas processa entrada hostil: capturas de pacotes, logs Zeek e registros de fluxo podem estar malformados de propósito. Trate todo dataset como não confiável.
Reportando uma vulnerabilidade
Não abra issue pública com detalhes de exploração. Abra uma issue mínima pedindo um canal privado, ou contate o mantenedor pelo perfil no Gitea indicado no repositório. Inclua a versão afetada, o formato da entrada e uma reprodução mínima quando houver canal privado.
Escopo e modelo de ameaça
- Parsing de entrada: uma linha malformada não pode derrubar o daemon, esgotar memória ou escapar do diretório de dados configurado.
- Caminhos: caminhos de dataset são resolvidos e confinados à raiz configurada; links simbólicos não são seguidos para fora dela.
- Exposição da API: o
serveescuta em127.0.0.1por padrão. Expor em uma interface de rede é decisão explícita do operador e exige proxy reverso com autenticação. - Integridade da evidência: a evidência de um alerta precisa ser reproduzível com a mesma entrada e a mesma versão do código. Não determinismo silencioso é problema de correção e de segurança.
- Atualizações: a CLI consulta Gitea Releases, baixa por HTTPS e verifica SHA-256 antes de substituir o binário. O app desktop não se atualiza sozinho.
- Privacidade: não há telemetria. A retenção padrão é de sete dias de eventos normalizados; o operador responde pela lei e pela política local.
Fora de escopo
- Vulnerabilidades em pacotes de terceiros (Zeek, Suricata, Tauri ou sistema operacional) já corrigidas upstream.
- Ataques que exigem desligar controles documentados (por exemplo, rodar
servecomo root em interface pública). - Alegações de qualidade de detecção: os pilares não estão implementados neste esqueleto.
Versões suportadas
Só a linha 0.1.x mais recente é suportada enquanto o projeto é pré-alfa. Ainda
não existe branch de suporte de longo prazo.