SPF/DKIM/DMARC、なりすまし、フィッシングに対応したメールヘッダーおよび.emlアナライザー。100%ブラウザ上で動作するため、メールがアップロードされることはありません。
[!IMPORTANT] あなたのメールがデバイスの外に出ることはありません。 ホスト版は WebAssembly を使用して、アナライザー全体をブラウザのタブ内で実行します。ESHA サーバーは存在せず、開いたヘッダーや
.emlファイルがアップロード、保存、共有されることは一切ありません。GitHub や ESHA プロジェクトと共有されることもありません。
- アップロードなし: 分析はページ内のバックグラウンドワーカーでローカルに実行されます。
- 第三者なし: CDN、アナリティクス、トラッカー、DNS やレピュテーションのルックアップはありません。
- ブラウザによって強制: ページの Content Security Policy (
connect-src 'self') により、他のサーバーへの通信がブロックされます。- 検証可能: ブラウザの DevTools を開き、Network タブでメッセージを分析すると、それを運ぶリクエストが一切ないことを確認できます。
このため、同僚からのフィッシング報告やインシデントの証拠など、機密性の高いメッセージに適しています。
メールのヘッダーを貼り付けるか、.eml または Outlook の .msg ファイル全体をドロップするだけで、ESHA はメッセージが実際にどこから来たのかを教えてくれます。SPF、DKIM、DMARC が通過したかどうか、送信者と一致しない識別情報はどれか、どのようなフィッシングやなりすましの兆候が見られるかを示します。分析は完全にあなたのマシン上で実行され、第三者サービスに接続することはありません。
不審なメールをトリアージする SOC アナリスト、インシデント対応担当者、IT 管理者向けに構築されています。ESHA は @lnxg33k によるオープンソースの MHA (E-Mail Header Analyzer) から始まり、その後、分析エンジン、インターフェース、API、コマンドラインが書き直されました。
認証と不一致
compauth) の判定結果を、受信サーバーの Authentication-Results、またはそれが欠けている場合は Received-SPF と DKIM-Signature から取得p=none DMARC ポリシー、矛盾する SPF 結果、送信者によって挿入された偽の Authentication-Results ヘッダーl= ボディ長タグを使用している署名、署名対象ヘッダーが少なすぎる署名送信者の識別情報
paypa1)、ホモグリフやキリル文字・ギリシャ文字の混同文字 (раураl)、punycode、他のドメインに埋め込まれたブランド名acmecorp-hr.com 対 acme-corp.com)。請求書や給与の詐欺に典型的経路
コンテンツ(本文が含まれる場合)
javascript:およびdata:リンクinvoice.pdf.html)、内容がファイル名と一致しないファイルatob、Blob、msSaveOrOpenBlob、大きなbase64データ).ics)。そのリンクはリンクテーブルに追加されますOutlook .msgファイル: 受信メッセージは元のインターネットヘッダーを保持しているため、添付ファイルや埋め込みメッセージを含め、.emlとまったく同じように分析されます。送信済みアイテムや下書きから保存されたメッセージにはトランスポートヘッダーがないため、ESHAはOutlookのプロパティからFrom、To、Subject、Dateを再構築し、経路を確認できないことを示します。RTFのみで保存された本文はデコードされません。
スパムフィルター: Microsoft 365(SCL、BCL、SFV、SPOOFやPHSHなどのCAT)およびSpamAssassinの判定。
インジケーターとエクスポート
to_ids属性になるため、無害なメールサービスが悪意あるものとしてマークされることはありません。すべての結果は0〜100のリスクスコアに統合されます。各検出項目には平易な言葉での説明、対処方法のアドバイス、およびそのMITRE ATT&CKテクニックが付きます。レポートはタブに分かれています: Findings、Route、Authentication、Links & attachments(メッセージ本文が含まれる場合)、All headers。スコアはヒューリスティックです。証明ではなくトリアージとして扱ってください。
ESHAはGitHub Pages上の静的サイトとして公開されています: https://0xanalyst.github.io/email-security-header-analyzer/
ホスト版は、Pyodide(WebAssembly)を使用してブラウザタブ内で同じPythonアナライザーを実行します。開いたヘッダーや.emlファイルがアップロードされることはありません。GitHubはページのファイルを配信するだけで、メールの内容を見ることはありません。ページのContent Security Policy(connect-src 'self')により他のサーバーへの接続がブロックされ、PyodideはCDNからではなくサイトとともにホストされています。初回訪問時は約14 MB(圧縮後はより少ない)をダウンロードし、その後ブラウザがキャッシュします。
静的サイトを自分でビルドしてプレビューするには:
pip install -r requirements.txt
python scripts/build_site.py # writes ./site
python -m http.server -d site 8000 # http://127.0.0.1:8000
node scripts/check_site.js site tests/samples # optional smoke test of the in-browser engine
main へのプッシュごとにサイトが再ビルドされデプロイされます(.github/workflows/pages.yml)。
Python 3.9 以降が必要です。
macOS: Finder で Start ESHA.command をダブルクリックするか、ターミナルで ./run.sh を実行します。macOS がファイルを検証できないと表示した場合は、ファイルを右クリックして Open を選択してください。ポート 8080 が使用中の場合(Burp Suite がデフォルトで使用します)、ESHA は次に空いているポートを選択して表示します。
Linux
./run.sh
Windows: run.bat をダブルクリックします。
このスクリプトは仮想環境を作成し、依存関係をインストールして、ブラウザで http://127.0.0.1:8080 を開きます。停止するには Ctrl+C を押します。
手動で
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m esha --open # options: -b 0.0.0.0 -p 9000
Docker
docker compose up -d # http://127.0.0.1:8080
イメージは、非rootユーザーとしてgunicornを実行し、読み取り専用ファイルシステムとヘルスチェックを備えています。
python -m esha analyze message.eml # colour report in the terminal
python -m esha analyze message.msg # Outlook .msg works the same way
python -m esha analyze message.eml --json # full JSON report
pbpaste | python -m esha analyze - # headers from the clipboard (macOS)
その他の形式は、標準出力または -o を指定してファイルに出力します:
python -m esha analyze message.eml -f html -o report.html # self-contained report for a ticket
python -m esha analyze message.eml -f csv # indicators as CSV
python -m esha analyze message.eml -f stix -o bundle.json # STIX 2.1 bundle
python -m esha analyze message.eml -f misp -o event.json # MISP event
python -m esha analyze message.eml -f iocs # indicators as JSON
analyze は判定が高リスクの場合に終了コード 2 で終了するため、スクリプト内で使用できます。--json は元の動作を維持し、常に 0 で終了します。
curl -s localhost:8080/api/analyze -H 'Content-Type: application/json' -d '{"headers": "..."}'
curl -s localhost:8080/api/analyze -F [email protected]
curl -s localhost:8080/api/analyze -H 'Content-Type: message/rfc822' --data-binary @message.eml
curl -s localhost:8080/api/analyze -F [email protected]
curl -s localhost:8080/api/analyze -H 'Content-Type: application/vnd.ms-outlook' --data-binary @message.msg
curl -s localhost:8080/api/health
# other formats: csv, iocs, stix, misp, html
curl -s 'localhost:8080/api/analyze?format=stix' -F [email protected] -o bundle.json
curl -s localhost:8080/api/export -H 'Content-Type: application/json' -d '{"report": {...}, "format": "misp"}'
レポートはメジャーバージョン内でのみフィールドが追加されます(CHANGELOG.md を参照)。レスポンスには iocs、score、findings(各要素に rule_id、severity、title、detail、category、weight、description、remediation、attack を含む)、auth(alignment テーブルを含む)、hops、origin、content(リンクと添付ファイル)、spam、summary、およびデコードされた headers が含まれます。