{ "info": { "author": "FLOCK4H", "author_email": null, "bugtrack_url": null, "classifiers": [], "description": "
\n \"Freeway\n\n $${\\color{red}Freeway\\ for\\ Network\\ Pentesting}$$\n
\n\n
\n\n\nRead the article about Freeway, now on\nMedium\n
\n
\n\n> [!NOTE]\n> Before using the software, the user must agree to the EULA when prompted\n\n

1. Overview

\n\n**Freeway** is a Python scapy-based tool for WiFi penetration that aim to help ethical hackers and pentesters develop their skills and knowledge in auditing and securing home or enterprise networks.\n\n

2. Features

\n\n- IEEE 802.11 Packet Monitoring\n- Deauthentication Attack\n- Beacon Flood\n- Packet Fuzzer\n- Network Audit\n- Channel Hopper\n- Evil Twin\n\nDescription of the features can be found in Section 6\n\n

3. Preparation

\n\nIt is **necessary** to have:\n- A network adapter supporting monitor mode and frame injection.\n- An operating system running a Linux distribution.\n- Python 3+ installed.\n\nOptionally, install Scapy and Rich packages for Python if not installing via pip (see Section 4)\n\n

4. Setup

\n\n**Option A**: Install via PyPi (**RECOMMENDED**)\n\n```\n $ sudo pip install 3way\n```\n\n**Option B**: Install or run manually\n\nFirst, clone the repository:\n\n git clone https://github.com/FLOCK4H/Freeway\n\nNavigate to the cloned repository:\n\n cd Freeway\n\nOption 1: Install dependencies, folders, and Freeway. (RECOMMENDED)\n\nThis will allow to launch the tool from anywhere\n\n sudo pip install .\n\nOption 2: Run without installation using Python.\n\nMust be called from the /Freeway directory\n\n sudo pip install scapy rich\n sudo python Freeway\n\n

5. Usage

\n\nThis tool comes with its own **command line interface (CLI)** and can be run without specifying any additional arguments.\n\n
\nClick to expand the CLI usage\n
\n\n sudo Freeway\n\nFollow the prompt to select the network adapter (see Section 3):\n\n![image](https://github.com/FLOCK4H/Freeway/assets/161654571/653c9304-3256-4444-8f3f-0677134c8af8)\n\nSelect the feature and parameter(s):\n\n![image](https://github.com/FLOCK4H/Freeway/assets/161654571/2444922e-6f1b-4958-99ea-df7463b912cb)\n![image](https://github.com/FLOCK4H/Freeway/assets/161654571/757b5d77-be12-4dda-a957-3c305789bba7)\n\n
\n
\n\nAnd with the **additional arguments**, to skip the CLI partially or completely.\n\n
\nClick to expand the arguments usage\n
\n\n sudo Freeway -i wlan2 -a monitor -p 1,2,a\n\n'-p' is not required with '-a', e.g., this will prompt for parameters to specify in the CLI:\n\n sudo Freeway -i wlan2 -a deauth\n\n**All arguments, actions, and parameters:**\n\n
\n
\n  Arguments:\n  -h, --help     Show the help message. 
\n  -i, --inf      Specify the WLAN interface (e.g., wlan0, wlan1). 
\n  -a, --action   Action number or alias (e.g., 1 or monitor). 
\n  -p, --params   Parameter identifiers (e.g., 1,2,a or 3rtv, depends on action). 
\n\n  Actions:\n  1 or monitor,\n  2 or deauth,\n  3 or beacon_spam,\n  4 or fuzzer,\n  5 or audit,\n  6 or hopper,\n  7 or eviltwin\n\n  Parameters must be provided in the same format as in the CLI, specific for every action.\n  To list all parameters for a given action, just provide -a argument without -p.\n
\n
\n
\n\n

6. Details

\n\n- **Packet Monitor** - Sniffs the WiFi packets in the air, analyze them and return the result onto the python's curses display. Catches SSIDs, MACs, Clients, Uptime, Channel, Signal (dBm), Encryption and resolves manufacturer. Catches PMKIDs in hashcat crackable format, and 4-way Handshakes, as well as other EAPOL packets. Logs the captured session to the **/caps** folder or every captured packet if _Save output_ was selected.\n- **Deauthentication Attack (Deauthing)** - Disconnects a device from the network by sending a packet containing AP1 address, device address (or broadcast for _Mass Deauthing_) and the deauthentication frame with a reason of kicking the client(s). In case where a device address is a broadcast address, the AP will in most cases disconnect all clients at once. Freeway creates separate thread for every AP or client found in order to make deauthing maximally efficient.\n- **Beacon Flood Attack** - Floods the nearby WiFi scanners with fake or malformed APs. It can cause the devices looking for WiFi to behave abnormally (e.g. crash, freeze, drain the battery or run slower) and disrupt the nearby network traffic. User is able to specify his own ssid list, use the default one and generate correct (but random) or malformed beacon packets.\n- **Packet Fuzzer** - Fuzzing is a technique of network vulnerability assesment by sending a wide array of malformed or semi-random data to network interfaces and observing the responses. Freeway covers: **Replay captured packets (RX&TX2)**, **Spam CTS/RTS or Probe requests** and **Flood an AP with Authentication or Association Frames**. Devices that will capture fuzzed packets will behave differently depending on vulnerability level of receiver (!USE WITH CAUTION!).\n- **Network Audit** - Gathers all possible information about specific network and returns them onto the curses view. Tracks all clients signal and last activity, as well as resolve the manufacturer.\n- **Channel Hopper** - Changes the current channel of the network adapter. Helpful in making specific attacks more successful.\n- **Evil Twin** - Hosts a legitimate Access Point with Captive Portal, this 'legitimate' AP asks user for login/ bank credentials, or to download malware. First, there's a normal AP created, most times with an ESSID and MAC of existing network. Then, we host our captive portal (e.g., login website), so a normal web server, that reroutes users to our `index.html` trying to associate with the network we spoof.\n\n1**Access Points**\n\n2**Transceive and receive at the same time**\n\n

7. Uninstall

\n\nIn case where Freeway doesn't meet the expectations and was installed via pip, the removal process is as easy:\n\n sudo pip uninstall 3way\n\n

TODO

\n\n\u2705 Evil Twin attack\n\n\u2705 Version & update checker\n\n\u2705 PyPi Release\n\n\u2611\ufe0f Packet Crafter (almost done)\n\n\u274c ARP Spoofer\n\n

Changelog

\n\n> 19.05\n> 1. Fixed rare RuntimeError in deauth.py caused by iterating on dynamicly changing size dictionary\n> 2. Further improvements of beacon packet formatting in beacon_spam.py\n\n> 27.05\n> 1. Added `updater.py`\n> 2. Added `evil_twin.py`\n> 3. Added `/templates` folder\n> 4. Added Evil Twin to actions list\n> 5. Updated README.md\n> 6. PyPi Release\n\n> 3.05\n> 1. Added `git_downloader.py`\n> 2. Updated `beacon_spam`\n> 3. Updated `evil_twin`\n\n

Known Issues

\n\n> 1. Android filters out fake beacon frames (works for Android 5, doesn't on Android 11+, versions below Android 11 and above Android 5 were not tested.)\n> 2. EvilTwin needs a second adapter connected to the internet (not really an issue), to be able to reroute traffic \n\n

Legal Note

\n\n> [!IMPORTANT]\n> Any malicious use of such features should be considered a crime,
\n> always assert permission to perform the penetration testing.\n\n

License

\n\nThe distribution of Freeway is regulated by the standard MIT license, users can feel free to use, share and contribute to the repository or report bugs.\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": null, "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "dynamic": null, "home_page": "https://github.com/FLOCK4H/Freeway", "keywords": null, "license": "MIT", "maintainer": null, "maintainer_email": null, "name": "3way", "package_url": "https://pypi.org/project/3way/", "platform": null, "project_url": "https://pypi.org/project/3way/", "project_urls": { "Homepage": "https://github.com/FLOCK4H/Freeway" }, "provides_extra": null, "release_url": "https://pypi.org/project/3way/1.3.0/", "requires_dist": [ "rich", "scapy" ], "requires_python": null, "summary": "Freeway for network pentesting", "version": "1.3.0", "yanked": false, "yanked_reason": null }, "last_serial": 23878389, "releases": { "1.2.0": [ { "comment_text": "", "digests": { "blake2b_256": "72c90e40f13ec16ad9a37952f693f16af380aec757118e1afc302f362bae59fc", "md5": "2ee4e72002cb2ae92f67778d3906bb5b", "sha256": "125b2d3eb02a7d2576c440d1e587994f310f3da29c057079cdbeb0d71c974ec6" }, "downloads": -1, "filename": "3way-1.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "2ee4e72002cb2ae92f67778d3906bb5b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 42609, "upload_time": "2024-05-27T11:45:46", "upload_time_iso_8601": "2024-05-27T11:45:46.569378Z", "url": "https://files.pythonhosted.org/packages/72/c9/0e40f13ec16ad9a37952f693f16af380aec757118e1afc302f362bae59fc/3way-1.2.0-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "blake2b_256": "6a352a776bddb2561a475ff798490091f0fa57c1ff2398449eac926f94518915", "md5": "85402a7a321e7bffe5454b2fe8d39f7e", "sha256": "bafc5c4d99f4fd47fd51b8cb381eb24da5615479efa1b708a54d454fe425746b" }, "downloads": -1, "filename": "3way-1.2.0.tar.gz", "has_sig": false, "md5_digest": "85402a7a321e7bffe5454b2fe8d39f7e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 86378, "upload_time": "2024-05-27T11:45:49", "upload_time_iso_8601": "2024-05-27T11:45:49.999926Z", "url": "https://files.pythonhosted.org/packages/6a/35/2a776bddb2561a475ff798490091f0fa57c1ff2398449eac926f94518915/3way-1.2.0.tar.gz", "yanked": false, "yanked_reason": null } ], "1.2.1": [ { "comment_text": "", "digests": { "blake2b_256": "0f3aa5914c00e124411eefd7884a2315ea8b10ae4d1ee152074e3158ce5ba554", "md5": "da7538c48c08e58fc3b91d85d4b25d65", "sha256": "7920e51fe4135e715ef75515dee0406a707b8f1853cb0b7c7644a9c4c2df7f92" }, "downloads": -1, "filename": "3way-1.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "da7538c48c08e58fc3b91d85d4b25d65", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 42858, "upload_time": "2024-05-27T12:06:26", "upload_time_iso_8601": "2024-05-27T12:06:26.932002Z", "url": "https://files.pythonhosted.org/packages/0f/3a/a5914c00e124411eefd7884a2315ea8b10ae4d1ee152074e3158ce5ba554/3way-1.2.1-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "blake2b_256": "60e9949d6a683a184e22a591527fa531b9dfcf2b2bb762d9571e5bdfdf98052d", "md5": "f44c505ec3c3bb63f55b0954169c9042", "sha256": "f85a70bc369d2c37779533c46527698ae7fa3130808956f7d6c0976d93f73c91" }, "downloads": -1, "filename": "3way-1.2.1.tar.gz", "has_sig": false, "md5_digest": "f44c505ec3c3bb63f55b0954169c9042", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 86897, "upload_time": "2024-05-27T12:06:29", "upload_time_iso_8601": "2024-05-27T12:06:29.537896Z", "url": "https://files.pythonhosted.org/packages/60/e9/949d6a683a184e22a591527fa531b9dfcf2b2bb762d9571e5bdfdf98052d/3way-1.2.1.tar.gz", "yanked": false, "yanked_reason": null } ], "1.2.4": [ { "comment_text": "", "digests": { "blake2b_256": "0650eca80605cc1c201e9ad9577ef68c00dfeee00c0266f7ba711a08795625f0", "md5": "9e39b59466f7237428255423c76b0ec7", "sha256": "eaa633450bc0ba237ae326266841e17e74c1eff05381db453316fc4252632121" }, "downloads": -1, "filename": "3way-1.2.4-py3-none-any.whl", "has_sig": false, "md5_digest": "9e39b59466f7237428255423c76b0ec7", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 44293, "upload_time": "2024-06-01T17:27:56", "upload_time_iso_8601": "2024-06-01T17:27:56.001373Z", "url": "https://files.pythonhosted.org/packages/06/50/eca80605cc1c201e9ad9577ef68c00dfeee00c0266f7ba711a08795625f0/3way-1.2.4-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "blake2b_256": "7b5e7e38657163ab022bfec9fd672b3c2d50e8c634def1c828740ca32792b486", "md5": "6a94cefdccd74ce15e933b5e67546c0a", "sha256": "64ad1bcd99abd02c053d032405bac835b43b818ed5854a4a5a0a33a4c28830a2" }, "downloads": -1, "filename": "3way-1.2.4.tar.gz", "has_sig": false, "md5_digest": "6a94cefdccd74ce15e933b5e67546c0a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 169994, "upload_time": "2024-06-01T17:28:01", "upload_time_iso_8601": "2024-06-01T17:28:01.420211Z", "url": "https://files.pythonhosted.org/packages/7b/5e/7e38657163ab022bfec9fd672b3c2d50e8c634def1c828740ca32792b486/3way-1.2.4.tar.gz", "yanked": false, "yanked_reason": null } ], "1.3.0": [ { "comment_text": "", "digests": { "blake2b_256": "efebb2ed01b92828578719923767653b17aca60c2979591d419c9b50acf88a08", "md5": "17151c1274cd7af463a2d34f66410eb7", "sha256": "903af32268c1c0e40805a7cef2819017e1814a5f6db63276c444318b8b4f5be9" }, "downloads": -1, "filename": "3way-1.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "17151c1274cd7af463a2d34f66410eb7", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 47477, "upload_time": "2024-06-27T13:35:10", "upload_time_iso_8601": "2024-06-27T13:35:10.565201Z", "url": "https://files.pythonhosted.org/packages/ef/eb/b2ed01b92828578719923767653b17aca60c2979591d419c9b50acf88a08/3way-1.3.0-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "blake2b_256": "efd5871cdcfc174e1107f77629d276b9eb61ef738c4c154a00da096047c20186", "md5": "a1243bf8d6e5a252b976dc86785c878a", "sha256": "2ce24e38f78891ff6e23dfb642159ea820db33857868a66b76452529954327f7" }, "downloads": -1, "filename": "3way-1.3.0.tar.gz", "has_sig": false, "md5_digest": "a1243bf8d6e5a252b976dc86785c878a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 91004, "upload_time": "2024-06-27T13:35:12", "upload_time_iso_8601": "2024-06-27T13:35:12.612890Z", "url": "https://files.pythonhosted.org/packages/ef/d5/871cdcfc174e1107f77629d276b9eb61ef738c4c154a00da096047c20186/3way-1.3.0.tar.gz", "yanked": false, "yanked_reason": null } ] }, "urls": [ { "comment_text": "", "digests": { "blake2b_256": "efebb2ed01b92828578719923767653b17aca60c2979591d419c9b50acf88a08", "md5": "17151c1274cd7af463a2d34f66410eb7", "sha256": "903af32268c1c0e40805a7cef2819017e1814a5f6db63276c444318b8b4f5be9" }, "downloads": -1, "filename": "3way-1.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "17151c1274cd7af463a2d34f66410eb7", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 47477, "upload_time": "2024-06-27T13:35:10", "upload_time_iso_8601": "2024-06-27T13:35:10.565201Z", "url": "https://files.pythonhosted.org/packages/ef/eb/b2ed01b92828578719923767653b17aca60c2979591d419c9b50acf88a08/3way-1.3.0-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "blake2b_256": "efd5871cdcfc174e1107f77629d276b9eb61ef738c4c154a00da096047c20186", "md5": "a1243bf8d6e5a252b976dc86785c878a", "sha256": "2ce24e38f78891ff6e23dfb642159ea820db33857868a66b76452529954327f7" }, "downloads": -1, "filename": "3way-1.3.0.tar.gz", "has_sig": false, "md5_digest": "a1243bf8d6e5a252b976dc86785c878a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 91004, "upload_time": "2024-06-27T13:35:12", "upload_time_iso_8601": "2024-06-27T13:35:12.612890Z", "url": "https://files.pythonhosted.org/packages/ef/d5/871cdcfc174e1107f77629d276b9eb61ef738c4c154a00da096047c20186/3way-1.3.0.tar.gz", "yanked": false, "yanked_reason": null } ], "vulnerabilities": [] }