Lucas
485f628374
Config/memória de ferramentas de IA (.claude, .wolf, .opencode, .codex, .cursor, CLAUDE.md, AGENTS.md, GEMINI.md) não faz parte do produto e não deve ir para o GitHub; fica só no .gitignore. README também não cita mais o projeto irmão.
48 lines
1.8 KiB
Markdown
48 lines
1.8 KiB
Markdown
# Sabiá
|
|
|
|
Auditoria, monitoramento e pentest de redes Wi-Fi — terminal e interface
|
|
gráfica sobre o mesmo núcleo, com foco na interface gráfica e uso
|
|
intuitivo: a parte complexa (netlink, radiotap, parsing de quadro 802.11)
|
|
fica escondida em `sabia-core`; CLI e GUI só consomem.
|
|
|
|
> Use apenas em redes próprias ou com autorização explícita do responsável
|
|
> pela rede (engajamento de pentest formal). Toda ativação de modo monitor
|
|
> e sessão de captura é registrada numa trilha de auditoria local
|
|
> encadeada por hash (`.sabia-audit.log`).
|
|
|
|
## Estrutura
|
|
|
|
```
|
|
crates/sabia-core biblioteca: netlink (iw), radiotap, parsing 802.11,
|
|
captura crua (AF_PACKET), auditoria, auto-atualização
|
|
crates/sabia-cli binário `sabia`: comandos de terminal + servidor
|
|
local da interface (`sabia ui`)
|
|
apps/gui/ui mesma página HTML/JS servida pelo `sabia ui`
|
|
apps/gui/src-tauri shell desktop (Tauri) — esqueleto
|
|
```
|
|
|
|
## Uso
|
|
|
|
```
|
|
sabia iface list # lista interfaces, marca as Wi-Fi
|
|
sabia iface monitor <if> on # liga modo monitor (precisa root)
|
|
sabia scan <if> --out captura.pcap # varre canais, mostra APs/clientes
|
|
sabia ui # abre a interface gráfica local
|
|
sabia update # verifica atualização
|
|
sabia update --apply # baixa e aplica a atualização
|
|
```
|
|
|
|
Capturar quadros 802.11 exige `CAP_NET_RAW`/`CAP_NET_ADMIN` — normalmente
|
|
root (`sudo sabia ...`).
|
|
|
|
## Dependências externas
|
|
|
|
`iw` e `ip` (iproute2) para controlar modo monitor e canal — é uma ponte
|
|
deliberada até existir uma implementação nl80211 nativa. A captura em si
|
|
(AF_PACKET) e todo o parsing de quadro são Rust puro, sem libpcap.
|
|
|
|
## Hardware testado
|
|
|
|
Adaptador USB RTL8812AU (driver `rtw88_8812au`), suporta modo monitor e
|
|
injeção.
|