chore: initial project skeleton
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
This commit is contained in:
Lucas RayanandClaude Sonnet 5 committed
commit
1b974bb90d
95 files changed
+12016
No files matched your search
@@ -0,0 +1,177 @@
|
||||
# Arquitetura
|
||||
|
||||
[English](../architecture.md) · **Português**
|
||||
|
||||
O Acauã é um único produto Rust: um daemon/CLI, um núcleo compartilhado, uma UI
|
||||
web embutida e um shell Tauri. O runtime distribuído não tem Python nem banco
|
||||
externo. Este documento registra as decisões estruturais e as seis correções
|
||||
aplicadas ao blueprint original.
|
||||
|
||||
## Stack
|
||||
|
||||
| Camada | Escolha | Por quê |
|
||||
|---|---|---|
|
||||
| Núcleo, CLI e daemon | Rust 2021 | Uma toolchain, segurança de memória, sem dependência de runtime |
|
||||
| API HTTP | Axum + Tokio + Tower HTTP | Superfície async pequena e fácil de embutir |
|
||||
| UI | HTML/CSS/JS vanilla | Sem etapa de build de frontend, assets embutidos no binário |
|
||||
| Desktop | Tauri 2 | Janela nativa sobre a mesma UI |
|
||||
| Armazenamento analítico | DuckDB + Parquet (feature opcional `duckdb`) | Embutido, colunar, local-first |
|
||||
| Validação científica | Python só em `research/` | astropy/scipy/networkx para fixtures, nunca distribuído |
|
||||
|
||||
O workspace tem dois crates: `acaua-core` e `acaua-cli`. A GUI fica em
|
||||
`apps/gui`, **fora** do workspace Cargo, como no Guará e no Sabiá. A spec citou
|
||||
`version.workspace = true` para o manifesto do desktop; manter a GUI fora do
|
||||
workspace torna isso impossível, então o `check.sh` impõe igualdade de SemVer
|
||||
entre `Cargo.toml`, `acaua-cli/Cargo.toml`, o manifesto do desktop e
|
||||
`tauri.conf.json`. É um desvio deliberado, não um esquecimento.
|
||||
|
||||
## Componentes
|
||||
|
||||
```
|
||||
Logs Zeek ──► acaua-core::zeek ──► eventos normalizados ──► armazenamento
|
||||
│
|
||||
├──► pilar1 (beaconing)
|
||||
├──► pilar2 (sessões persistentes)
|
||||
├──► pilar3 (anomalias de protocolo)
|
||||
└──► pilar4 (fusão) ──► alertas + evidência
|
||||
│
|
||||
acaua-cli ──► API axum ──► UI embutida ◄── shell Tauri ────────────┘
|
||||
```
|
||||
|
||||
- `zeek`: parser limitado e confinamento de caminho. Nunca segue link simbólico
|
||||
para fora da raiz do dataset.
|
||||
- `storage`: escritor DuckDB/Parquet com TTL de sete dias. Desligado por padrão
|
||||
para o esqueleto não exigir build C++.
|
||||
- `pillar1`–`pillar4`: funções puras sobre eventos normalizados. Devolvem
|
||||
pontuação e evidência, nunca só um float.
|
||||
- `fusion`: combinação limitada e em ordem fixa. Precisa ser simétrica e
|
||||
reproduzível.
|
||||
- `doctor`: checagens do ambiente local; sem chamadas de rede exceto a checagem
|
||||
explícita de atualização.
|
||||
- `update`: cliente de Gitea Releases só para a CLI.
|
||||
|
||||
## As seis correções
|
||||
|
||||
### 1. Rayleigh/Schuster, não Lomb–Scargle puro
|
||||
|
||||
Timestamps de eventos são um processo pontual unidimensional: não existe um `y`
|
||||
para ajustar. O periodograma primário é, portanto, Rayleigh/Schuster:
|
||||
|
||||
```text
|
||||
P(f) = |sum_k exp(2*pi*i*f*t_k)|^2 / N
|
||||
```
|
||||
|
||||
O Lomb–Scargle generalizado só é usado quando existe um `y` real (por exemplo,
|
||||
bytes por bucket). Isso evita inventar uma variável dependente e mantém a
|
||||
distribuição nula honesta.
|
||||
|
||||
### 2. Bowley com sentinela explícito
|
||||
|
||||
O coeficiente de Bowley usa quartis. Quando `Q3 == Q1`, o denominador é zero; a
|
||||
implementação devolve um sentinela documentado (`0.0` com a flag de evidência
|
||||
`degenerate_quartiles`) em vez de `NaN`, infinito ou panic. O sentinela faz parte
|
||||
do registro do alerta, não é fallback silencioso.
|
||||
|
||||
### 3. Jensen–Shannon, não KL puro
|
||||
|
||||
KL diverge quando a distribuição de referência tem zero onde a observada não
|
||||
tem. A fusão usa Jensen–Shannon, que é simétrica, limitada e definida para bins
|
||||
com probabilidade zero com um piso de suavização documentado. Isso torna a
|
||||
pontuação comparável entre pilares e segura para histogramas esparsos.
|
||||
|
||||
### 4. Sessões persistentes têm detector próprio
|
||||
|
||||
Uma conexão aberta por horas nunca produz um intervalo curto, então um detector
|
||||
de beaconing pode ignorá-la. O pilar 2 pontua duração, lacunas ociosas e fluxos
|
||||
longos repetidos diretamente. Os dois pilares podem disparar; a fusão trata isso
|
||||
como evidências separadas, não como contagem dupla do mesmo sinal.
|
||||
|
||||
### 5. Cautela com a licença JA4
|
||||
|
||||
A impressão digital JA4 de cliente TLS pode ser usada. JA4S, JA4H, JA4X, JA4SSH
|
||||
e JA4L têm licença não-OSI e **não** são habilitadas por padrão. Qualquer uso
|
||||
futuro exige decisão explícita de licenciamento e opt-in documentado. O conjunto
|
||||
padrão precisa continuar redistribuível sob MIT/Apache-2.0.
|
||||
|
||||
### 6. Determinismo e evidência JSON por alerta
|
||||
|
||||
Todo alerta carrega um registro JSON: hash do dataset, versão do código, pilar,
|
||||
entradas, valores intermediários, sentinelas, pesos e pontuação final. As
|
||||
reduções rodam em ordem fixa; iteração de hash map ou agendamento de threads não
|
||||
pode mudar uma pontuação. Com a mesma entrada e versão, a evidência precisa ser
|
||||
byte a byte idêntica.
|
||||
|
||||
## Fluxo de dados
|
||||
|
||||
1. `acaua analyze <dir>` valida o diretório, lê logs suportados e normaliza
|
||||
eventos. Neste esqueleto ele valida e devolve um relatório stub.
|
||||
2. Eventos normalizados vão para o armazenamento local (quando a feature
|
||||
`duckdb` está ligada) com TTL de sete dias.
|
||||
3. Cada pilar roda sobre uma janela determinística e devolve candidatos com
|
||||
evidência.
|
||||
4. A fusão combina candidatos, aplica limiares e grava alertas.
|
||||
5. `serve` expõe a API e a UI embutida; o shell Tauri abre a mesma UI contra um
|
||||
daemon local ou remoto.
|
||||
|
||||
## API
|
||||
|
||||
| Método | Caminho | Finalidade |
|
||||
|---|---|---|
|
||||
| GET | `/api/health` | Liveness e versão |
|
||||
| GET | `/api/status` | Uptime, diretório de dados, estado dos pilares |
|
||||
| GET | `/api/alerts` | Alertas paginados com evidência |
|
||||
| POST | `/api/analyze` | Analisar um caminho de dataset |
|
||||
| POST | `/api/update` | Checar atualização da CLI |
|
||||
| GET | `/logo.png` | Asset de marca embutido |
|
||||
| GET | `/*` | Fallback da UI embutida |
|
||||
|
||||
O `serve` escuta em `127.0.0.1:8787` por padrão. Não há camada de autenticação
|
||||
no esqueleto; expor em interface de rede exige proxy reverso com autenticação.
|
||||
|
||||
## Armazenamento
|
||||
|
||||
DuckDB é dependência **opcional** (`features = ["duckdb"]`, `bundled`). O
|
||||
esqueleto padrão não compila o backend C++. Quando ligado, o schema é de eventos
|
||||
normalizados append-only mais uma tabela de alertas, com exportação Parquet e
|
||||
retenção de sete dias. O arquivo do banco fica sob o diretório de dados
|
||||
configurado e nunca fora dele.
|
||||
|
||||
## Atualizações
|
||||
|
||||
`update.rs` consulta a API de Gitea Releases do repositório `acaua`, escolhe o
|
||||
asset da plataforma atual, baixa por HTTPS com `curl`, verifica SHA-256 e
|
||||
substitui o binário da CLI. Ele se recusa a atualizar automaticamente uma GUI em
|
||||
execução; o desktop só informa que existe versão nova. Isso espelha o updater do
|
||||
Sabiá e evita um segundo mecanismo de atualização.
|
||||
|
||||
O plugin updater do Tauri e seu fluxo de manifesto e assinatura não são usados
|
||||
de propósito: adicionariam um segundo caminho de assinatura e distribuição, e o
|
||||
desktop não deve se auto-atualizar. O caminho único da CLI é mais fácil de
|
||||
auditar e mantém os assets de release em tarballs mais SHA-256.
|
||||
|
||||
## Alternativas rejeitadas
|
||||
|
||||
Um blueprint anterior propunha um serviço Python e um banco colunar externo. Os
|
||||
dois são rejeitados. Um serviço Python adicionaria um segundo runtime, custo de
|
||||
empacotamento e uma fronteira de rede dentro de uma ferramenta local-first; um
|
||||
banco externo adicionaria servidor e custo operacional para datasets que cabem em
|
||||
um armazenamento colunar embutido. O produto é 100% Rust, com Python confinado a
|
||||
`research/`.
|
||||
|
||||
## Implantação
|
||||
|
||||
- **Nativa:** `cargo build --release -p acaua-cli`, depois `acaua serve`.
|
||||
- **Desktop:** bundles Tauri para Linux e Windows, construídos no CI.
|
||||
- **Docker:** imagem enxuta de runtime para laboratório; veja [docker.md](docker.md).
|
||||
|
||||
## Comportamento em falha
|
||||
|
||||
Entrada malformada é ignorada com diagnóstico contado e limitado. Log ausente não
|
||||
é fatal. Store corrompido é reportado pelo `doctor` e nunca recriado por cima de
|
||||
dados existentes. Atualização falha mantém o binário atual.
|
||||
|
||||
## Versionamento e compatibilidade
|
||||
|
||||
SemVer 2.0.0. O JSON de evidência carrega versão de schema. Qualquer mudança em
|
||||
pontuação ou no formato da evidência é quebra para versões menores `0.x` e
|
||||
precisa constar no changelog.
|
||||
@@ -0,0 +1,106 @@
|
||||
# Terminal
|
||||
|
||||
[English](../cli.md) · **Português**
|
||||
|
||||
O binário `acaua` é ao mesmo tempo CLI e daemon. Esta página descreve os comandos
|
||||
que existem no esqueleto `0.1.0`. A detecção ainda não está implementada; o
|
||||
`analyze` valida a entrada e devolve um relatório stub.
|
||||
|
||||
```text
|
||||
acaua <comando> [opções]
|
||||
|
||||
Comandos:
|
||||
serve Sobe a API e a UI embutida
|
||||
analyze Analisa um diretório de logs Zeek
|
||||
doctor Checa o ambiente local
|
||||
update Checa ou aplica atualização da CLI
|
||||
```
|
||||
|
||||
## `acaua serve`
|
||||
|
||||
Sobe a API HTTP e a UI embutida.
|
||||
|
||||
```bash
|
||||
acaua serve --bind 127.0.0.1:8787 --data-dir .acaua
|
||||
```
|
||||
|
||||
| Opção | Padrão | Significado |
|
||||
|---|---|---|
|
||||
| `--bind` | `127.0.0.1:8787` | Endereço de escuta |
|
||||
| `--data-dir` | `.acaua` | Store e arquivos de runtime |
|
||||
|
||||
O bind padrão é só loopback. Expor o daemon na rede exige proxy reverso com
|
||||
autenticação. A API está documentada em
|
||||
[arquitetura.md](arquitetura.md#api).
|
||||
|
||||
## `acaua analyze`
|
||||
|
||||
```bash
|
||||
acaua analyze /var/log/zeek/current
|
||||
acaua analyze /var/log/zeek/current --json
|
||||
```
|
||||
|
||||
O diretório é validado e um relatório é impresso. Neste esqueleto o parser ainda
|
||||
não lê registros Zeek: `logs lidos` e `registros` são placeholders, e `alertas`
|
||||
vem vazio. O comando continua útil para conferir tratamento de caminho e o
|
||||
formato JSON.
|
||||
|
||||
O parser futuro vai suportar `conn.log`, `dns.log`, `ssl.log` e os logs de
|
||||
protocolo necessários para identidade e movimento lateral. NetFlow/IPFIX é modo
|
||||
degradado; não equivale a logs completos de protocolo.
|
||||
|
||||
## `acaua doctor`
|
||||
|
||||
```bash
|
||||
acaua doctor
|
||||
acaua doctor --json
|
||||
```
|
||||
|
||||
Imprime checagens de Zeek, `curl`, `tar`, da feature opcional DuckDB e do
|
||||
isolamento de `research/`, seguida do estado (`skeleton` em `0.1.0`). Dependência
|
||||
opcional ausente aparece como `falha`, mas não aborta o comando. Não envia
|
||||
telemetria.
|
||||
|
||||
## `acaua update`
|
||||
|
||||
```bash
|
||||
acaua update
|
||||
acaua update --apply
|
||||
```
|
||||
|
||||
O `update` consulta a última Release do Gitea, compara a tag com a versão em
|
||||
execução e informa se existe atualização. O `--apply` baixa o arquivo da
|
||||
plataforma atual, verifica o SHA-256, extrai e substitui o binário `acaua`.
|
||||
|
||||
Requisitos: `curl` e `tar` no `PATH`, e local de binário com permissão de escrita.
|
||||
O updater se recusa a substituir qualquer executável cujo nome não seja `acaua`;
|
||||
o app desktop deve ser atualizado pelo instalador. Checksum inválido mantém o
|
||||
binário atual intacto.
|
||||
|
||||
## Códigos de saída
|
||||
|
||||
| Código | Significado |
|
||||
|---|---|
|
||||
| `0` | Sucesso |
|
||||
| `1` | Erro de execução (caminho inválido, update falhou, erro de I/O) |
|
||||
| `2` | Uso inválido da linha de comando (clap) |
|
||||
|
||||
## Ambiente
|
||||
|
||||
O esqueleto não exige variável de ambiente. `RUST_LOG` está reservado para a
|
||||
camada de tracing futura. O diretório de dados padrão é relativo ao diretório de
|
||||
trabalho; use caminho absoluto em serviço de sistema.
|
||||
|
||||
## Exemplos
|
||||
|
||||
```bash
|
||||
# Laboratório local
|
||||
acaua doctor
|
||||
acaua analyze ./fixtures/zeek --json
|
||||
acaua serve --bind 127.0.0.1:8787 --data-dir ./.acaua
|
||||
|
||||
# Contêiner
|
||||
docker run --rm -p 127.0.0.1:8787:8787 -v "$PWD/zeek:/data:ro" acaua serve
|
||||
```
|
||||
|
||||
Veja [docker.md](docker.md) para a imagem e o layout de volumes.
|
||||
@@ -0,0 +1,66 @@
|
||||
# Docker
|
||||
|
||||
[English](../docker.md) · **Português**
|
||||
|
||||
A imagem é para laboratório e pesquisa. Ela roda o mesmo binário `acaua` de uma
|
||||
instalação nativa, com a UI embutida. O esqueleto não liga a feature DuckDB na
|
||||
imagem; o armazenamento continua reservado para uma release futura.
|
||||
|
||||
## Build
|
||||
|
||||
```bash
|
||||
docker build -t acaua .
|
||||
docker run --rm -p 127.0.0.1:8787:8787 -v "$PWD/data/acaua:/data/acaua" acaua
|
||||
```
|
||||
|
||||
O estágio de build usa `rust:1-slim-bookworm`; o de runtime usa
|
||||
`debian:bookworm-slim` e instala só `ca-certificates`, `curl` e `tar` (o updater
|
||||
precisa de `curl` e `tar`).
|
||||
|
||||
## Compose
|
||||
|
||||
```bash
|
||||
cp .env.example .env # opcional: defina ZEEK_INTERFACE
|
||||
docker compose up --build
|
||||
```
|
||||
|
||||
O Compose sobe dois serviços:
|
||||
|
||||
| Serviço | Função | Notas |
|
||||
|---|---|---|
|
||||
| `zeek` | Captura e grava logs Zeek em `./data/zeek` | Rede do host e `NET_RAW`/`NET_ADMIN` |
|
||||
| `acaua` | Lê logs e serve UI/API | Porta do host presa a `127.0.0.1:8787` |
|
||||
|
||||
O `acaua` monta `./data/zeek` somente leitura em `/data/zeek` e `./data/acaua`
|
||||
leitura-escrita em `/data/acaua`. O daemon dentro do contêiner escuta
|
||||
`0.0.0.0:8787`, mas a porta publicada é só loopback no host.
|
||||
|
||||
## Layout de dados
|
||||
|
||||
```text
|
||||
data/
|
||||
zeek/ # logs Zeek, escritos pelo serviço zeek
|
||||
acaua/ # store, exportações e arquivos de runtime
|
||||
```
|
||||
|
||||
Não monte a raiz do host nem um diretório com arquivos sensíveis sem relação. O
|
||||
parser deve confinar caminhos à raiz do dataset; o esqueleto ainda não lê
|
||||
registros.
|
||||
|
||||
## Notas de segurança
|
||||
|
||||
- O serviço `zeek` precisa de privilégio de captura. Rode só em interface e rede
|
||||
que você tem autorização para monitorar.
|
||||
- Não mude o mapeamento de porta do host para `0.0.0.0:8787` sem proxy reverso
|
||||
com autenticação.
|
||||
- A imagem não tem telemetria e não faz conexão de saída exceto um
|
||||
`acaua update` explícito.
|
||||
- O contêiner não é sandbox para dataset hostil. Trate captura malformada como
|
||||
entrada hostil e mantenha o contêiner sem privilégios.
|
||||
|
||||
## Limitações
|
||||
|
||||
- Sem build DuckDB na imagem; o armazenamento analítico não está ativo.
|
||||
- A UI é um shell e o `analyze` devolve relatório stub.
|
||||
- A imagem não inclui Zeek; o Compose usa a imagem upstream do Zeek.
|
||||
- Ainda não há imagem publicada em registry. Compile localmente.
|
||||
@@ -0,0 +1,72 @@
|
||||
# Interface
|
||||
|
||||
[English](../interface.md) · **Português**
|
||||
|
||||
A interface é um app HTML/CSS/JS vanilla embutido no binário `acaua` e carregado
|
||||
pelo shell Tauri. Não há etapa de build de frontend nem runtime React/Next.js.
|
||||
Esta página descreve o shell `0.1.0`; não é um tour de screenshots, porque as
|
||||
telas de detecção ainda não têm nada real para mostrar.
|
||||
|
||||
## Layout
|
||||
|
||||
- **Barra lateral:** marca, navegação, estado da conexão, versão e checagem de
|
||||
atualização.
|
||||
- **Visão geral:** aviso de escopo, aviso de uso autorizado e os quatro cards dos
|
||||
pilares.
|
||||
- **Análise:** campo de caminho do dataset, botão analisar, atualizar e saída
|
||||
JSON bruta.
|
||||
- **Alertas:** estado vazio explicando que o motor de detecção chega em spec
|
||||
futura.
|
||||
- **Configurações:** idioma e tema, guardados localmente.
|
||||
|
||||
## Idioma
|
||||
|
||||
O texto-fonte é em português. O `i18n.js` aplica as strings em inglês de
|
||||
`i18n-en.js` em tempo de execução e persiste a escolha no `localStorage`. `Auto`
|
||||
segue o idioma do navegador/sistema. A checagem
|
||||
`node scripts/check-ui-i18n.mjs` falha quando uma string visível em português não
|
||||
tem par em inglês.
|
||||
|
||||
## Tema
|
||||
|
||||
`Auto`, claro e escuro. `Auto` segue `prefers-color-scheme`. A escolha fica
|
||||
guardada localmente; nenhuma preferência sai da máquina.
|
||||
|
||||
## Estado da conexão
|
||||
|
||||
O rodapé consulta `/api/health` e mostra um de:
|
||||
|
||||
- **Conectando…:** a primeira requisição ainda não terminou.
|
||||
- **Serviço local ativo:** `/api/health` respondeu.
|
||||
- **Serviço indisponível:** a requisição falhou; o shell continua utilizável para
|
||||
configurações.
|
||||
|
||||
O shell Tauri poderá apontar para um daemon local ou um `serve` remoto em versão
|
||||
futura. Em `0.1.0` ele usa a API local.
|
||||
|
||||
## Tela de análise
|
||||
|
||||
`Analisar` envia o caminho para `/api/analyze` e imprime a resposta JSON. O
|
||||
esqueleto valida o caminho e devolve um relatório stub. Ele não lê registros Zeek
|
||||
e não renderiza pontuações. Falhas aparecem como texto, nunca como estado vazio
|
||||
silencioso.
|
||||
|
||||
## Tela de alertas
|
||||
|
||||
A lista está vazia de propósito. Uma linha futura de alerta vai mostrar pilar,
|
||||
pontuação, timestamp e link para o registro de evidência. A evidência precisa
|
||||
incluir entradas, valores intermediários, sentinelas, pesos e versão do código;
|
||||
pontuação sozinha não basta.
|
||||
|
||||
## Acessibilidade
|
||||
|
||||
- A navegação usa botões reais e `aria-label`.
|
||||
- O diálogo de configurações usa `<dialog>` com título rotulado.
|
||||
- Mudanças de estado usam texto, não só cor.
|
||||
|
||||
## Limitações
|
||||
|
||||
- Sem screenshots reais: as telas são shells.
|
||||
- Sem detalhe de alerta, gráficos ou navegador de dataset ainda.
|
||||
- Sem autenticação: a UI assume daemon em loopback.
|
||||
- O app desktop não se auto-atualiza; ele só informa a versão disponível.
|
||||
@@ -0,0 +1,47 @@
|
||||
# Suporte
|
||||
|
||||
[English](../support.md) · **Português**
|
||||
|
||||
O Acauã é pré-alfa. Não há contrato de suporte nem binário publicado ainda. O
|
||||
caminho mais rápido para obter ajuda é uma issue objetiva no repositório Gitea.
|
||||
|
||||
## Antes de abrir uma issue
|
||||
|
||||
1. Rode `acaua doctor --json` e guarde a saída.
|
||||
2. Confirme a versão com `acaua --version`.
|
||||
3. Tente a menor entrada que reproduz o problema.
|
||||
4. Leia os [limites conhecidos](../../README.pt-BR.md#limites-conhecidos) e a
|
||||
[arquitetura](arquitetura.md).
|
||||
|
||||
## O que incluir
|
||||
|
||||
- Sistema operacional, arquitetura e versão do Acauã.
|
||||
- O comando exato e a saída completa do terminal.
|
||||
- Se a entrada é diretório de logs Zeek, fixture sintética ou captura.
|
||||
- Para problema de UI: build de navegador ou desktop, idioma e tema.
|
||||
- Para problema de atualização: saída de `acaua update` e se `curl` e `tar` estão
|
||||
no `PATH`.
|
||||
|
||||
Não anexe capturas de produção nem credenciais. Redija endereços, hostnames e
|
||||
payloads antes de compartilhar.
|
||||
|
||||
## Problemas de segurança
|
||||
|
||||
Não inclua detalhes de exploração em issue pública. Siga o
|
||||
[SECURITY.pt-BR.md](../../SECURITY.pt-BR.md) e peça um canal privado primeiro.
|
||||
|
||||
## Situações comuns
|
||||
|
||||
| Sintoma | O que checar |
|
||||
|---|---|
|
||||
| `analyze` devolve zero registros | Esperado em `0.1.0`; o parser é stub |
|
||||
| `serve` inacessível de outra máquina | Ele escuta em loopback por padrão |
|
||||
| `update` falha | `curl`, `tar`, permissão de escrita e assets da release |
|
||||
| Build do desktop falha | Dependências de sistema do Tauri para a plataforma |
|
||||
| UI aparece em português | `Auto` segue o idioma do sistema; escolha English nas configurações |
|
||||
|
||||
## Escopo
|
||||
|
||||
O suporte cobre o código e a documentação do Acauã. Não cobre configuração de
|
||||
Zeek ou Suricata, legalidade de captura de rede ou pacotes de distribuição de
|
||||
terceiros. Use somente em redes próprias ou com autorização para monitorar.
|
||||
Reference in new issue
Block a user