PhishDetector

PhishDetector là một prototype phát hiện email phishing theo hướng module hóa, nhằm dễ mở rộng theo từng phiên bản: v1.0 cho phân tích email cơ bản, v2.0 cho AI và tích hợp bên ngoài.

Mục tiêu

• Parse file .eml
• Phân tích header, SPF, DKIM, DMARC
• Kiểm tra URL và attachment
• Tính toán risk score
• Xuất HTML/JSON report
• Dễ mở rộng sang module AI, API, dashboard web sau này

Cấu trúc đề xuất

PhishDetector/
├── parser/
├── analyzer/
├── ai/
├── scorer/
├── report/
├── api/
├── web/
├── utils/
└── app.py

Phiên bản

v1.0

• Parse .eml
• SPF
• DKIM
• DMARC
• Header Analysis
• URL Analysis
• Attachment Analysis
• Entropy
• Risk Score
• HTML Report

v2.0

• AI Summary
• AI Recommendation
• VirusTotal
• URLhaus
• OpenPhish
• AbuseIPDB
• IOC Extraction

Thực thi nhanh

python app.py

Thành phần hiện có

• parser/email_parser.py: đọc file .eml, chuyển thành EmailData
• analyzer/header_analyzer.py: phân tích header và chuỗi Received
• analyzer/spf_checker.py: đánh giá SPF
• analyzer/dkim_checker.py: đánh giá DKIM
• analyzer/dmarc_checker.py: đánh giá DMARC
• analyzer/url_analyzer.py: kiểm tra URL lạ, shortener, IP URL
• analyzer/attachment_analyzer.py: kiểm tra attachment đáng ngờ
• analyzer/entropy_analyzer.py: đo entropy để phát hiện chuỗi ngẫu nhiên
• scorer/risk_engine.py: cộng điểm và sinh risk score
• report/html_report.py: xuất report HTML
• api/rest_api.py: API skeleton cho POST /scan

Ghi chú

• AI package hiện chưa triển khai logic thực tế, chỉ để dành cho phiên bản v2.0.
• Mỗi hàm đã có comment ngắn ở đầu hàm theo hướng dễ đọc và dễ mở rộng. "