qualcomm/afltriageFerramenta portátil de triagem de falhas baseada em depurador para saídas de fuzzing. Suporta triagem paralela, deduplicação de falhas, análise de relatórios de sanitizer e múltiplos formatos de relatório (texto, JSON).
O AFLTriage é uma ferramenta para triar arquivos de entrada que causam falhas usando um depurador. Ele foi projetado para ser portátil e não exigir dependências em tempo de execução, além da libc e de um depurador externo. Ele suporta a triagem de falhas geradas por qualquer programa, não apenas pelo AFL, mas reconhece diretórios do AFL de forma especial, daí o nome.
Algumas características notáveis incluem:
Atualmente, o AFLTriage só suporta GDB e foi testado apenas em alvos Linux C/C++. Observe que o AFLTriage não classifica falhas quanto à potencial exploração. A classificação precisa de exploração é muito específica para cada alvo e cenário, sendo melhor deixada para ferramentas especializadas e analistas experientes.
O uso do AFLTriage é bastante direto. Você precisa de suas entradas para triar, um diretório de saída para os relatórios e o binário com seus argumentos a serem triados.
Exemplo:
$ afltriage -i fuzzing_directory -o reports ./target_binary --option-one @@
AFLTriage v1.0.0
[+] GDB is working (GNU gdb (Ubuntu 8.1.1-0ubuntu1) 8.1.1 - Python 3.6.9 (default, Jan 26 2021, 15:33:00))
[+] Image triage cmdline: "./target_binary --option-one @@"
[+] Reports will be output to directory "reports"
[+] Triaging AFL directory fuzzing_directory/ (41 files)
[+] Triaging 41 testcases
[+] Using 24 threads to triage
[+] Triaging [41/41 00:00:02] [####################] CRASH: ASAN detected heap-buffer-overflow in buggy_function after a READ leading to SIGABRT (si_signo=6) / SI_TKILL (si_code=-6)
[+] Triage stats [Crashes: 25 (unique 12), No crash: 16, Errored: 0]
Assim como no AFL, o @@ é substituído pelo caminho do arquivo a ser triado. O AFLTriage cuida do resto.
Você precisará de um ambiente de compilação Rust funcional. Depois de instalar o cargo e o rust, compilar e executar é simples:
cd afltriage-rs/
cargo run --help
<compilation>
Finished dev [unoptimized + debuginfo] target(s) in 0.33s
Running `target/debug/afltriage --help`
<AFLTriage usage>
...
afltriage 1.0.0
Quickly triage and summarize crashing testcases
USAGE:
afltriage -i <input>... -o <output> <command>...
OPTIONS:
-i <input>...
A list of paths to a testcase, directory of testcases, AFL directory, and/or directory of AFL directories to
be triaged. Note that this arg takes multiple inputs in a row (e.g. -i input1 input2...) so it cannot be the
last argument passed to AFLTriage -- this is reserved for the command.
-o <output>
The output directory for triage report files. Use '-' to print entire reports to console.
-t, --timeout <timeout>
The timeout in milliseconds for each testcase to triage. [default: 60000]
-j, --jobs <jobs>
How many threads to use during triage.
--report-formats <report_formats>...
The triage report output formats. Multiple values allowed: e.g. text,json. [default: text] [possible
values: text, json, rawjson]
--bucket-strategy <bucket_strategy>
The crash deduplication strategy to use. [default: afltriage] [possible values: none, afltriage,
first_frame, first_frame_raw, first_5_frames, function_names, first_function_name]
--child-output
Include child output in triage reports.
--child-output-lines <child_output_lines>
How many lines of program output from the target to include in reports. Use 0 to mean unlimited lines (not
recommended). [default: 25]
--stdin
Provide testcase input to the target via stdin instead of a file.
--profile-only
Perform environment checks, describe the inputs to be triaged, and profile the target binary.
--skip-profile
Skip target profiling before input processing.
--debug
Enable low-level debugging output of triage operations.
-h, --help
Prints help information
-V, --version
Prints version information
ARGS:
<command>...
The binary executable and args to execute. Use '@@' as a placeholder for the path to the input file or
--stdin. Optionally use -- to delimit the start of the command.
O AFLTriage é licenciado sob a BSD 3-cláusula "Nova" ou "Revisada". Consulte LICENSE para mais detalhes.