AV 탐지를 PE 오프셋, 섹션, RVA/VA 및 문자열에 매핑하고 YARA, AMSI, capa 및 다중 엔진 스캔과 JSON/HTML 보고서를 제공하는 Windows 아티팩트 분석 툴킷입니다.
정적 분석 결과와 로컬 보안 엔진의 판정을 분석가가 검토할 수 있는 정확한 파일 오프셋, PE 주소, 함수, 심볼, 소스 위치와 연관시킵니다.
[!NOTE] SigLens는 분석 대상 아티팩트를 보존합니다. 네이티브 오프셋, 정확한 YARA 일치, 추론된 경계, 후보 영역을 구분하여 다운스트림 의사 결정이 사용 가능한 증거의 강도에 기반하도록 유지합니다.
SigLens는 아티팩트 분류, 오탐 조사, 시그니처 진단, 탐지 엔지니어링을 위한 로컬 Windows 분석 툴킷입니다. PE 검사, YARA, AMSI, 로컬에 설치된 AV 엔진, 심볼 해석, 포렌식 보고를 하나의 CLI 및 데스크톱 워크플로로 결합합니다.
| 분석 | 연관 분석 | 검토 | 보고 |
|---|---|---|---|
| PE 구조, 문자열, 엔트로피, IOC, 스크립트 | 파일 오프셋 → 섹션 → RVA → VA → 함수 → PDB/소스 | 헥스 컨텍스트, Ghidra 북마크, 엔진 출처 | 버전 관리되는 JSON 및 독립 실행형 HTML |
SigLens는 두 가지 귀속 모델을 사용합니다:
flowchart LR
A[Artifact] --> B[Static analysis]
A --> C[Local security engines]
B --> D[Offsets and PE mapping]
C --> E[Verdicts and provenance]
D --> F[Function, PDB, source]
D --> G[Ghidra locations]
E --> H[Evidence classification]
F --> I[JSON and HTML report]
G --> I
H --> I
CLEAN, DETECTED, UNKNOWN, UNAVAILABLE 및 ERROR 상태.siglens-report/v1 JSON 계약 및 독립형 HTML 보고서.git clone https://github.com/St0rn/SigLens.git
cd SigLens
.\scripts\Install.ps1 -Dev -AddToUserPath
설치 프로그램은 격리된 .venv를 생성하고, SigLens와 해당 siglens 콘솔 명령을 설치하며, 로컬 통합을 감지하고, -SkipAVInstall이 제공되지 않는 한 휴대용 ClamAV를 설치하거나 업데이트합니다. 라이선스가 있는 상용 제품은 존재할 경우 감지되며, 절대 자동으로 설치되지 않습니다.
현재 PowerShell 정책이 로컬 스크립트를 차단하는 경우, 설치 프로그램을 실행하기 전에 조직에서 이 프로세스에 허용하는 정책을 적용하십시오.
siglens scan C:\Samples\sample.exe
siglens scan C:\Samples\sample.exe `
--yara .\rules `
--symbol-path .\symbols `
--iocs `
--dissect `
--capa `
--amsi `
--engines .\engines.json
보고서는 JSON 및 HTML 형식으로 reports\에 작성됩니다.
siglens pe-security C:\Samples\sample.exe
siglens pe-security C:\Samples\sample.exe --output .\reports\sample-pe.json
이 명령은 이미지 완화 기법과 이를 해석하는 데 필요한 증거를 보고하며, 여기에는 ASLR에 사용 가능한 재배치가 있는지 여부도 포함됩니다. 실행 가능 및 쓰기 가능 섹션, 실행 가능 섹션 외부의 진입점, 잘못된 인증서 테이블 경계, TLS 콜백, 디버그/PDB 레코드, 오버레이 데이터를 강조 표시합니다. 인증서 테이블의 존재는 메타데이터일 뿐이며, SigLens는 서명자나 신뢰 체인이 검증되었다고 주장하지 않습니다.
siglens gui
siglens gui C:\Samples\sample.exe
.\scripts\Build.ps1
.\dist\SigLens.exe --help
빌드에는 dist\ 아래에 엔진 구성 템플릿과 보고서 스키마가 포함됩니다.
모든 Ghidra 위치에는 분류, 사용 가능한 경우 신뢰도 값, 그리고 출처가 함께 기록됩니다.
| 분류 | 의미 | 증거 강도 |
|---|---|---|
EXACT_MATCH | YARA가 출력한 정확한 오프셋 | 정확 |
NATIVE_ENGINE_OFFSET | 구성된 엔진 어댑터가 출력한 오프셋 | 해당 엔진에 고유 |
INFERRED_BOUNDARY | 접두사 측정으로 경계가 정해진 재현 가능한 전이 | 실험적 |
CANDIDATE_REGION | 탐지되었거나 구조적으로 관련된 영역 | 영역 수준 |
CONTEXT_DEPENDENT | 측정값이 단일 책임 위치를 뒷받침하지 않음 | 판정 불가 |
접두사 축소는 반복된 판정과 통제된 체크포인트를 기록합니다. 동일한 접두사가 상충하는 결과를 생성하거나, 더 긴 접두사는 깨끗한데 더 짧은 접두사가 탐지되는 경우, SigLens는 단일 추론 경계 대신 CONTEXT_DEPENDENT를 보고합니다.
분석 보고서를 생성하고, 정확한 아티팩트와 대조하여 검증한 뒤, 검토 위치를 내보냅니다:
siglens scan C:\Samples\sample.exe --yara .\rules --engines .\engines.json
siglens verify-report .\reports\sample.json `
--artifact C:\Samples\sample.exe
siglens ghidra-offsets C:\Samples\sample.exe .\reports\sample.json `
--output .\reports\sample-ghidra.csv `
--script .\reports\ImportSigLens.py
The exporter verifies the artifact SHA-256 before using any location. The
generated script performs the same check inside Ghidra, resolves each RVA
against the current program image base, and creates a
SigLens/<classification> bookmark. Raw overlay offsets remain in the CSV
because they have no loaded memory address.
See Ghidra location workflow for import instructions and interpretation guidance.
알려진 빌드에 대한 기준 보고서를 유지하고, 동일한 실험실 조건에서 다음 빌드를 분석한 뒤, 기록된 증거를 비교합니다:
siglens compare-reports .\reports\baseline.json .\reports\candidate.json `
--output .\reports\evidence-diff.json
비교는 엔진 판정 및 시그니처 전환, AMSI 변경 사항, 추가되거나 제거된 YARA 규칙, PE 임포트 및 보안 태세 변경, 분류별 Ghidra 위치 수를 기록합니다. 결과는 관찰된 실험실 증거를 설명하며, 빌드에 회피 레이블을 지정하거나 변환을 생성하지 않습니다. SigLens는 두 보고서 간에 도구 버전, 엔진 세트 또는 AMSI 커버리지가 다를 경우 경고합니다.
후보 증거를 CI 및 분석 플랫폼에서 수집할 수 있도록 SARIF 2.1.0으로 내보냅니다:
siglens export-sarif .\reports\candidate.json `
--output .\reports\candidate.sarif
SARIF 결과는 결과 추적을 위해 바이트 오프셋, 신뢰도, RVA/VA 데이터, 엔진 시그니처, 출처 정보, 결정적 지문을 보존합니다.
검증되었거나 추론된 모든 보고서 위치를 네이티브 심볼, 관리되는 메서드, 소스 후보로 다시 매핑합니다:
siglens attribute-source C:\Samples\sample.exe .\reports\sample.json `
--symbol-path .\symbols `
--linker-map .\build\sample.map `
--source-map .\build\sample.siglens-source-map.json `
--source-root C:\Code\Project
네이티브 C/C++ 빌드는 DbgHelp PDB 라인과 MSVC MAP 심볼을 사용합니다. 관리형 C# 빌드는 siglens-source-map/v1을 통해 SHA-256으로 바인딩된 메서드 RVA와 Portable PDB 시퀀스 포인트 데이터를 제공할 수 있습니다. 대체 소스 검색은 명시적으로 저신뢰도 후보로 분류됩니다. 귀속 보고서는 관련 바이너리 및 소스 위치와 함께 SARIF로 내보낼 수도 있습니다. 소스 귀속 워크플로를 참조하세요.