
決定論的なオフライン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· Concept 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)· Provenance: SLSA L3 & Sigstore/attestations· Method Validation: UK FSR Statutory Code (FSA – DIG 100) / ISO 17025 Summary · License: MIT (REUSE 3.3) · Runtime: Python >= 3.10 (stdlib only, zero network calls, zero LLM dependencies)
starshield-forensics は、オフライン・読み取り専用のバイナリ検査および証拠トリアージツールキットであり、サードパーティ依存ゼロで3つの主要な利用者層にサービスを提供します:
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書き込み先行ログ復旧を、厳格なマスク処理済み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 での機能 | 認識論的境界と既知の制限 |
|---|---|---|
ゼロPIIストレージ実現可能性ゲート (precheck) | Chromium および Electron の IndexedDB / Local Storage フォルダ、または .log/.ldb ファイルをオフラインでスキャンし、LevelDB SSTable フッターマジック (0xdb4775248b80fb57)、.blob ディレクトリ、Blink 0xFF ヘッダーを検査し、平文の漏洩ゼロで決定的な GO / PARTIAL / NO_GO_COMPACTED_OR_UNSUPPORTED マニフェストを出力します。 | トリアージ前にコンパクション状態を事前スクリーニングしますが、.ldb ブロックの展開は行いません。 |
Chromium & Electron LevelDB .log カーバー (leveldb_log.py) | 32 KiB の物理ブロックを解析し、マスクされた Castagnoli CRC32C (0xA282EAD8) を検証し、ブロックをまたぐ FULL/FIRST/MIDDLE/LAST WriteBatch フレームを再構築し、Chromium ブラウザおよび Electron デスクトップアプリ (chatsvc は Microsoft Teams/Skype、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 で、IBAN を全 89 の SWIFT IBAN レジストリ国別長 (15–34 文字) + Mod-97 で、SWIFT/BIC を全 249 の ISO 3166-1 alpha-2 国コード + XK (250 コード合計) + ストップワードフィルタリングで検証し、UK ソートコードをメッセージ内 120 文字のウィンドウ内でペアリングします。 | 独自仕様の Pay.UK Vocalink ソートコードモジュラス重みテーブルは同梱していません。 |
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) | 4 つの読み取り専用で決定的なツール (starshield_demo、starshield_precheck_leveldb、starshield_inspect_image_tamper、starshield_validate_financial_iocs) を JSON-RPC 2.0 stdio (改行 & Content-Length フレーミング) 経由で Claude Desktop、Cursor、Google Antigravity、Windsurf 向けに公開します。 | デフォルトで 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