higernes

Python으로 작성된 수동적 OSINT 툴킷. API 키도, 계정도, 어디에도 로깅도 없다. 핸들, 이메일, 도메인, IP, 전화번호 또는 해시를 지정하면 이미 공개된 정보를 파헤친다.

무엇을 하는가

6개의 모듈, 모두 공개 엔드포인트를 읽는다:

모듈	얻을 수 있는 것
username	핸들을 약 700개 사이트(WhatsMyName 데이터셋)에 걸쳐 훑으며, 적중이 들어오는 대로 실시간 갱신
email	구문, MX, 일회용 여부 검사, gravatar, 그다음 @ 앞부분을 username으로 사용
domain	A/AAAA/MX/NS/TXT/CNAME, http 상태와 제목, 인증서 투명성 로그에서 얻은 서브도메인, whois
ip	geo + ASN, 역방향 dns, 선택적 일반 포트 스캔
phone	유효성, 통신사, 지역, 회선 유형, 시간대
hash	길이/문자셋 식별
scan	C++ 코어로 구동되는 배너 그래빙을 포함한 빠른 TCP 포트 스캔

여기 있는 어떤 것도 사적인 영역을 건드리지 않는다. 전부 DNS, WHOIS, 공개 프로필 엔드포인트, 인증서 로그다.

사이트 데이터베이스

username 스윕은 data/wmn-data.json을 기반으로 실행된다 - 커뮤니티 WhatsMyName 데이터셋으로, 약 700개 사이트에 각각 검사 규칙(상태 코드와 반드시 존재해야 하고, 반드시 존재하지 않아야 하는 문자열)이 있다. 더 새로운 사본을 언제든 파일 위에 덮어써서 교체하면 된다; 툴은 시작 시 이를 읽는다. 파일이 없으면 작은 내장 목록으로 폴백한다.

--cat으로 스윕 범위를 좁혀라:

python higernes.py username vqkro --cat social
python higernes.py username vqkro --cat gaming

--cat 없이 실행하면 모든 것을 대상으로 한다.

C++ 코어

포트 스캐너는 Python으로는 너무 느려서, 무거운 작업은 core/hcore.cpp에 있다

• 배너 그래빙과 호스트명 해석을 포함한 스레드 기반 connect 스캔을 수행하는 작은 독립 실행 바이너리다. higernes.py는 자기 옆(또는 core/, 또는 PATH)에서 이를 찾아 셸로 실행한다; 없으면 ip --ports 스캔은 조용히 더 느린 순수 Python 버전으로 폴백한다.

빌드하기 (소스에서 실행하면서 빠른 경로를 원할 때만 필요):

# windows (mingw g++)
g++ -O2 -std=c++17 -static -o core/hcore.exe core/hcore.cpp -lws2_32

# linux / macOS
g++ -O2 -std=c++17 -o core/hcore core/hcore.cpp -pthread

원한다면 직접 실행해도 된다:

hcore dns github.com
hcore ports example.com --banners
hcore ports example.com --all --threads 1024

Releases 페이지의 미리 빌드된 .exe에는 코어가 이미 내장되어 있다.

설치

Python 3.9 이상이 필요하다.

모든 OS

pip install -r requirements.txt

이것은 rich, requests, dnspython, aiohttp를 가져온다. phonenumbers도 포함되어 있지만 phone 모듈만 이를 필요로 한다 - 파일에서 빼도 나머지는 여전히 실행된다. aiohttp가 없으면 username 스윕은 스레드로 폴백하는데, 이는 훨씬 느리다(수백 개 대상에서 수십 초).

Windows (PowerShell, python이 아직 PATH에 없을 경우)

winget install --id Python.Python.3.13 -e
git clone https://gitlab.com/jankoboy88/higernes
cd higernes
pip install -r requirements.txt
python higernes.py

Linux / macOS

git clone https://gitlab.com/jankoboy88/higernes
cd higernes
python3 -m pip install -r requirements.txt
python3 higernes.py

FreeBSD

pkg install -y python3
git clone https://gitlab.com/jankoboy88/higernes
cd higernes
python3 -m pip install -r requirements.txt

pip가 externally-managed environment에 대해 불평하면, venv를 사용하거나:

python3 -m venv .venv && . .venv/bin/activate && pip install -r requirements.txt

--break-system-packages를 전달하라.

사용

그냥 실행하면 메뉴가 나온다. 또는 모듈로 바로 들어가라:

python higernes.py username vqkro
python higernes.py username vqkro --cat coding
python higernes.py email [email protected]
python higernes.py domain example.com
python higernes.py ip 1.1.1.1 --ports
python higernes.py phone +14155552671
python higernes.py hash 5f4dcc3b5aa765d61d8327deb882cf99
python higernes.py scan example.com
python higernes.py scan example.com --all

화면은 전부 실시간 스피너와 색상 테이블이다; 워드마크는 시작 시 스스로 그려진다.

참고

• dnspython과 requests를 강력히 권장한다. dnspython이 없으면 A 레코드만 (표준 라이브러리를 사용해) 해석되고 다른 모든 레코드 유형은 건너뛴다.
• 사이트 스윕은 휴리스틱이다 - "found"는 단지 엔드포인트가 긍정 신호를 반환했다는 의미일 뿐이므로, 조치를 취할 계획이라면 무엇이든 재확인하라.
• ip-api의 무료 티어는 분당 약 45회 조회로 제한된다.
• crt.sh는 느리거나 다운될 수 있다; 그럴 때 해당 섹션은 그렇다고 알리고 넘어간다.

독립 실행 exe 빌드

대상 머신에 Python이 없다? 번들로 묶어라:

pip install pyinstaller
pyinstaller --onefile --name higernes --console higernes.py
# -> dist/higernes.exe

Releases 페이지의 바이너리가 이렇게 만들어진다. 그 외에 설정할 것은 없다.

라이선스

MIT. LICENSE 참조.