결정론적 오프라인 Chromium LevelDB .log 카버, PNG/JPEG ICC 출처 검사기, 금융 체크섬 검증기 & StarShield-Bench-24
starshield-forensics (v0.3.8 — 클린룸 결정론적 DFIR & MCP 툴킷)English | 简体中文 (
README.zh-CN.md)
결정론적 Chromium & Electron IndexedDB / LevelDB
.log다중 스키마 레코드 카버, 구조적 PNG/JPEG 컨테이너 검사기, 금융 체크섬 검증기 & 무의존성MCP서버저자: Ziqi Xiao (
@Ziqi) · PyPI:starshield-forensics 0.3.8 (PEP 740)· Homebrew:Ziqi/tap/starshield-forensics· 개념 DOI:10.5281/zenodo.24145804(v0.3.7:10.5281/zenodo.24156262) · SWHID:swh:1:snp:4ed5efec...· OpenSSF Best Practices:#16602 (SILVER — 226%)· Scorecard:8.0 / 10 (Fuzzing 10/10 · 11/18 Perfect Checks)· 출처 증명: SLSA L3 & Sigstore/attestations· 방법론 검증: UK FSR Statutory Code (FSA – DIG 100) / ISO 17025 요약 · 라이선스: MIT (REUSE 3.3) · 런타임: Python >= 3.10 (표준 라이브러리만 사용, 네트워크 호출 없음, LLM 의존성 없음)
starshield-forensics는 오프라인, 읽기 전용 바이너리 검사 및 증거 트리아지 툴킷으로, 서드파티 의존성 없이 세 가지 주요 사용자층을 지원합니다:
starshield inspect-image): 환급 영수증, 결제 스크린샷, 분쟁 첨부 파일에 대한 밀리초 단위의 구조적 검증—RFC 2083 PNG 청크 CRC32 무결성(IHDR/IDAT/IEND/iCCP), 다중 세그먼트 ISO 10918 JPEG APP2 ICC_PROFILE 색상 헤더(acsp), Photoshop APP13 (8BIM) 리소스 블록을 오프라인 ISO-7812 Luhn / 89개국 ISO-13616 IBAN Mod-97 / ISO-9362 SWIFT 검증과 함께 확인합니다.starshield precheck & parse-leveldb-log): 손상된 Chromium 브라우저(Chrome, Edge, Brave) 및 Electron 데스크톱 앱(VS Code, Slack, Microsoft Teams, Discord, WhatsApp Desktop) IndexedDB / Local Storage 캐시에 대한 읽기 전용 로컬 상태 점검 및 비압축 .log write-ahead log 복구를 엄격한 마스킹 Castagnoli CRC32C(0xA282EAD8) 검증을 사용하여 수행합니다.UK FSR FSA – DIG 100 / ISO 17025 정합): 소프트 삭제되었거나 편집된 웹 메시징 및 B2B 포털 기록을 바이트 오프셋 인용 방식으로 카빙하며, 명시적인 4단계 인식론적 태깅(OBSERVED / DERIVED / INFERRED / UNKNOWN)과 임시 HMAC-SHA256 가명처리를 적용합니다.samples/ 및 starshield/data/에 포함된 모든 번들 픽스처와 benchmark/benchmark_suite.py의 시드된 24개 케이스 평가 스위트(StarShield-Bench-24)는 가상의 2025년 영국 공급업체 인보이스 시나리오(GBP 18,400.00, ISO-13616 예시 IBAN GB82WEST12345698765432 및 NO9386011117947, Luhn 테스트 문자열 6200000000000005)를 모델로 한 100% 클린룸 명세 테스트 벡터입니다. 실제 사건 데이터나 PII는 전혀 포함되어 있지 않습니다.
v0.3.8)모든 분석 출력에는 명시적인 기계 판독 가능 인식론적 계층이 부여되어, 조사관과 변호사가 원시 바이트와 해석적 단서를 절대 혼동하지 않도록 합니다:
OBSERVED: 원시 입력 바이트, 청크 헤더 또는 JSON 필드에 직접 존재하는 항목(물리적 WAL 프레임 오프셋 또는 청크 오프셋에 바인딩됨).DERIVED: 표준화된 알고리즘(Castagnoli CRC32C, ISO/IEC 7812 Luhn, ISO-13616 Mod-97, UTC 델타 산술)을 통해 원시 입력으로부터 결정론적으로 계산된 항목.INFERRED: 외부 보강(예: 서버 측 은행 로그 또는 소환된 ISP 기록)이 필요한 맥락적 선별 단서로, 단독 증거로 단정되지 않습니다.UNKNOWN: 로컬 클라이언트 아티팩트의 증거 경계를 명시적으로 벗어난 항목(예: 압수 전에 압축된 기록).| 모듈 | v0.3.8에서의 기능 | 인식론적 경계 및 알려진 한계 |
|---|---|---|
Zero-PII 저장소 실현 가능성 게이트 (precheck) | Chromium 및 Electron IndexedDB / Local Storage 폴더 또는 .log/.ldb 파일을 오프라인으로 스캔하고, LevelDB SSTable footer magic(0xdb4775248b80fb57), .blob 디렉터리, Blink 0xFF 헤더를 확인하여 평문 유출 없이 결정론적 GO / PARTIAL / NO_GO_COMPACTED_OR_UNSUPPORTED 매니페스트를 출력합니다. | 트리아지 이전에 컴팩션 상태를 사전 스크리닝하며, .ldb 블록을 압축 해제하지 않습니다. |
Chromium 및 Electron LevelDB .log Carver (leveldb_log.py) | 32 KiB 물리 블록을 파싱하고, 마스킹된 Castagnoli CRC32C(0xA282EAD8)를 검증하며, 블록 간 FULL/FIRST/MIDDLE/LAST WriteBatch 프레임을 재조립하고, Chromium 브라우저 및 Electron 데스크톱 앱(Microsoft Teams/Skype용 chatsvc, Slack, WhatsApp Web/Desktop, Discord, VS Code, 그리고 --schema auto|chatsvc|generic-json을 통한 B2B 인보이스 포털) 전반에서 UTF-8 및 Blink UTF-16LE JSON 레코드를 추출합니다. | Snappy .ldb SSTable을 압축 해제하거나 비-JSON Blink StructuredClone 프리미티브를 디코딩하지 않습니다(로드맵: v0.4). |
내보낸 메시지 및 포털 JSON 트리아지 (triage-json) | 메시징 및 포털 내보내기 전반에서 소프트 삭제된(deletetime / deleted_ts / is_deleted) 및 편집된(edittime / edited.ts) JSON 레코드를 열거하고, 레코드별로 엄격하게 검증된 IOC를 추출합니다. | 수집 이전에 이미 컴팩션되었거나 제거된 레코드는 정량화할 수 없습니다. |
금융 체크섬 검증 (ioc_validators.py) | ISO/IEC 7812 Luhn을 통한 결제 카드, 전체 89개 SWIFT IBAN Registry 국가 길이(15–34자) + Mod-97을 통한 IBAN, 전체 249개 ISO 3166-1 alpha-2 국가 코드 + XK(총 250개 코드) + 불용어 필터링을 통한 SWIFT/BIC, 그리고 120자 메시지 내 윈도우 내에서 UK Sort Code 쌍을 검증합니다. | 독점적인 Pay.UK Vocalink sort-code 모듈러스 가중치 테이블을 번들로 포함하지 않습니다. |
RFC 2083 PNG 및 ISO 10918 JPEG 컨테이너 검사 (image_containers.py) | PNG IHDR + IDAT + IEND 완전성 및 청크별 CRC32를 강제하고, iCCP 청크(acsp)를 경계 내에서 압축 해제하며, 다중 청크 JPEG APP2 ICC_PROFILE + APP13(8BIM) 세그먼트를 SOS/EOI(0xFFD9)를 통해 재조립합니다. | 중립적인 컨테이너 관찰 결과 + 양성 스크린샷/OS 재저장 주의사항을 출력하며, 단독으로 "위조 증거"를 선언하지 않습니다. |
제로 의존성 MCP 서버 (mcp_server.py / starshield mcp) | Claude Desktop, Cursor, Google Antigravity, Windsurf를 위해 JSON-RPC 2.0 stdio(개행 및 Content-Length 프레이밍)를 통해 4개의 읽기 전용 결정론적 도구(starshield_demo, starshield_precheck_leveldb, starshield_inspect_image_tamper, starshield_validate_financial_iocs)를 노출합니다. | 기본적으로 HMAC-SHA256 마스킹 모드를 강제하여 클라우드 LLM이 원시 PII, 파일명 또는 원시 SHA-256 해시를 절대 수신하지 않도록 합니다. |
키 기반 가명화 및 암호화 민첩성 (cli.py) | 기본 마스킹 모드는 실행별 임시 HMAC-SHA256 토큰(--hmac-digest {sha256,sha384,blake2b} 및 외부 32바이트 솔트 --hmac-key-file PATH로 구성 가능)을 적용하고, 원시 파일 SHA-256 해시, 정확한 바이트 길이, 소스 파일명, PNG tEXt/iTXt 미리보기, 사용자 지정 ICC 이름, 정확한 UTC 날짜, 실패 경로 stderr 파일명/바이트 수/스니펫을 억제합니다. | 일상적인 화면/로그 위생을 위한 키 기반 가명화를 제공하며, UK GDPR / GDPR에 따른 공식 법적 익명화가 아닙니다. --unredacted는 승인된 오프라인 환경에서만 전달하십시오. |
uvx) 및 설치(pip PEP 740 / .pyz)# Instant zero-install clean-room showcase (fetches PyPI wheel directly, zero repo clone needed):
uvx --from starshield-forensics starshield demo
# Option A — Official PyPI package (with PEP 740 Sigstore digital attestations, zero dependencies):
pip install starshield-forensics
starshield demo
# Option A2 — macOS / Linux Homebrew Tap (isolated virtualenv formula, zero dependencies):
brew install Ziqi/tap/starshield-forensics && starshield demo
# Option B — Zero-install single-file zipapp (for air-gapped forensic VMs & law-firm IT):
python3 starshield.pyz demo
python3 starshield.pyz precheck /path/to/readonly_chromium_idb_copy