WifiForge

---

개요

WifiForge는 보안 연구 및 교육을 위한 완전히 가상의 WiFi 네트워크를 구축하는 터미널 기반 프레임워크입니다. 하드웨어 없이도 실제 무선 공격, 정찰, 핸드셰이크 캡처, 크래킹, 이블 트윈, WPS 등을 실습할 수 있는 안전하고 합법적인 샌드박스 환경입니다.

무선 장치는 mininet-wifi 가상 인터페이스(mac80211_hwsim)이므로, 전체 공간, 액세스 포인트, 클라이언트 스테이션, 그리고 공격자가 모두 소프트웨어로 실행되며 무선으로 전송되는 것은 아무것도 없습니다. 메뉴에서 랩을 선택하면 WifiForge가 네트워크를 구축하고, 노드별 터미널로 진입시켜 공격을 직접 실행할 수 있게 해줍니다. 종료하면 모든 것을 해체하고 정리합니다.

[!NOTE] WifiForge는 사용자의 머신에 국한된 가상 네트워크만 생성합니다. 소유하고 있거나 테스트가 명시적으로 허가된 환경에서만 사용하십시오.

---

연습 가이드

전체 연습 가이드 지침은 문서에서 확인할 수 있습니다:

➜ wififorge.github.io/

---

사용법

메뉴를 실행하고 랩을 선택하십시오:

sudo wififorge

키	동작
↑ ↓ / j k	선택 항목 이동
Enter	선택한 랩 실행
/	검색 (Esc로 지우기)
q / Esc	종료

랩을 실행하려면 root 권한이 필요합니다. root 없이도 둘러볼 수 있으며, wififorge --list는 모든 랩을 출력하고, wififorge --allow-non-root는 둘러보기용으로 메뉴를 엽니다.

---

랩 작성하기

랩은 자동으로 검색되는 작은 Python 모듈입니다. 메타데이터와 run() 진입점을 선언하면, 공유 하네스가 빌드 → tmux → 정리(teardown) 생명주기를 처리합니다.

from wififorge.labs._schema import LabMeta, Category, Difficulty
from wififorge.labs._harness import run_lab

LAB = LabMeta(
    title="My Lab",
    category=Category.ATTACK,
    difficulty=Difficulty.INTERMEDIATE,
    tools=("aircrack-ng",),
    summary="One or two sentences describing what the learner will do.",
)

def _topology(net):
    net.addStation("Attacker", wlans=1)
    host1 = net.addStation("host1", passwd="password123", encrypt="wpa2")
    ap1 = net.addAccessPoint("ap1", ssid="MyNet", passwd="password123",
                             encrypt="wpa2", mode="g", channel="1")
    net.configureWifiNodes()
    net.addLink(host1, ap1)
    return [ap1]

def run():
    run_lab("MY_LAB", ["Attacker", "host1"], _topology)

src/wififorge/labs/에 파일을 넣거나, --labs-dir DIR로 WifiForge가 사용자 지정 디렉터리를 가리키도록 설정하세요. 가져오기에 실패한 랩은 메뉴를 중단시키지 않으며, 비활성화된 상태로 표시될 뿐입니다.

---

안전

[!WARNING] WifiForge는 승인된 보안 연구 및 교육 목적으로만 사용해야 합니다. 여기서 배우는 기법은 본인이 소유하거나 테스트가 명시적으로 승인된 네트워크, 장치, 클라이언트에만 사용하세요.

[!NOTE] WifiForge는 RF를 전송하지 않습니다. 전체 무선 경로는 사용자 머신에서 실행되는 mininet-wifi의 mac80211_hwsim 가상 인터페이스이므로, 공중으로 아무것도 전송되지 않습니다.

---