ST10476385/Web-Application-Vulnerability-Scanner
GitHub: ST10476385/Web-Application-Vulnerability-Scanner
SecuriX 是一款基于 React 的 Web 应用漏洞扫描器,通过可视化仪表板和详细报告帮助开发人员与安全团队快速发现 XSS、SQL 注入等常见 Web 安全漏洞。
Stars: 0 | Forks: 0
# SecuriX - Web 应用漏洞扫描器
## 概述
**SecuriX** 是一款使用现代 Web 技术构建的综合 Web 应用漏洞扫描器。这款强大的工具允许用户扫描 Web 应用程序以查找安全漏洞,提供包含严重性分类和可行建议的详细报告。SecuriX 由 Khanyisa Ntsako Shikwambana 开发,将先进的扫描算法与直观的用户界面相结合,使开发人员、安全专业人员和组织都能轻松进行 Web 安全评估。
## 作者
**Khanyisa Ntsako Shikwambana** - 全栈开发者 & 安全爱好者
## 功能特性
### 高级漏洞扫描
- **多类型扫描**:可在完整应用程序扫描和针对特定漏洞的定向扫描之间选择
- **实时进度跟踪**:通过实时更新和预计完成时间监控扫描进度
- **全面覆盖**:检测多种类型的 Web 漏洞,包括 XSS、SQL 注入、CSRF 等
### 智能仪表板
- **可视化分析**:交互式图表展示按严重性分类的漏洞分布
- **扫描统计**:总扫描次数、发现漏洞数和风险评估概览
- **近期活动**:快速访问最新的扫描结果和趋势
### 详细报告
- **严重性分类**:漏洞被划分为高、中、低和信息性四个级别
- **可行建议**:每个漏洞都包含详细描述、影响评估和修复步骤
- **导出功能**:生成包含扫描摘要和漏洞详情的 PDF 报告
### 扫描历史管理
- **持久化存储**:所有扫描结果均被安全存储,以供将来参考
- **搜索与过滤**:轻松按 URL、日期或漏洞类型查找过往扫描
- **删除管理**:在保持数据完整性的同时清理旧扫描
### 现代化用户界面
- **响应式设计**:针对桌面和移动设备进行了优化
- **深色/浅色主题**:根据系统偏好自动切换主题
- **直观导航**:干净、专业的界面配合流畅的动画效果
### 开发者友好功能
- **RESTful API 集成**:基于健壮的后端 API 构建,确保可靠的数据处理
- **实时更新**:使用 React Query 实现实时数据同步
- **模块化架构**:结构良好的代码库,易于维护和扩展
## 技术栈
### 前端
- **React 18** - 用于构建用户界面的现代 JavaScript 库
- **Vite** - 快速的构建工具和开发服务器
- **Tailwind CSS** - 实用优先的 CSS 框架,用于快速样式开发
- **shadcn/ui** - 基于 Radix UI 构建的高质量、无障碍 UI 组件
- **React Router** - 用于 React 应用的声明式路由
- **React Query (TanStack Query)** - React 的强大数据同步工具
- **Framer Motion** - 生产就绪的 React 动效库
- **React Hook Form** - 具有简便验证功能的高性能表单
- **Zod** - TypeScript 优先的 schema 验证
- **Lucide React** - 美观且一致的图标工具包
### 后端集成
- **Khanyisa SDK** - 定制构建的 SDK,用于安全的 API 通信和数据管理
- **Axios** - 基于 Promise 的 HTTP 客户端,用于 API 请求
### 开发工具
- **ESLint** - JavaScript 和 JSX 的可插拔代码检查工具
- **TypeScript** - JavaScript 的类型化超集,提供更好的开发体验
- **PostCSS** - 使用 JavaScript 转换 CSS 的工具
- **Autoprefixer** - 用于解析 CSS 并添加供应商前缀的 PostCSS 插件
## 前置条件
在运行 SecuriX 之前,请确保您已安装以下软件:
- **Node.js**(18.0.0 或更高版本)
- **npm**(随 Node.js 附带)或 **yarn**(可选)
- **Git**(用于克隆仓库)
- **现代 Web 浏览器**(Chrome、Firefox、Safari 或 Edge)
## 安装
请按照以下步骤在您的本地计算机上设置 SecuriX:
### 1. 克隆仓库
```
git clone https://github.com/your-username/securix-scanner.git
cd securix-scanner
```
### 2. 安装依赖
```
npm install
```
### 3. 环境配置(可选)
如果您需要配置自定义环境变量,请在根目录创建一个 `.env.local` 文件:
```
# 示例环境变量(如适用)
VITE_APP_TITLE=SecuriX Scanner
VITE_API_BASE_URL=https://your-api-endpoint.com
```
### 4. 启动开发服务器
```
npm run dev
```
应用程序将在 `http://localhost:5173` 上可用
## 使用说明
### 入门指南
1. **启动应用程序**:打开浏览器并导航至 `http://localhost:5173`
2. **熟悉界面**:了解仪表板和导航功能
3. **执行首次扫描**:点击导航菜单中的“Scanner”
### 执行漏洞扫描
1. **导航至扫描器**:点击主导航栏中的“Scanner”选项卡
2. **输入目标 URL**:输入您要扫描的 Web 应用程序的 URL
3. **选择扫描类型**:
- **完整扫描**:对整个应用程序进行综合分析
- **特定扫描**:针对特定漏洞类型的定向扫描
4. **接受条款**:在继续之前阅读并接受免责声明
5. **开始扫描**:点击“Start Scan”按钮开始分析
6. **监控进度**:观察实时进度指示器
7. **查看结果**:检查详细的漏洞报告
### 理解扫描结果
- **严重性级别**:
- 🔴 **高**:需要立即关注的关键漏洞
- 🟡 **中**:应予以解决的重要问题
- 🔵 **低**:影响有限的轻微问题
- ℹ️ **信息**:供参考的信息性发现
- **漏洞详情**:每个发现包括:
- 漏洞描述
- 潜在影响和利用方法
- 修复建议
- 代码示例(如适用)
### 管理扫描历史
1. **访问历史**:点击“History”选项卡
2. **搜索扫描**:使用搜索栏按 URL 查找特定扫描
3. **查看详情**:点击任意扫描以查看完整结果
4. **删除扫描**:使用删除按钮移除旧扫描
### 仪表板分析
- **概览指标**:总扫描次数、发现漏洞数、平均严重性
- **图表与图形**:漏洞趋势的可视化展示
- **近期扫描**:快速访问最新的扫描活动
## 项目结构
```
SecuriX/
├── public/ # Static assets
│ ├── manifest.json # Web app manifest
│ └── favicon files # App icons
├── src/
│ ├── api/ # API integration layer
│ │ └── khanyisaClient.js # Main API client
│ ├── components/ # Reusable UI components
│ │ ├── ui/ # shadcn/ui components
│ │ ├── home/ # Homepage components
│ │ ├── scanner/ # Scanner-related components
│ │ ├── dashboard/ # Dashboard components
│ │ └── layout/ # Layout components
│ ├── hooks/ # Custom React hooks
│ ├── lib/ # Utility functions and configurations
│ ├── pages/ # Main application pages
│ │ ├── Home.jsx # Landing page
│ │ ├── Scanner.jsx # Scan interface
│ │ ├── Dashboard.jsx # Analytics dashboard
│ │ └── History.jsx # Scan history
│ ├── utils/ # Helper functions
│ ├── App.jsx # Main app component
│ └── main.jsx # Application entry point
├── index.html # HTML template
├── package.json # Dependencies and scripts
├── vite.config.js # Vite configuration
├── tailwind.config.js # Tailwind CSS configuration
├── jsconfig.json # JavaScript project configuration
├── eslint.config.js # ESLint configuration
└── README.md # Project documentation
```
## 🔧 可用脚本
- `npm run dev` - 启动开发服务器
- `npm run build` - 构建生产环境应用程序
- `npm run preview` - 在本地预览生产环境构建
- `npm run lint` - 运行 ESLint 进行代码质量检查
- `npm run lint:fix` - 自动修复代码规范问题
- `npm run typecheck` - 运行 TypeScript 类型检查
## 许可证
本项目基于 MIT 许可证授权 - 详见 [LICENSE](LICENSE) 文件。
## 致谢
- **Khanyisa Ntsako Shikwambana** - 项目创建者和首席开发者
- **开源社区** - 感谢他们提供的优秀工具和库,使本项目得以实现
- **安全研究人员** - 感谢他们对 Web 安全知识所做的贡献
## 支持
如果您遇到任何问题或对 SecuriX 有疑问:
1. 查看 [Issues](https://github.com/your-username/securix-scanner/issues) 页面
2. 创建包含详细信息的新 Issue
3. 联系维护者:Khanyisa Ntsako Shikwambana
## 参考文献
### 安全与漏洞标准
1. **OWASP Top 10** - https://owasp.org/www-project-top-ten/
- Open Web Application Security Project 的十大 Web 应用程序安全风险指南
- 理解常见漏洞(包括 SQL 注入和 XSS)的重要参考
2. **OWASP Web 安全测试指南 (WSTG)** - https://owasp.org/www-project-web-security-testing-guide/
- Web 应用程序安全测试的综合手册
- 提供漏洞评估的方法论和最佳实践
3. **CWE - 常见缺陷枚举** - https://cwe.mitre.org/
- 识别常见软件缺陷的社区标准
- 软件漏洞及其特征的数据库
4. **CVE - 常见漏洞与披露** - https://cve.mitre.org/
- 安全漏洞的公共数据库
- 用于跟踪和理解已知漏洞利用的参考
5. **NIST 网络安全框架** - https://www.nist.gov/cyberframework
- 组织管理网络安全风险的指南
- 用于识别、保护、检测、响应和恢复网络事件的框架
### Web 应用程序安全
6. **NIST Web 应用程序安全指南** - https://csrc.nist.gov/publications/detail/sp/800-95/final
- 安全 Web 应用程序开发指南
- 实施安全编码标准的最佳实践
7. **SQL 注入防御** - https://owasp.org/www-community/attacks/SQL_Injection
- OWASP 关于 SQL 注入攻击和缓解的文档
- 防止数据库级别安全违规的技术
8. **跨站脚本攻击 (XSS) 防御** - https://owasp.org/www-community/attacks/xss/
- OWASP 关于 XSS 攻击和防御机制的指南
- 净化用户输入和输出编码的最佳实践
### 技术与框架文档
9. **React 文档** - https://react.dev/
- React 18 的官方文档
- 构建现代用户界面的最佳实践
10. **Vite 文档** - https://vitejs.dev/
- Vite 构建工具和开发服务器的官方指南
- 性能优化和配置参考
11. **Tailwind CSS 文档** - https://tailwindcss.com/docs
- 实用优先的 CSS 框架,用于快速 UI 开发
- 组件设计模式和响应式设计
12. **React Query 文档** - https://tanstack.com/query/latest
- TanStack Query 用于数据获取和状态管理
- 缓存、同步和实时更新
13. **React Router 文档** - https://reactrouter.com/
- React 应用程序的声明式路由库
- 导航模式和动态路由
### 质量保证与开发
14. **ESLint 官方文档** - https://eslint.org/docs/latest/
- JavaScript/JSX 检查工具
- 代码质量和一致性标准
15. **TypeScript 手册** - https://www.typescriptlang.org/docs/
- TypeScript 语言文档
- 类型安全和开发最佳实践
16. **Git 最佳实践** - https://git-scm.com/doc
- 版本控制系统文档
- 协作开发工作流
### 附加资源
17. **SANS 最危险的 25 个软件错误** - https://www.sans.org/top25-software-errors/
- SANS Institute 对最危险软件错误的排名
- 真实世界的漏洞分析和影响评估
18. **HackerOne 漏洞数据库** - https://www.hackerone.com/
- 社区驱动的漏洞披露平台
- 真实世界的漏洞示例和案例研究
19. **负责任的披露指南** - https://www.bugcrowd.com/
- 道德漏洞披露的最佳实践
- 负责任安全测试的指南
### 设计与视觉资产
20. **Pinterest 设计灵感** - https://pin.it/2UMbZWkyR
- SecuriX 视觉品牌的设计灵感
- 具有水基设计元素的极简主义工作室美学
**使用的 AI 图像生成提示词:**
```
3D render of a transparent letters made of pure water, with soft ripples
and realistic light refraction. Minimalist studio lighting, white background,
centered composition with high clarity and soft shadows.
```
该提示词用于为 SecuriX 项目生成视觉品牌资产,
创造出一种极简主义的专业美学,
反映了应用程序在漏洞扫描中对清晰度和精确性的关注。
**由 Khanyisa Ntsako Shikwambana 充满爱心地构建**
标签:CISA项目, CSRF检测, DOE合作, PDF导出, SQL注入检测, Web应用漏洞扫描器, XSS检测, 互联网扫描, 反取证, 可视化仪表盘, 安全扫描, 安全报告, 安全评估, 实时进度跟踪, 开源安全工具, 时序注入, 漏洞分类, 现代Web技术, 网络安全, 自定义脚本, 逆向工程平台, 防护与检测, 隐私保护