ruzzy — Un fuzzer guidato dalla copertura per codice Ruby puro ed estensioni C di Ruby. | Kitploit

MAKE="make --environment-overrides V=1" \
CC="/path/to/clang" \
CXX="/path/to/clang++" \
LDSHARED="/path/to/clang -shared" \
LDSHAREDXX="/path/to/clang++ -shared" \
    gem install ruzzy

INFO: Running with entropic power schedule (0xFF, 100).
INFO: Seed: 2527961537
...
==45==ERROR: AddressSanitizer: heap-use-after-free on address 0x50c0009bab80 at pc 0xffff99ea1b44 bp 0xffffce8a67d0 sp 0xffffce8a67c8
...
SUMMARY: AddressSanitizer: heap-use-after-free /var/lib/gems/3.1.0/gems/ruzzy-0.8.0/ext/dummy/dummy.c:18:24 in _c_dummy_test_one_input
...
==45==ABORTING
MS: 4 EraseBytes-CopyPart-CopyPart-ChangeBit-; base unit: 410e5346bca8ee150ffd507311dd85789f2e171e
0x48,0x49,
HI
artifact_prefix='./'; Test unit written to ./crash-253420c1158bc6382093d409ce2e9cff5806e980
Base64: SEk=

# frozen_string_literal: true

require 'ruzzy'

def fuzzing_target(input)
  if input.length == 4
    if input[0] == 'F'
      if input[1] == 'U'
        if input[2] == 'Z'
          if input[3] == 'Z'
            raise
          end
        end
      end
    end
  end
end

test_one_input = lambda do |data|
  fuzzing_target(data) # Your fuzzing target would go here
  return 0
end

Ruzzy.fuzz(test_one_input)

INFO: Running with entropic power schedule (0xFF, 100).
INFO: Seed: 2311041000
...
/app/ruzzy/bin/test_harness.rb:12:in `block in <top (required)>': unhandled exception
	from /var/lib/gems/3.1.0/gems/ruzzy-0.8.0/lib/ruzzy.rb:15:in `c_fuzz'
	from /var/lib/gems/3.1.0/gems/ruzzy-0.8.0/lib/ruzzy.rb:15:in `fuzz'
	from /app/ruzzy/bin/test_harness.rb:35:in `<top (required)>'
	from bin/test_tracer.rb:7:in `require_relative'
	from bin/test_tracer.rb:7:in `<main>'
...
SUMMARY: libFuzzer: fuzz target exited
MS: 1 CopyPart-; base unit: 24b4b428cf94c21616893d6f94b30398a49d27cc
0x46,0x55,0x5a,0x5a,
FUZZ
artifact_prefix='./'; Test unit written to ./crash-aea2e3923af219a8956f626558ef32f30a914ebc
Base64: RlVaWg==

MAKE="make --environment-overrides V=1" \
CC="/path/to/clang" \
CXX="/path/to/clang++" \
LDSHARED="/path/to/clang -shared" \
LDSHAREDXX="/path/to/clang++ -shared" \
CFLAGS="-fsanitize=address,fuzzer-no-link -fno-omit-frame-pointer -fno-common -fPIC -g" \
CXXFLAGS="-fsanitize=address,fuzzer-no-link -fno-omit-frame-pointer -fno-common -fPIC -g" \
    gem install msgpack

# frozen_string_literal: true

require 'msgpack'
require 'ruzzy'

test_one_input = lambda do |data|
  begin
    MessagePack.unpack(data)
  rescue Exception
    # We're looking for memory corruption, not Ruby exceptions
  end
  return 0
end

Ruzzy.fuzz(test_one_input)

Metodo	Descrizione
`Ruzzy.fuzz(test_one_input, args = DEFAULT_ARGS)`	Esegue il fuzzing di `test_one_input` (una `proc`/`lambda` che accetta byte grezzi).
`Ruzzy.trace(harness_script)`	Avvolge `harness_script` con la strumentazione di copertura dei rami di Ruby, quindi lo carica con `require`. Necessario per il fuzzing di puro Ruby.
`Ruzzy.dummy`	Esegue il fuzzing dell'harness giocattolo incluso (demo di heap-use-after-free).
`Ruzzy.dummy_test_one_input(data)`	L'harness giocattolo stesso.

Costante	Descrizione
`Ruzzy::ASAN_PATH`	Percorso del wrapper ASan + fuzzer. Da usare con `LD_PRELOAD` (Linux) / `DYLD_INSERT_LIBRARIES` (macOS).
`Ruzzy::UBSAN_PATH`	Idem, per UBSan.
`Ruzzy::EXT_PATH`	Percorso della directory di build di `ext/cruzzy`.
`Ruzzy::DEFAULT_ARGS`	Argomenti predefiniti passati al fuzzer.

test_one_input = lambda do |data|
  fdp = Ruzzy::FuzzedDataProvider.new(data)
  name = fdp.consume_random_length_string(50)
  age = fdp.consume_int_in_range(0, 150)
  score = fdp.consume_float_in_range(0.0, 100.0)
  role = fdp.pick_value_in_list(['admin', 'user', 'guest'])
  User.new(name: name, age: age, score: score, role: role).validate!
end

Ruzzy.fuzz(test_one_input)

Metodo	Descrizione	Restituisce
`remaining_bytes`	Numero di byte non consumati rimanenti	`Integer`
`consume_bytes(count)`	Consuma fino a `count` byte grezzi	`String` binaria
`consume_random_length_string(max_length)`	Consuma una stringa a lunghezza variabile; termina su `\` + byte diverso da `\`	`String`
`consume_remaining_bytes`	Consuma tutti i byte rimanenti	`String` binaria
`consume_remaining_as_string`	Alias di `consume_remaining_bytes`	`String` binaria
`consume_uint(count)`	Intero senza segno da `count` byte	`Integer`
`consume_int(count)`	Intero con segno (complemento a due) da `count` byte	`Integer`
`consume_int_in_range(min, max)`	Intero distribuito uniformemente in [`min`, `max`]	`Integer`
`consume_bool`	Booleano da un byte (LSB)	`true`/`false`
`consume_float`	Float che copre l'intero intervallo del double	`Float`
`consume_float_in_range(min, max)`	Float in [`min`, `max`]	`Float`
`consume_probability`	Float in [0.0, 1.0]	`Float`
`pick_value_in_list(list)`	Elemento casuale da `list`	elemento

MAKE="make --environment-overrides V=1" \
CC="$(brew --prefix llvm)/bin/clang" \
CXX="$(brew --prefix llvm)/bin/clang++" \
LDSHARED="$(brew --prefix llvm)/bin/clang -dynamic -bundle -undefined dynamic_lookup" \
LDSHAREDXX="$(brew --prefix llvm)/bin/clang++ -dynamic -bundle -undefined dynamic_lookup" \
    gem install ruzzy

Gli shim dei gestori di versioni (asdf, rbenv) rimuovono le variabili d'ambiente DYLD_*. Questi shim usano #!/usr/bin/env bash e /usr/bin/env è protetto da SIP, quindi macOS rimuove DYLD_INSERT_LIBRARIES prima che Ruby venga avviato. Usa Ruby di Homebrew (che non ha shim) oppure invoca il percorso assoluto del binario Ruby installato:
```
DYLD_INSERT_LIBRARIES=$(/path/to/ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
    /path/to/ruby your_fuzzer.rb
```
È richiesto un LLVM recente. Alcune versioni meno recenti di LLVM di Homebrew (in particolare 19.x) hanno un bug per cui l'iniezione tramite DYLD_INSERT_LIBRARIES della dylib ASan blocca il processo durante l'avvio. Se Ruzzy si blocca all'avvio, aggiorna LLVM di Homebrew (brew upgrade llvm).

ruzzy

Più Popolari

Installazione

Utilizzo

Per iniziare

`ASAN_OPTIONS`

Fuzzing di codice Ruby puro

Fuzzing di estensioni C di Ruby

API

Ruzzy

FuzzedDataProvider

Note per gli utenti macOS

Prerequisiti

Installazione

Esecuzione

Avvertenze

Bacheca dei trofei

Sviluppo

Compilazione

Test

Linting

Rilascio

Ulteriori letture