Shannon
KeygraphHQ/shannon • TypeScript • AGPL-3.0
Shannon là tác nhân AI pentest tự động, kết hợp phân tích mã nguồn và khai thác thực tế để xác thực lỗ hổng bảo mật trên ứng dụng web và API trước khi triển khai.
Khuyến Cáo An Toàn: Cần Kiểm Thử Môi Trường Lab
Công cụ yêu cầu quyền truy cập mã nguồn và thực thi các payload khai thác. Cần rà soát kỹ các dependencies của Node.js và đảm bảo môi trường chạy (Docker container) được cô lập hoàn toàn để tránh rò rỉ dữ liệu hoặc thực thi mã độc hại từ các model AI bên thứ ba.
Cài đặt nhanh, Docker/Helm sẵn có, tài liệu mẫu đầy đủ
Tiết kiệm RAM/CPU khi quét lớn, tốc độ xử lý song song
Độ chính xác cao, ít false positive, tính năng mở rộng tốt
Bản vá CVE thường xuyên, cộng đồng bảo mật hỗ trợ tích cực
- •Mã nguồn mở minh bạch
- •Cộng đồng kiểm nghiệm rộng rãi
- •Tối ưu hóa hiệu năng tốt
- •Cần kiểm thử trước khi cấp quyền trên hệ thống Production
1. Tổng Quan Kiến Trúc & Cơ Chế Hoạt Động#
Shannon hoạt động như một tác nhân AI (Agentic AI) thực hiện quy trình pentest theo 5 giai đoạn:
- Recon & Analysis: Khám phá ứng dụng, ánh xạ luồng dữ liệu và các điểm tiếp xúc (API/Forms).
- Code Analysis: Phân tích mã nguồn để tìm các 'ứng viên' lỗ hổng (Injection, XSS, SSRF).
- Reconciliation: Hợp nhất kết quả từ phân tích tĩnh và động để xây dựng hàng đợi khai thác.
- Exploitation: Sử dụng các agent chuyên biệt để thực hiện tấn công thực tế (Proof-of-Concept).
- Validation & Reporting: Chỉ báo cáo các lỗ hổng đã được xác thực thành công qua PoC, xuất báo cáo dưới dạng PDF, Markdown và SARIF.
2. Ma Trận Đánh Giá & Điểm Khác Biệt#
So với các công cụ quét truyền thống (DAST), Shannon vượt trội ở khả năng 'hiểu' mã nguồn (Context-aware). Trong khi các công cụ như Nessus hay Burp Suite thường tạo ra nhiều cảnh báo giả (False Positives), Shannon chỉ báo cáo khi đã thực thi thành công payload, giúp giảm tải đáng kể cho đội ngũ Security Engineer.
3. Hướng Dẫn Cài Đặt & Cấu Hình Chi Tiết#
- Cài đặt môi trường: Đảm bảo Docker và Node.js 18+ đã được cài đặt.
- Setup: Chạy
npx @keygraph/shannon@latest setupđể cấu hình API Key cho AI Provider (Anthropic/OpenAI). - Cấu hình: Tạo file
config.yamlđể định nghĩa phạm vi (Scope) và các quy tắc tham gia (Rules of Engagement).
4. Bảng Tra Cứu Tham Số & Flags Trọng Yếu#
-u, --url: URL của ứng dụng mục tiêu.-r, --repo: Đường dẫn đến thư mục mã nguồn.--models-config: Đường dẫn đến file cấu hình model tùy chỉnh (cho local LLMs).--fail-on-severity: Thiết lập ngưỡng severity để fail pipeline CI/CD.
5. Kịch Bản Thực Chiến#
- Kịch bản 1 (CI/CD): Tích hợp vào GitHub Actions để tự động quét staging environment mỗi khi có Pull Request. Sử dụng flag
--fail-on-severity highđể chặn merge nếu phát hiện lỗ hổng nghiêm trọng. - Kịch bản 2 (Threat Hunting): Chạy Shannon trên môi trường local để kiểm tra các endpoint API mới phát triển, tập trung vào các lỗ hổng Broken Authorization.
6. Khuyến Nghị Tối Ưu & Phòng Ngừa Rủi Ro#
- Sandboxing: Luôn chạy Shannon trong môi trường cô lập (Staging/Dev). Không bao giờ chạy trên Production.
- Data Privacy: Sử dụng các model local (Ollama/vLLM) nếu chính sách công ty không cho phép gửi mã nguồn lên cloud provider.
- Supply Chain: Kiểm tra định kỳ các container image của Shannon để đảm bảo không có lỗ hổng trong các thư viện phụ thuộc.
Công Cụ Cùng Chuyên Mục red_team
Strix là nền tảng kiểm thử xâm nhập tự động dựa trên AI, sử dụng các tác nhân (agents) để thực hiện quét lỗ hổng, khai thác thực tế (PoC) và đề xuất bản vá cho ứng dụng.
Nuclei là công cụ quét lỗ hổng bảo mật hiệu năng cao, sử dụng ngôn ngữ YAML DSL tùy biến, hỗ trợ đa giao thức và tích hợp CI/CD để phát hiện lỗ hổng thực tế với tỉ lệ dương tính giả cực thấp.
PentAGI là hệ thống tác nhân AI tự hành chuyên biệt cho kiểm thử xâm nhập, tích hợp đa tác nhân, bộ nhớ vector và khả năng giám sát thực thi trong môi trường Docker cô lập.