IP, 도메인, CVE에 대한 신속한 IOC 분석을 위해 6개의 무료 위협 인텔리전스 API를 사용하는 Python CLI 도구입니다. 출력: 색상으로 구분된 Excel, JSON, CSV. 사용: VT, Shodan, AbuseIPDB.
브라우저 탭을 전환하지 않고도 6개의 무료 위협 인텔리전스 API를 통해 IP, 도메인, 해시, CVE를 조사하세요.
🚀 공식 Awesome OSINT 저장소에 자랑스럽게 소개되었습니다.
🧠 ThreatLens 기여가 XERJ Corpus Hub 에 소개되었습니다.
ThreatLens는 가장 신뢰받는 무료 OSINT 소스 전반에서 위협 인텔리전스 조회를 통합하는 단일 명령줄 도구입니다. IP를 다섯 개의 서로 다른 웹사이트에 붙여넣는 대신, ThreatLens는 모든 사이트를 병렬로 조회하고 결과를 정규화하여 명확한 판정을 제공합니다 — 터미널에서, 또는 세련된 색상 구분 Excel/JSON/CSV 보고서로 제공합니다.
SOC 분석가, 사고 대응 담당자, 위협 헌터, 그리고 셸을 떠나지 않고 빠르고 신뢰할 수 있는 IOC 보강을 원하는 모든 사람을 위해 만들어졌습니다.
|
ThreatLens를 쓰는 이유
|
적합하지 않은 용도
|
| 기능 | 세부 사항 |
|---|---|
| 🎯 IOC 유형 | IP, 도메인, URL, 파일 해시 (MD5 / SHA1 / SHA256), CVE |
| 🔌 통합 API | AbuseIPDB, VirusTotal, AlienVault OTX, Shodan, URLScan.io, NVD, CISA KEV, EPSS |
| 📄 로그 파싱 | 일반 텍스트/로그 파일에서 IOC 자동 추출, Zeek, Suricata eve.json, Sysmon (JSON), 일반 JSONL 기본 지원 |
| 🧭 CVE 결정 카드 | CISA KEV, EPSS, CVSS 및 상관된 자산 노출을 기반으로 CVE별 결정론적이고 설명 가능한 패치 / 격리 / 모니터링 / 영향 없음 권장 사항 제공 |
| 🗂️ 자산 인벤토리 | 중요도 및 인터넷 노출 상태가 포함된 호스트/IP CSV 가져오기; CVE 결과와 상관 분석 |
| 📤 SIEM 내보내기 | Splunk HEC, Elastic _bulk, Microsoft Sentinel(최신 Logs Ingestion API)로 선택적 내보내기 |
| 🧾 증거 팩 | 기본적인 증거 보관 연속성(chain-of-custody)을 위한 SHA-256 매니페스트와 함께 조사 결과를 ZIP으로 내보내기 |
| 📊 보고서 | Excel(색상 구분), JSON, CSV |
| 💾 로컬 캐시 | 구성 가능한 TTL을 가진 SQLite 캐시 — 알려진 IOC 재쿼리 생략, 캐시된 CISA KEV 피드(24시간 TTL) 포함 |
| 🔐 프라이버시 제어 | 표준, 수동, 승인된 제공자 전용, 로컬 전용 모드; 외부 조회 전 민감한 URL 쿼리 매개변수 제거 |
| 👁️ IOC 워치리스트 | 만료, 수동 스캔, 판정 및 위험 신호에 대한 변경 추적 기능을 갖춘 로컬 SQLite 워치리스트 |
| 🧠 조사 메모리 | 저장된 IOC 관찰 검색, 판정/출처 이력 비교, 이전 조사에서 함께 발생한 IOC 찾기, 로컬 보존/내보내기 관리 |
| 🛡️ 보안 | 리다이렉트 차단, 호스트 허용 목록, 로그 내 API 키 마스킹, 스프레드시트 수식 무력화, CSV/로그 DoS 제한 |
| 🔒 잠금 파일 | 재현 가능한 설치를 위한 SHA-256 해시가 포함된 requirements.lock |
| 💻 CLI 경험 | 풍부한 진행 표시줄, 색상 테이블, 깔끔한 판정 요약 |
| 🧩 아키텍처 | 모듈식 enricher/parser/exporter, 타입 지정 모델, 엄격한 관심사 분리 |
| ✅ 테스트 완료 | pytest를 사용한 192개의 단위 및 통합 테스트; GitHub Actions를 통한 CI |
| ⚡ 복원력 | 하나의 API 또는 SIEM 대상이 실패해도 다른 대상은 차단되지 않음 — 오류는 격리되고 기록됨 |
# 1. Clone & install
git clone https://github.com/AbdaullahAG/threatlens.git
cd threatlens
pip install -r requirements.txt
# 2. Configure your API keys
cp config/keys.env.example config/keys.env
# → edit config/keys.env and fill in your keys
# 3. Run your first scan
python main.py -i 45.33.32.156
💡 NVD(CVE 조회)는 API 키 없이 바로 작동합니다. 다른 모든 API는 가입에 2분이 채 걸리지 않는 무료 티어를 제공합니다 — 아래 API 키를 참고하세요.
pip install --require-hashes -r requirements.lock
| 기본 단일 IOC 조회 |
| 한 번의 실행으로 IOC 유형을 혼합 및 매칭 |
| 원시 로그에서 바로 대량 조사 |
| 파이프라인을 위한 기계 판독 가능 출력 |
| 선택한 소스로 보강 제한 |
| 단일 실행으로 Excel + JSON + CSV |
| NIST NVD를 통한 CVE 보강 (무료, 키 불필요) |
| 문제 해결을 위한 전체 요청/응답 로깅 |
| 패치 / 격리 / 모니터링 / 영향받지 않음 권장 |
| SOC 로그 수집 → SIEM 내보내기 |
| 체인 오브 커스터디를 위한 SHA-256 매니페스트가 포함된 ZIP |