Freeway for Network Pentesting

Read the article about Freeway, now on Medium

[!NOTE] User will not be prompted to accept EULA anymore!
Therefore, by downloading the software, user automatically agrees to follow every guideline specified in EULA section below.

1. 개요

Freeway는 Python scapy 기반 WiFi 침투 도구로, 윤리적 해커와 침투 테스터가 가정 또는 기업 네트워크를 감사하고 보호하는 기술과 지식을 발전시키는 데 도움을 주기 위해 설계되었습니다.

2. 기능

IEEE 802.11 패킷 모니터링
인증 해제 공격 (Deauthentication Attack)
비콘 플러드 (Beacon Flood)
패킷 퍼저 (Packet Fuzzer)
네트워크 감사 (Network Audit)
채널 호핑 (Channel Hopper)
이블 트윈 (Evil Twin)
패킷 크래프터 (Packet Crafter)
병기고 (Arsenal)

_{기능에 대한 설명은 6장에서 확인할 수 있습니다.}

3. 준비 사항

필수 항목:

모니터 모드와 프레임 주입을 지원하는 네트워크 어댑터.
Linux 배포판을 실행하는 운영 체제.
Python 3+ 설치.

_{선택 사항: pip를 통해 설치하지 않는 경우 Python용 Scapy 및 Rich 패키지를 설치합니다 (4장 참조)}

4. 설정

옵션 A: PyPi를 통해 설치 (권장)

  $ sudo pip install 3way

옵션 B: 수동 설치 또는 실행

먼저 저장소를 클론합니다:

git clone https://github.com/FLOCK4H/Freeway

클론한 저장소로 이동합니다:

cd Freeway

옵션 1: 종속성, 폴더 및 Freeway 설치 (권장)

_{이 방법을 사용하면 어디서든 도구를 실행할 수 있습니다}

sudo pip install .

옵션 2: Python을 사용하여 설치 없이 실행.

_{/Freeway 디렉토리에서 호출해야 합니다}

sudo pip install scapy rich
sudo python Freeway

5. 사용법

이 도구는 자체 명령줄 인터페이스(CLI) 를 제공하며, 추가 인수 없이 실행할 수 있습니다.

CLI 사용법 펼쳐보기

sudo Freeway

프롬프트에 따라 네트워크 어댑터를 선택합니다 (3장 참조):

[!TIP} 다음 스크린샷은 Freeway의 초기 버전을 보여줍니다. 현재 소프트웨어의 모습을 반영하지 않으며, 추후 변경될 예정입니다.

기능과 매개변수를 선택합니다:

추가 인수를 사용하여 CLI를 부분적으로 또는 완전히 건너뛸 수도 있습니다.

인수 사용법 펼쳐보기

sudo Freeway -i wlan2 -a monitor -p 1,2,a

_{'-p'는 '-a'와 함께 필수가 아닙니다. 예를 들어, 다음 명령은 CLI에서 매개변수를 지정하라는 프롬프트를 표시합니다:}

sudo Freeway -i wlan2 -a deauth

모든 인수, 액션 및 매개변수:

Arguments: -h, --help 도움말 메시지를 표시합니다.
-i, --inf WLAN 인터페이스를 지정합니다 (예: wlan0, wlan1).
-a, --action 액션 번호 또는 별칭 (예: 1 또는 monitor).
-p, --params 매개변수 식별자 (예: 1,2,a 또는 3rtv, 액션에 따라 다름).

Actions: 1 or monitor, 2 or deauth, 3 or beacon_spam, 4 or fuzzer, 5 or audit, 6 or hopper, 7 or eviltwin 8 or packet_crafter, 9 or arsenal

매개변수는 각 액션에 대해 CLI와 동일한 형식으로 제공되어야 합니다. 특정 액션의 모든 매개변수를 나열하려면 -p 없이 -a 인수만 제공하세요.

6. 상세 설명

패킷 모니터 - 공중의 WiFi 패킷을 스니핑하여 분석하고 결과를 Python의 curses 디스플레이에 반환합니다. SSID, MAC, 클라이언트, 가동 시간, 채널, 신호(dBm), 암호화를 캡처하고 제조사를 확인합니다. hashcat 크랙 가능 형식의 PMKID 및 4-way 핸드셰이크, 기타 EAPOL 패킷을 캡처합니다. 출력 저장 이 선택된 경우 캡처된 세션을 /caps 폴더에 기록하거나 모든 캡처된 패킷을 저장합니다.
인증 해제 공격 (Deauthing) - AP¹ 주소, 장치 주소(또는 _대량 인증 해제_의 경우 브로드캐스트) 및 클라이언트를 추방하는 이유가 포함된 인증 해제 프레임을 전송하여 네트워크에서 장치를 연결 해제합니다. 장치 주소가 브로드캐스트 주소인 경우 AP는 대부분의 경우 모든 클라이언트를 한 번에 연결 해제합니다. Freeway는 인증 해제를 최대한 효율적으로 만들기 위해 발견된 각 AP 또는 클라이언트에 대해 별도의 스레드를 생성합니다.
비콘 플러드 공격 - 주변 WiFi 스캐너를 가짜 또는 변형된 AP로 플러딩합니다. WiFi를 찾는 장치가 비정상적으로 동작(예: 충돌, 정지, 배터리 소모 또는 속도 저하)하게 하고 주변 네트워크 트래픽을 방해할 수 있습니다. 사용자는 자신의 SSID 목록을 지정하거나 기본 목록을 사용하고 정확하지만 무작위 또는 변형된 비콘 패킷을 생성할 수 있습니다.
패킷 퍼저 - 퍼징은 다양한 변형 또는 반무작위 데이터를 네트워크 인터페이스에 전송하고 응답을 관찰하여 네트워크 취약점을 평가하는 기술입니다. Freeway는 다음을 포함합니다: 캡처된 패킷 재생(RX&TX²), CTS/RTS 또는 프로브 요청 스팸 및 인증 또는 연결 프레임으로 AP 플러딩. 퍼징된 패킷을 캡처하는 장치는 수신기의 취약성 수준에 따라 다르게 동작합니다 (!사용에 주의하세요!).
네트워크 감사 - 특정 네트워크에 대한 모든 가능한 정보를 수집하여 curses 뷰에 반환합니다. 모든 클라이언트의 신호 및 마지막 활동을 추적하고 제조사를 확인합니다.
채널 호핑 - 네트워크 어댑터의 현재 채널을 변경합니다. 특정 공격을 더 성공적으로 만드는 데 도움이 됩니다.
이블 트윈 - 합법적인 액세스 포인트를 캡티브 포털과 함께 호스팅합니다. 이 '합법적인' AP는 사용자에게 로그인/은행 자격 증명을 요구하거나 악성 코드를 다운로드하도록 요청합니다. 먼저 일반 AP가 생성되며, 대부분 기존 네트워크의 ESSID와 MAC을 사용합니다. 그런 다음 캡티브 포털(예: 로그인 웹사이트)을 호스팅하여, 스푸핑하는 네트워크에 연결하려는 사용자를 우리의 index.html로 리디렉션하는 일반 웹 서버 역할을 합니다.
패킷 크래프터 - 적절한 .11 프레임을 구성하고 사용자 정의 값으로 수정한 후 여러 인터페이스를 사용하여 사용자 정의 스레드 수로 공중에 전송할 수 있습니다. 빠른 패킷 전달, 교육 활동 또는 스레드/멀티노드 침투에 유용합니다. 모든 기능은 프롬프트 기반의 사용자 친화적인 인터페이스에 캡슐화되어 있습니다.
병기고 - 사용자 스크립트를 앱 내에서 포함하고 관리할 수 있으며, 새로운 CSA 스팸 기능이 추가되었습니다.

^{1^{액세스 포인트}}

^{2^{송수신 동시 수행}}

7. 제거

Freeway가 기대에 미치지 못하고 pip를 통해 설치된 경우 제거 과정은 간단합니다:

sudo pip uninstall 3way

EULA

1) 사용자는 현지 법적 지침을 엄격히 준수해야 합니다.

2) 사용자는 어떠한 상황에서도 타인을 방해하거나, 혼란을 초래하거나, 손해를 입히거나, 다른 장치에 손상을 주어서는 안 됩니다.

3) 본 소프트웨어의 재배포는 MIT 라이선스 표준을 준수해야 합니다.

4) 저자는 본 소프트웨어 사용으로 인해 발생한 모든 손해에 대해 책임을 지지 않습니다.

5) 조사가 진행될 경우 저자는 어떤 당사자에게도 지원을 제공하지 않습니다.

기억하세요, Freeway의 목적은 취약점을 식별하는 것이지 악용하는 것이 아닙니다!

TODO

✅ 이블 트윈 공격

✅ 버전 및 업데이트 확인기

✅ PyPi 릴리스

✅ 패킷 크래프터

✅ Freeway v1.5

변경 로그

19.05.24

deauth.py에서 동적으로 크기가 변하는 딕셔너리를 반복할 때 발생하는 드문 RuntimeError 수정

beacon_spam.py에서 비콘 패킷 형식 추가 개선

27.05.24

updater.py 추가

evil_twin.py 추가

/templates 폴더 추가

액션 목록에 Evil Twin 추가

README.md 업데이트

PyPi 릴리스

3.06.24

git_downloader.py 추가

beacon_spam 업데이트

evil_twin 업데이트

27.06.24

스크립트에서 EULA 제거

README.md에 EULA 추가

pkt_crafter.py 추가

Freeway 스크립트 수정

알려진 문제

Android는 가짜 비콘 프레임을 필터링합니다 (Android 5에서는 작동하지만 Android 11+에서는 작동하지 않음, Android 11 미만 및 Android 5 이상 버전은 테스트되지 않음.)

EvilTwin은 트래픽을 리디렉션하기 위해 인터넷에 연결된 두 번째 어댑터가 필요합니다 (문제라기보다는 필수 사항입니다.)

EvilTwin의 첫 실행은 dnsmasq가 시스템에서 한 번도 실행된 적이 없는 경우 성공하지 못할 수 있습니다. EvilTwin을 두 번 실행하거나, dnsmasq를 미리 설치하여 실행하십시오.

법적 고지

[!IMPORTANT] 해당 기능의 악의적인 사용은 범죄로 간주되어야 합니다.
침투 테스트를 수행하기 전에 항상 허가를 받으십시오.

라이선스

Freeway의 배포는 표준 MIT 라이선스에 의해 규제됩니다. 사용자는 저장소를 자유롭게 사용, 공유 및 기여하거나 버그를 보고할 수 있습니다.