30 lines
1.1 KiB
Markdown
30 lines
1.1 KiB
Markdown
# clocktower
|
|
|
|
clocktower is a python package implementing efficient strategies for executing adaptive timing side
|
|
channel attacks. the goal is to use statistics to guide public input guesses in order to reveal the
|
|
secret with a given level of statistical significance in a minimum number of rounds. the current
|
|
strategy already significantly outperforms the naive non-adaptive strategy, and thus can be used as
|
|
a framework for mounting attacks
|
|
|
|
## howto
|
|
|
|
currently the model is that a correct guess will result in a longer time taken to execute, and all
|
|
incorrect guesses will take the same (lower) time to execute
|
|
more abstraction is planned for different target models
|
|
|
|
```
|
|
import clocktower
|
|
|
|
# default input space: 0-255
|
|
# default significance level: 0.01
|
|
mgr = clocktower.ClocktowerManager()
|
|
|
|
# when next_guess() returns None, the algoritm has a statistically significant answer
|
|
while (guess := mgr.next_guess()) is not None:
|
|
# execute the guess and get the result
|
|
timing_value = run_attack(guess)
|
|
mgr.update(guess, timing_value)
|
|
|
|
print(mgr.get_best_guess())
|
|
```
|