https://github.com/seemoo-lab/openwifipass

Skip to content
 
Sign up

  * Why GitHub?
    Features -
      + Mobile -
      + Actions -
      + Codespaces -
      + Packages -
      + Security -
      + Code review -
      + Project management -
      + Integrations -
      + GitHub Sponsors -
      + Customer stories -
      + Security -
  * Team
  * Enterprise
  * Explore
      + Explore GitHub -

    Learn & contribute

      + Topics -
      + Collections -
      + Trending -
      + Learning Lab -
      + Open source guides -

    Connect with others

      + The ReadME Project -
      + Events -
      + Community forum -
      + GitHub Education -
      + GitHub Stars program -
  * Marketplace
  * Pricing
    Plans -
      + Compare plans -
      + Contact Sales -
      + Nonprofit -
      + Education -

[                    ] [search-key]

  *  
    #
    In this repository All GitHub |
    Jump to |

  * No suggested jump to results

  *  
    #
    In this repository All GitHub |
    Jump to |
  *  
    #
    In this organization All GitHub |
    Jump to |
  *  
    #
    In this repository All GitHub |
    Jump to |

Sign in Sign up
{{ message }}

seemoo-lab / openwifipass

  * Watch 12
  * Star 328
  * Fork 6

An open source implementation of Apple's Wi-Fi Password Sharing
protocol in Python.

GPL-3.0 License
328 stars 6 forks
Star
Watch

  * Code
  * Issues 0
  * Pull requests 0
  * Actions
  * Projects 0
  * Security
  * Insights

More

  * Code
  * Issues
  * Pull requests
  * Actions
  * Projects
  * Security
  * Insights

main
1 branch 0 tags
Go to file Code
 
Clone
HTTPS GitHub CLI
[https://github.com/s]

Use Git or checkout with SVN using the web URL.

[gh repo clone seemoo]

Work fast with our official CLI. Learn more.

  * Open with GitHub Desktop
  * Download ZIP

Launching GitHub Desktop

If nothing happens, download GitHub Desktop and try again.

Go back

Launching GitHub Desktop

If nothing happens, download GitHub Desktop and try again.

Go back

Launching Xcode

If nothing happens, download Xcode and try again.

Go back

Launching Visual Studio

If nothing happens, download the GitHub extension for Visual Studio
and try again.

Go back

Latest commit

@schmittner
schmittner Add LICENSE information
...
8b63768 Jan 4, 2021
Add LICENSE information
8b63768

Git stats

  * 5 commits

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
.github/workflows
Add GitHub test workflow
Jan 4, 2021
openwifipass
Prepare release
Jan 4, 2021
tests
Prepare release
Jan 4, 2021
.gitignore
Prepare release
Jan 4, 2021
LICENSE
Add LICENSE information
Jan 4, 2021
Makefile
Prepare release
Jan 4, 2021
Manifest.in
Prepare release
Jan 4, 2021
OPACK.md
Update OPACK documentation
Jan 4, 2021
README.md
Add LICENSE information
Jan 4, 2021
deploy.sh
Prepare release
Jan 4, 2021
requirements-dev.txt
Prepare release
Jan 4, 2021
setup.cfg
Prepare release
Jan 4, 2021
setup.py
Add LICENSE information
Jan 4, 2021
View code

README.md

 OpenWifiPass

An open source implementation of the grantor role in Apple's Wi-Fi
Password Sharing protocol.

 Disclaimer

OpenWifiPass is experimental software and is the result of reverse
engineering efforts by the Open Wireless Link project. The code
serves solely documentary and educational purposes. It is untested
and incomplete. For example, the code does not verify the identity of
the requestor. So, do not use this implementation with sensitive
Wi-Fi credentials. OpenWifiPass is not affiliated with or endorsed by
Apple Inc.

 Requirements

Hardware: Bluetooth Low Energy radio, e.g., Raspberry Pi 4

OS: Linux (due to the bluepy dependency)

 Install

Clone this repository and install it:

git clone git@github.com/seemoo-lab/openwifipass.git
pip3 install ./openwifipass

 Run

Run openwifipass to share Wi-Fi credentials (SSID and PSK) with any
requestor (we need super user privileges to use the Bluetooth
subsystem):

sudo -E python3 -m openwifipass --ssid <SSID> --psk <PSK>

A successful run of the protocol would look as follows:

pi@raspberrypi:~/openwifipass $ sudo -E python3 -m openwifipass --ssid OWL --psk SuperSecretPassword
Start scanning...
SSID match in PWS advertisement from aa:bb:cc:dd:ee:ff
Connect to device aa:bb:cc:dd:ee:ff
Send PWS1
Receive PWS2
Send M1
Receive M2
Send M3
Receive M4
Send PWS3
Receive PWS4
Wi-Fi Password Sharing completed

 OPACK

This projects contains a reusable OPACK (de)serializer. Read OPACK.md
for more information.

 Authors

  * Jannik Lorenz

 Publications

  * Milan Stute, Alexander Heinrich, Jannik Lorenz, and Matthias
    Hollick. Disrupting Continuity of Apple's Wireless Ecosystem
    Security: New Tracking, DoS, and MitM Attacks on iOS and macOS
    Through Bluetooth Low Energy, AWDL, and Wi-Fi. 30th USENIX
    Security Symposium (USENIX Security '21), August 11-13, 2021,
    Vancouver, B.C., Canada. To appear.
  * Jannik Lorenz. Wi-Fi Sharing for All: Reverse Engineering and
    Breaking the Apple Wi-Fi Password Sharing Protocol. Bachelor
    thesis, Technical University of Darmstadt, March 2020.

 License

OpenWifiPass is licensed under the GNU General Public License v3.0.

About

An open source implementation of Apple's Wi-Fi Password Sharing
protocol in Python.

Topics

apple reverse-engineering wifi opack password-sharing

Resources

Readme

License

GPL-3.0 License

Releases

No releases published

Languages

  * Python 93.4%
  * Makefile 4.3%
  * Shell 2.3%

  * (c) 2021 GitHub, Inc.
  * Terms
  * Privacy
  * Security
  * Status
  * Docs

 

  * Contact GitHub
  * Pricing
  * API
  * Training
  * Blog
  * About

You can't perform that action at this time.
You signed in with another tab or window. Reload to refresh your
session. You signed out in another tab or window. Reload to refresh
your session.