Configuracao

Idioma: Português (pt-BR) | English: Configuration

Configuração

Opções avançadas de configuração para o WirelessXPL-Forge.

---

Opções Globais do Framework

Defina estas opções no prompt principal wxf >. Elas se aplicam a todos os módulos, salvo sobrescrita por módulo.

wxf > set LOGLEVEL debug
wxf > set TIMEOUT 10
wxf > set THREADS 4
wxf > set SIMULATE true
wxf > set OUTPUT_DIR /evidence
wxf > set SESSION_ID pentest_office_2026_06

Opção	Padrão	Descrição
LOGLEVEL	info	Verbosidade de log: debug, info, warning, error
TIMEOUT	30	Timeout de rede/captura em segundos
THREADS	2	Threads paralelas para módulos do tipo scan
SIMULATE	false	Flag global de simulação
OUTPUT_DIR	/tmp	Diretório de saída padrão para capturas e exportações
SESSION_ID	``	Identificador para o Evidence Vault e Session Manager

---

Arquivo de Configuração

O WXF lê ~/.wxf/config.yaml (ou wxf.yaml no diretório de trabalho) na inicialização.

# ~/.wxf/config.yaml

framework:
  loglevel: info
  timeout: 30
  threads: 2
  simulate: false
  output_dir: /evidence

defaults:
  interface: wlan0mon
  gps_port: /dev/ttyACM0
  vault_dir: /evidence
  operator: j.analyst

modules:
  subghz:
    default_interface: hackrf
    default_simulate: true

  drones:
    mavlink_timeout: 5

  wids:
    deauth_thresh: 10
    beacon_thresh: 50
    alert_log: /logs/wids_alerts.json

---

Configuração de Interface

Modo monitor WiFi

# Usando suite aircrack-ng
sudo airmon-ng check kill
sudo airmon-ng start wlan0
# Cria: wlan0mon

# Usando iw
sudo ip link set wlan0 down
sudo iw wlan0 set monitor none
sudo ip link set wlan0 up

# Verificar
iw wlan0mon info

Gerenciamento de canal

# Fixar no canal 6
sudo iw wlan0mon set channel 6

# Fixar no canal 6 com HT40+
sudo iw wlan0mon set channel 6 HT40+

# O WXF gerencia o bloqueio de canal internamente quando a opção CHANNEL está definida
wxf (HandshakeSnooper) > set CHANNEL 6

---

Opções de Proxy e Rede

Para módulos que fazem conexões de saída (MAVLink, marítimo, etc.), defina opções de rede por módulo:

wxf (MAVLinkScanner) > set RHOST 192.168.1.100
wxf (MAVLinkScanner) > set RPORT 14550
wxf (MAVLinkScanner) > set TIMEOUT 5

---

Saída e Log

Níveis de log

wxf > set LOGLEVEL debug
[*] Verbose logging enabled
[DEBUG] Module loaded: generic/wifi_lab/handshake_snooper
[DEBUG] Option set: INTERFACE = wlan0mon
...

wxf > set LOGLEVEL warning
[*] Only warnings and errors will be shown

Log em arquivo

# Executar WXF com saída registrada em arquivo
python wxf.py 2>&1 | tee /logs/wxf_session_20260608.log

# Ou dentro do WXF:
wxf > set LOG_FILE /logs/wxf_session_20260608.log

---

Integração com Hashcat

O WXF exporta capturas em formatos prontos para o hashcat:

# WPA2 PMKID / EAPOL (modo 22000)
hashcat -m 22000 capture.hc22000 /usr/share/wordlists/rockyou.txt

# WPA2 EAPOL handshake apenas (modo legado)
hashcat -m 2500 capture.hccapx /usr/share/wordlists/rockyou.txt

# WPA2 com regras
hashcat -m 22000 capture.hc22000 rockyou.txt -r /usr/share/hashcat/rules/best64.rule

# Verificar hardware
hashcat -I

---

Variáveis de Ambiente

Sobrescreva a configuração via variáveis de ambiente (prefixo WXF_):

export WXF_LOGLEVEL=debug
export WXF_OUTPUT_DIR=/mnt/evidence
export WXF_SIMULATE=true
export WXF_INTERFACE=wlan0mon
python wxf.py

---

Notas para WSL2

Para usuários do WSL2, adaptadores WiFi USB requerem passagem USB (USB passthrough):

# PowerShell do Windows (administrador)
usbipd list
usbipd bind --busid 1-1
usbipd attach --wsl --busid 1-1

# WSL2 (Linux)
lsusb  # verificar se o adaptador está visível
sudo airmon-ng start wlan0

HackRF e RTL-SDR também requerem passagem USB via usbipd-win.

---

Verificação de Dependências

Após qualquer instalação ou alteração no sistema, execute a auditoria de dependências:

wxf > use generic/external/wireless_tool_prereq_audit
wxf (PrereqAudit) > run

[*] Checking system tool dependencies...
[+] aircrack-ng       : found (/usr/bin/aircrack-ng) v1.7
[+] hcxdumptool       : found (/usr/bin/hcxdumptool) v6.2.7
[+] hashcat           : found (/usr/bin/hashcat) v6.2.6
[+] tshark            : found (/usr/bin/tshark) v4.2.0
[+] hackrf_transfer   : found (/usr/local/bin/hackrf_transfer) 2023.01.1
[+] rtl_test          : found (/usr/bin/rtl_test) v0.6.0
[!] mdk4              : NOT FOUND - optional (beacon flood, deauth storm)
[!] hostapd           : NOT FOUND - optional (evil twin, rogue AP)
[*] Core tools: OK | Optional tools: 2 missing
[*] Install missing: sudo apt install mdk4 hostapd dnsmasq

---

Páginas relacionadas: Início Rápido | Referência CLI | Hardware

---

Autor: André Henrique (@mrhenrike) | União Geek