Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Test WiFi against SSID-to-WPA attacks
Ruby
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
test
.gitignore
Gemfile
MIT-LICENSE
Rakefile
Readme.rdoc
rubywpa.gemspec

Readme.rdoc

Ruby WPA

Some WPA password detection with Ruby.

Installation

gem install rubywpa

Usage

require 'rubywpa'

wifi = Rubywpa::WiFi.new({:ssid => 'My_SSID'})
wifi.password

Disclaimer

Test if your own WiFi network is subsceptible to standard WPA passwords. I decline any responsibility for any other use.

Why?

Because ISPs started shipping WiFi-enabled modem/routes to their customers with standard passwords. Those passwords in some cases are directly linked to the broadcasting SSID, allowing for an attacked to use your network without authorization. This tool helps you find out if you are currently vulnerable or not. If the password match, please do what's in your power to change your WiFi password, either asking your ISP or do it by yourself.

Why Ruby?

Because it's my favourite language and it's fun. I agree that a C library would be more portable, but it is easy enough to do it by yourself if you need to.

How to contribute?

Mainly I'd like having as many algorithms as possible, so if you know one or have discovered one, please fork the project and add your class in network. Be sure to also write some tests. Next I'd like some help to make this a proper library, currently it's only a hack, so it needs more polish.

TODO

- more supported ISPs
- better detection through regex
- proper code structure
- proper error raising/handling
Something went wrong with that request. Please try again.