Justin Seitz의 저서 "Black Hat Python"의 소스 코드입니다. 이 코드는 Python 3로 완전히 변환되었으며, PEP8 표준을 준수하도록 재포맷되었고, 더 이상 사용되지 않는 라이브러리 구현과 관련된 의존성 문제를 제거하기 위해 리팩토링되었습니다.
Justin Seitz가 저술한 Black Hat Python: Python Programming for Hackers and Pentesters (No Starch Press, 2014) 초판의 소스 코드로, Python 2에서 Python 3로 변환하고 최신 인터프리터와 라이브러리에서 실행되도록 리팩터링한 것입니다.
스크립트는 책과 나란히 읽을 수 있도록 인쇄된 목록에 가깝게 유지됩니다. 변환 과정에서 이루어진 모든 변경 사항은 docs/CONVERSION_NOTES.md에 문서화되어 있습니다.
[!NOTE] No Starch Press는 2021년에 Justin Seitz와 Tim Arnold가 처음부터 Python 3를 대상으로 저술한 제2판을 출간했습니다. 이 저장소는 제1판을 따릅니다. 제2판을 가지고 계신다면 출판사의 코드를 사용하십시오.
TJ O'Connor의 Violent Python 변환 동반 프로젝트는 EONRaider/violent-python3에 있습니다.
Python 3.11 이상. 다음 설정 중 하나를 선택하십시오.
uv는 Python 버전이 없으면 올바른 버전을 설치하고, uv.lock에서 CI로 테스트된 정확한 의존성 버전을 재현합니다.
git clone https://github.com/EONRaider/blackhat-python3.git
cd blackhat-python3
uv sync # every chapter
uv run python chapter02/bhnet.py -h
각 챕터는 별도의 dependency group이므로, 읽고 있는 내용만 설치할 수 있습니다:
uv sync --only-group ch04 # just chapter 4
Windows에서는 ch08-ch10 그룹이 pywin32와 wmi도 설치하며, 다른 플랫폼에서는 자동으로 건너뜁니다.
git clone https://github.com/EONRaider/blackhat-python3.git
cd blackhat-python3
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt # every chapter
pip install -r requirements/ch04.txt # or just one chapter
requirements*.txt에는 버전 범위가 지정되어 있습니다. CI에서 테스트된 정확한 버전을 사용하려면 최신 릴리스의 requirements-lock.txt를 사용하세요.
pip 25.1 이상에서는 pip install --group ch04로 pyproject.toml에서 챕터 그룹을 바로 설치할 수도 있습니다.
각 릴리스는 모든 크로스 플랫폼 챕터의 의존성과 일반 네트워크 도구가 미리 설치된 linux/amd64 및 linux/arm64용 이미지를 게시합니다:
docker run --rm -it ghcr.io/eonraider/blackhat-python3
# Chapters that sniff or forge packets need raw-socket capabilities:
docker run --rm -it --cap-add=NET_RAW --cap-add=NET_ADMIN ghcr.io/eonraider/blackhat-python3
# Or build it yourself:
docker build -t blackhat-python3 . && docker run --rm -it blackhat-python3
이 이미지는 대부분의 raw-socket 장에서 필요하기 때문에 root로 실행됩니다. 컨테이너가 샌드박스이므로, 장에서 필요한 기능만 추가하세요. Windows 장(8-10)은 이 컨테이너에서 실행할 수 없습니다.
위의 Open in GitHub Codespaces 배지를 사용하거나, Dev Containers 확장이 설치된 VS Code 또는 JetBrains에서 폴더를 여세요. 컨테이너(.devcontainer/devcontainer.json)에는 Docker 이미지와 동일한 도구가 있으며, 추가로 uv, git, 컴파일러가 포함되어 있고 raw-socket 기능이 이미 부여된 상태로 제공됩니다.
| 장 | 주제 | uv 그룹 | PyPI 패키지 | 비고 |
|---|---|---|---|---|
| 02 | 네트워크: 기초 | ch02 | paramiko | test_rsa.key는 bh_sshserver.py에 필요한 Paramiko의 공개 테스트 키(테스트 스위트에서 가져옴)입니다. |
| 03 | Raw 소켓과 스니핑 | - | - | 표준 라이브러리만 사용. root / Administrator 권한 필요. |
| 04 | Scapy로 네트워크 장악하기 | ch04 | kamene, opencv-python | 변환 당시의 Scapy Python 3 포크인 kamene을 사용합니다. root / NET_RAW 권한 필요. |
| 05 | 웹 해킹 | - | - | 표준 라이브러리만 사용. 워드리스트 all.txt와 cain.txt가 포함되어 있습니다. |
| 06 | Burp Proxy 확장하기 | - | - | CPython이 아닌 Jython 2.7에서 실행되는 Burp Suite 확장입니다(jython-standalone-2.7.2.jar 포함). |
| 07 | GitHub 명령 및 제어 | ch07 | github3.py | GitHub 저장소와 개인 액세스 토큰이 필요합니다. |
| 08 | Windows에서의 일반적인 트로이 목마 작업 | ch08 | pywin32 (Windows) | Windows 전용. keylogger.py는 아직 지원되는 어떤 Python에서도 실행되지 않습니다: 설치 가능한 어떤 패키지도 제공하지 않는 pyHook을 임포트하기 때문입니다(변환 노트 참조). |
| 09 | Internet Explorer 가지고 놀기 | ch09 | pycryptodome, pywin32 (Windows) | 암호화 헬퍼를 제외하면 Windows 전용. |
| 10 | Windows 권한 상승 | ch10 | pywin32 (Windows), wmi (Windows) | Windows 전용. bhvulnservice.zip은 책에 나오는 취약한 서비스입니다. |
| 11 | 공격적 포렌식 자동화 | - | - | Immunity Debugger(immlib, Python 2.7)와 Volatility 2 프레임워크가 필요합니다. 둘 다 PyPI에서 설치되지 않습니다. |
책의 1장은 환경 설정을 다루며 코드가 없습니다. PyPI 열은 각 장의 임포트를 읽는 python tools/deps_scan.py report로 생성됩니다. OS 및 권한 관련 비고는 변환 노트에서 가져온 것이며 불완전할 수 있습니다. 수정은 환영합니다.
전체 체크아웃은 약 46 MB에 51 MB의 히스토리를 더한 크기입니다. 트리의 대부분은 chapter06/에 있는 43 MB의 Jython JAR이므로, 얕은 클론(--depth 1)으로는 많이 절약되지 않습니다. 원하는 장만 다운로드하려면:
git clone --filter=blob:none --sparse https://github.com/EONRaider/blackhat-python3.git
cd blackhat-python3
git sparse-checkout set chapter02 chapter03 # any chapters you want
클론을 완전히 건너뛰고 Docker 이미지를 사용할 수도 있습니다.
이 코드에는 트로이 목마, 키로거, 자격 증명 수집기, 권한 상승 도구가 포함되어 있습니다. 소유한 시스템이나 서면으로 테스트 허가를 받은 시스템에만 실행하십시오. chapter10/bhvulnservice.zip, chapter11/cmeasure.bin 및 8장 키로거와 같은 일부 파일은 백신 소프트웨어에 의해 탐지될 수 있습니다. 이는 예상된 동작입니다. SECURITY.md를 참조하십시오.
버그 수정, 최신 라이브러리에 대한 호환성 수정, 문서 개선을 환영합니다. 범위, 개발 워크플로 및 릴리스 방식은 CONTRIBUTING.md를 참조하십시오. 보안 문제는 SECURITY.md에 설명된 대로 보고하십시오.
turkish-language 브랜치이 코드는 No Starch Press에서 출판한 Justin Seitz의 _Black Hat Python_에서 파생되었습니다. 오픈 소스 라이선스는 부여되지 않습니다. 그 의미와 번들로 포함된 타사 파일의 조건은 NOTICE를 참조하십시오. Python 3 변환은 EONRaider와 기여자들이 수행했으며, Enraged의 수정 사항도 포함되어 있습니다.
학술 작업에서 이 저장소를 참조하는 경우, GitHub의 Cite this repository 버튼은 CITATION.cff를 사용합니다.