Social-Engineer Toolkit (SET) 딥다이브
— 메뉴로 조작하는 보안 모의훈련 프레임워크

1프로젝트 한줄 요약

"보안 담당자가 터미널에서 메뉴 번호를 눌러가며, 우리 조직 구성원을 대상으로 한 모의 피싱·모의 사회공학 훈련을 설계·실행하는 콘솔 프레임워크"입니다. 사회공학(social engineering)이란 기술적 취약점이 아니라 사람의 심리(신뢰·호기심·급함)를 노려 정보를 얻어내는 공격을 말합니다. SET은 그런 공격이 실제로 통하는지를 합의된 범위 안에서 시연해, 직원 교육과 보안 통제 검증에 쓰는 도구입니다.

이름 SET은 Social-Engineer Toolkit의 약자입니다. 2009년 보안 연구자 David Kennedy(별명 ReL1K)가 만들었고, 지금은 보안 컨설팅 회사 TrustedSec가 유지합니다. Kali Linux에 기본 포함될 만큼 업계 표준 도구이며, 15,000개가 넘는 GitHub 스타와 1만 5천 회 이상의 커밋이 쌓인 오래되고 검증된 코드베이스입니다.

2왜 주목받는가

SET은 2009년부터 있던 고전 도구인데도 트렌딩에 다시 오릅니다. 이유는 두 가지가 겹칩니다. 하나는 v8.1.3로의 현대화 작업(Python 3.11~3.13 대응, pyproject.toml 기반 패키징 전환)이고, 다른 하나는 보안 인식 훈련 수요가 계속 늘면서 "가장 널리 쓰이는 무료 사회공학 프레임워크"로서의 위상이 재조명되기 때문입니다.

다른 도구와의 위치

개발자 관점에서 흥미로운 이유

보안 기능을 떼어 놓고 봐도, SET은 "오래된 파이썬 프레임워크가 어떻게 진화하고, 어디서 기술 부채를 안고 있는가"를 보여 주는 살아 있는 교재입니다. 단일 거대 코어 모듈(setcore.py가 무려 77KB), 평문 key=value 설정 파일, exec()로 플러그인을 불러오는 방식 등은 "이렇게 짜면 빠르지만 이런 대가를 치른다"는 트레이드오프를 적나라하게 드러냅니다.

3기술 스택 전체 지도

SET은 웹 프레임워크 같은 화려함이 없는 순수 파이썬 CLI 스택입니다. 핵심은 "표준 라이브러리 위에 얇은 의존성을 얹고, 외부 보안 도구들을 호출해 묶는다"는 점입니다. 즉 SET 자신은 오케스트레이터(지휘자)에 가깝고, 실제 무거운 작업(익스플로잇·페이로드 실행)은 Metasploit 같은 외부 도구에 위임합니다.

언어 & 패키징

핵심 외부 의존성 (requirements.txt)

4개의 엔트리포인트 스크립트

SET은 하나의 실행파일이 아니라 용도가 다른 4개의 최상위 스크립트로 구성됩니다. pyproject.toml의 script-files에 등록되어 설치 시 시스템 경로에 들어갑니다.

4아키텍처 심화 분석

SET의 큰 그림은 "메뉴 구동 명령 디스패처(menu-driven dispatcher)"입니다. 화면에 번호 목록을 출력하고, 사용자가 숫자를 입력하면 거대한 if/elif 사다리가 해당 모듈을 골라 실행합니다. 객체지향의 우아한 명령 패턴(Command Pattern) 대신, 문자열·숫자 비교로 분기하는 절차적 구조가 특징입니다. 아래 도식은 setoolkit 진입부터 모듈 실행까지의 흐름입니다.

메뉴 하나가 처리되는 흐름

# 메뉴 선택의 일생
1. 화면 출력    → create_menu(text.X_text, text.X_menu)  (그리기만 담당)
2. 입력 받기    → input(core.setprompt(...))  (set:webattack> 형태 프롬프트)
3. 분기         → 거대한 if/elif 사다리가 숫자 문자열 비교
4. 모듈 적재    → try module_reload(mod) except import mod
5. 실행         → 모듈의 최상위 코드가 import 시점에 실행됨

핵심 설계 패턴 ① — 단일 거대 코어 파사드

거의 모든 모듈이 from src.core.setcore import * 또는 import src.core.setcore as core로 시작합니다. 즉 setcore.py 하나가 설정 읽기·메뉴 그리기·프롬프트 생성·로깅·OS 판별을 전부 담은 평평한 유틸리티 네임스페이스입니다. 이를 "팻 코어(fat core)" 패턴이라 부릅니다 — 쓰기는 편하지만 77KB까지 비대해진 건 모듈 결합도가 높다는 안티패턴 사례이기도 합니다. 좋은 면과 나쁜 면을 동시에 배우는 교재입니다.

핵심 설계 패턴 ② — 데이터와 동작의 분리(메뉴)

메뉴 화면은 src/core/menu/text.py에 평행한 리스트로 데이터화되어 있습니다. 예컨대:

# src/core/menu/text.py (발췌)
main_text = " Select from the menu:\n"
main_menu = ['Social-Engineering Attacks',
             'Penetration Testing (Fast-Track)',
             'Third Party Modules',
             'Update the Social-Engineer Toolkit', ...]

그리고 create_menu 클래스는 출력만 합니다 — 분기는 전혀 하지 않습니다. "데이터(메뉴 항목)"와 "표현(렌더링)"과 "동작(if/elif 분기)"을 따로 둔 셈인데, 분기가 객체가 아니라 절차적 비교라는 점이 한계입니다.

# src/core/setcore.py — create_menu는 렌더링 전용
class create_menu:
    def __init__(self, text, menu):
        print(text)
        for i, option in enumerate(menu):
            menunum = i + 1
            # "0D" 센티넬이면 '메인 메뉴로 복귀' 출력
            print('   %s) %s' % (menunum, option))

핵심 설계 패턴 ③ — 평문 설정 레지스트리

SET의 모든 동작 토글은 /etc/setoolkit/set.config라는 평문 KEY=VALUE 파일에서 읽힙니다. 약 65개 옵션이 들어 있고, check_config("KEY=") 함수가 파일을 줄 단위로 훑어 값을 찾습니다.

# src/core/setcore.py — 평문 설정 파서 (핵심 로직)
def check_config(param):
    fileopen = open("/etc/setoolkit/set.config", "r")
    for line in fileopen:
        line = line.rstrip()
        if line.startswith(param):
            line = line.replace('"','').replace("'","")
            return line.split("=", 1)[1]

이 파서는 startswith로만 매칭하므로 옵션 이름이 서로 접두사가 겹치면 안 됩니다. 단순하지만 깨지기 쉬운 설계로, "왜 설정 파서에 정식 포맷(INI/TOML)을 쓰는가"를 역으로 가르쳐 줍니다. 설정 버전은 CONFIG_VERSION 토큰으로 관리되어, 낡은 설정은 자동으로 백업(.bak) 후 갱신됩니다.

핵심 설계 패턴 ④ — 관례 기반 플러그인 계약

서드파티 모듈은 modules/ 폴더에 .py 파일을 떨어뜨리기만 하면 됩니다. 계약은 단 두 가지: 파일에 MAIN="설명" 마커가 있고, main() 함수를 노출하면 됩니다. module_handler.py가 glob으로 파일을 찾아 메뉴를 만들고, 선택 시 exec로 불러옵니다.

5디렉토리 구조 해부

최상위는 4개의 엔트리 스크립트 + 패키징 파일 + src/로 단순합니다. 진짜 구조는 src/ 안에서 "공격 벡터 = 폴더 하나" 형태로 갈립니다. 폴더 이름만 봐도 어떤 기능인지 짐작됩니다.

구조에서 읽어야 할 신호

세 가지가 핵심입니다. 첫째, 코어와 벡터의 분리입니다. src/core/가 프레임워크 엔진이고, 나머지 폴더(webattack/, phishing/…)는 그 위에 얹힌 공격 벡터입니다. 둘째, "기능 = 디렉토리" 규칙이 일관됩니다 — 웹 공격을 보려면 webattack/만 열면 됩니다. 셋째, modules/는 사용자 확장 지점입니다 — 코어를 건드리지 않고 새 모듈을 추가하는 통로입니다. 코드 탐색의 출발점은 setoolkit(진입) → src/core/setcore.py(엔진) → src/core/menu/text.py(메뉴 데이터) 세 파일입니다.

6학습 포인트 (기술별)

① 메뉴 구동 CLI 프레임워크 설계

SET은 "콘솔 앱을 프레임워크처럼 구조화하는 법"을 통째로 보여 줍니다. 메뉴 데이터(menu/text.py), 렌더러(create_menu), 디스패처(if/elif)를 분리한 방식을 관찰하세요. 실습: 같은 패턴으로 "메인메뉴 → 서브메뉴 → 동작"의 3단계 CLI 미니앱을 직접 짜 보고, SET의 절차적 분기를 파이썬 dict 디스패치 테이블로 리팩터링해 비교하기.

② pexpect로 외부 프로세스 자동 제어

다른 대화형 CLI(예: 데이터베이스 셸)를 코드로 띄워 답을 주고받는 pexpect는 자동화·테스트에 매우 유용한 기술입니다. 실습: pexpect로 로컬 파이썬 인터프리터나 bc 계산기를 자식 프로세스로 띄워, "프롬프트를 기다렸다가 입력을 보내고 출력을 파싱"하는 30줄 스크립트 작성하기. SET이 Metasploit을 어떻게 조종하는지 원리가 보입니다.

③ 동적 모듈 로딩(플러그인 시스템)

glob + importlib로 폴더의 .py를 자동 발견·로딩하는 구조는 확장 가능한 앱의 기본기입니다. 실습: plugins/ 폴더의 모든 모듈을 찾아 각자 register()를 호출하는 미니 플러그인 시스템을 exec 없이 importlib.import_module()로 구현해, SET의 exec 방식과 안전성을 대조하기.

④ 설정 관리 — 평문 vs 정식 포맷

SET의 check_config는 "직접 만든 파서가 왜 위험한가"를 보여 줍니다. 실습: SET의 config.baseline을 configparser(INI)나 tomllib(TOML)로 다시 표현하고, 접두사 충돌·따옴표 처리 같은 엣지 케이스가 어떻게 자동 해결되는지 확인하기.

⑤ 레거시 → 현대 패키징 마이그레이션

SET v8은 setup.py에서 pyproject.toml로 넘어가는 과도기를 보여 줍니다. 실습: 두 파일을 나란히 열어 script-files·requires-python·의존성 선언이 어떻게 대응되는지 매핑하고, 본인 토이 프로젝트를 pyproject.toml만으로 패키징해 pip install -e . 해 보기.

⑥ 보안 인식 — 공격을 알아야 방어한다

코드를 읽으며 "피싱이 기술적으로 어떻게 구성되는가"를 이해하면, 역으로 방어(이메일 필터·2FA·사용자 교육)의 필요성이 또렷해집니다. 실습: SET의 templates/ 피싱 메일 본문을 읽고, "이 메일을 받은 직원이 의심해야 할 신호 5가지"를 정리해 사내 보안 체크리스트로 만들기. (실제 발송이 아니라 분석·교육 목적)

7하드웨어 / 시스템 요구사항

가장 안전한 시작 — 코드만 읽는 방법

# 실행하지 않고 소스만 받아 구조를 분석 (가장 안전)
git clone --depth 1 https://github.com/trustedsec/social-engineer-toolkit set
cd set

# 엔진의 핵심 3파일만 먼저 읽기
less setoolkit                  # 진입점·메인 루프
less src/core/setcore.py        # 코어 파사드(검색: create_menu, check_config)
less src/core/menu/text.py      # 메뉴 데이터 구조

# 실제 실행이 필요하면 반드시 격리된 Kali VM 안에서:
#   python3 -m venv .venv && source .venv/bin/activate
#   pip install -e .   →   sudo setoolkit  (VM 한정)

8직접 해볼 수 있는 실습 과제

9관련 기술 심화 학습 로드맵

10핵심 키워드 사전

11참고 링크