
SPF/DKIM/DMARC, 스푸핑 및 피싱을 위한 이메일 헤더 및 .eml 분석기입니다. 100% 브라우저에서 실행되므로 이메일이 업로드되지 않습니다.
[!IMPORTANT] 귀하의 이메일은 절대 기기를 떠나지 않습니다. 호스팅 버전은 WebAssembly를 사용하여 전체 분석기를 브라우저 탭 안에서 실행합니다. ESHA 서버는 존재하지 않습니다. 열어본 헤더와
.eml파일은 업로드, 저장 또는 공유되지 않으며, GitHub나 ESHA 프로젝트와도 공유되지 않습니다.
- 업로드 없음: 분석은 페이지 내 백그라운드 워커에서 로컬로 실행됩니다.
- 제3자 없음: CDN, 분석 도구, 트래커, DNS 또는 평판 조회가 없습니다.
- 브라우저에 의해 강제됨: 페이지의 콘텐츠 보안 정책(
connect-src 'self')이 다른 서버와의 통신을 차단합니다.- 검증 가능: 브라우저의 DevTools를 열고 Network로 이동하여 메시지를 분석하면, 해당 메시지를 전송하는 요청이 없음을 확인할 수 있습니다.
따라서 동료의 피싱 신고나 사고 증거와 같은 민감하거나 기밀 메시지에 적합합니다.
이메일의 헤더를 붙여넣거나 전체 .eml 또는 Outlook .msg 파일을 드롭하면, ESHA가 메시지가 실제로 어디에서 왔는지 알려줍니다. SPF, DKIM, DMARC 통과 여부, 발신자와 일치하지 않는 신원, 그리고 피싱이나 스푸핑의 징후를 보여줍니다. 분석은 전적으로 귀하의 기기에서 실행되며 제3자 서비스에 접속하지 않습니다.
의심스러운 이메일을 분류하는 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), 퓨니코드, 다른 도메인에 포함된 브랜드 이름acmecorp-hr.com vs acme-corp.com)으로, 인보이스 및 급여 사기에서 전형적입니다경로
콘텐츠 (본문이 포함된 경우)
javascript: 및 data: 링크invoice.pdf.html), 그리고 내용이 이름과 일치하지 않는 파일atob, Blob, msSaveOrOpenBlob, 대용량 base64 데이터).ics), 해당 링크는 링크 테이블에 추가됨Outlook .msg 파일: 수신된 메시지는 원래 인터넷 헤더를 유지하므로 첨부 파일 및 포함된 메시지를 포함하여 .eml과 정확히 동일하게 분석됩니다. 보낸 편지함 또는 임시 보관함에서 저장된 메시지는 전송 헤더가 없으므로 ESHA는 Outlook 속성에서 보낸 사람, 받는 사람, 제목 및 날짜를 재구성하고 경로를 확인할 수 없다고 표시합니다. RTF로만 저장된 본문은 디코딩되지 않습니다.
스팸 필터: Microsoft 365 (SCL, BCL, SFV, SPOOF 또는 PHSH와 같은 CAT) 및 SpamAssassin 판정.
지표 및 내보내기
to_ids 속성이 되므로 무해한 메일 서비스가 악성으로 표시되지 않습니다.모든 결과는 0–100 위험 점수로 결합됩니다. 각 발견 사항에는 평이한 설명, 수행할 조치에 대한 조언 및 해당 MITRE ATT&CK 기법이 있습니다. 보고서는 발견 사항, 경로, 인증, 링크 및 첨부 파일 (메시지 본문이 포함된 경우) 및 모든 헤더 탭으로 나뉩니다. 점수는 휴리스틱이므로 증거가 아닌 분류로 취급하십시오.
ESHA는 GitHub Pages에 정적 사이트로 게시됩니다: https://0xanalyst.github.io/email-security-header-analyzer/
호스팅 버전은 Pyodide (WebAssembly)를 사용하여 브라우저 탭 내에서 동일한 Python 분석기를 실행합니다. 열어보는 헤더와 .eml 파일은 절대 업로드되지 않습니다. GitHub는 페이지의 파일을 제공하며 이메일 콘텐츠를 볼 수 없습니다. 페이지의 콘텐츠 보안 정책 (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를 더블클릭하거나, Terminal에서 ./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
이미지는 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가 포함됩니다.