Skip to content

About

A real, local network emulator and experimentation framework for evaluating anonymous communication network designs.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

48 Commits

Folders and files

Repository files navigation

AnonTestLab

hashtagRR.github.io/AnonTestLab

DOI

AnonTestLab overview in four stages. 1 Configure: one YAML file, mode tor_like or custom, run with atl run. 2 Run a live network: real relay processes on one machine, a session split over two legs that rejoin at a common exit, with configurable split policy, mixing, traffic, crypto, key exchange and link conditions; the adversary watches the entry and the merged exit. 3 Attack: correlation_suite, global_observer, watermark, hop_depth and path_compromise. 4 Keep results: measured latency, delivery, bandwidth and leg shares, attack scores, and a results folder. atl compare, sweep, paired, predict, fidelity and dashboard close the loop.

A local network emulator for testing anonymous communication designs. Relays run as real processes with real handshakes, encryption and sockets, so latency, delivery and attack results are measured rather than modelled.

Quickstart

python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/atl run examples/tor_like.yaml        # run an example experiment
.venv/bin/pip install -e ".[dashboard]" && .venv/bin/atl dashboard   # optional web UI

Windows and troubleshooting: INSTALL.md.

Documentation

Guide What it covers
Experiment configs every YAML option, split policies, crypto, and the four example configs
Tools the atl commands (run, compare, sweep, paired, predict, fidelity, wizard) and the dashboard
Adversaries the five attackers, what each measures, and how to add one
Architecture what happens during a run, and how to extend routing, traffic, crypto or adversaries
Known limitations simplifications to keep in mind when reading results
Install guide platform setup, including Windows
Changelog what changed in each version
Project site the project's overview page

Versions

  • v0.5.0 (latest): rebuilt dashboard with PDF reports, and a fix to the model's predictions for cover traffic on split legs.
  • v0.4.0 (10.5281/zenodo.23211928): the version used for the experiments of a paper on correlation risk in multipath anonymous communication (under review).

AnonTestLab grew out of the test harness of Anon-Sec-Net, a dual-path anonymous communication prototype, and works for other designs too.

License

GPL-3.0-or-later. See LICENSE.

About

A real, local network emulator and experimentation framework for evaluating anonymous communication network designs.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages