.. wpa2slow documentation master file, created by sphinx-quickstart on Tue Nov 15 11:47:51 2016. You can adapt this file completely to your liking, but it should at least contain the root toctree directive.

wpa2slow

wpa2slow is a full Python implementation of the WPA2 encryption algorithm, using no encryption libraries.

Project goals

This project grew out of my FPGA implementation of WPA2 <https://github.com/JarrettR/FPGA-Cryptoparty>_, as a platform for regression testing and experimentation.

WPA2 requires three or four different algorithms to calculate a final password, depending on how you count them.

There is a fair amount of discussion on these functions in this <http://jrainimo.com/build/?cat=6>_ category of my site.

The entire goal was to have intermediate steps of the algorithms to compare with the VHDL implementation. Perhaps this will be useful to someone else.

Benchmarks

Hash speed of my general purpose computer; 2,000 keys / second

Hash speed of a Raspberry Pi 1: 45 keys / second

Hash speed of this project: 0.25 keys / second

Sounds great! How can I get started?

See the Installation <http://wpa2slow.readthedocs.io/en/latest/installation.html>_ docs first for initial setup.

Usage <http://wpa2slow.readthedocs.io/en/latest/usage.html>_ docs give you a few examples, and references for more information.

For developers, or people looking to expand their brains, read about how WPA2 works in the Structure <http://wpa2slow.readthedocs.io/en/latest/structure.html>_ docs.

Further reading

• Announcement post <http://jrainimo.com/build/?p=1157>_
• GitHub Page <https://github.com/JarrettR/WPA-Slowed-Down>_
• ReadTheDocs Page <http://wpa2slow.readthedocs.io/en/latest/>_
• PyPi Page <https://pypi.python.org/pypi/wpa2slow>_
• Usage in FPGA simulator regression testing <https://github.com/JarrettR/FPGA-Cryptoparty>_ (See FPGA/tests folder)
• hccap format specification <https://hashcat.net/cap2hccap/>_ format