ParkerLee07/NetSniper

GitHub: ParkerLee07/NetSniper

基于 Bash 的网络侦察引擎,执行主机发现、服务枚举和暴露评分,并生成结构化 JSON 与不可变遥测数据包供授权安全评估使用。

Stars: 2 | Forks: 0

# NetSniper **用于授权安全评估的网络侦察和暴露情报传感器。** NetSniper 是一个基于 Bash 的网络发现和服务枚举 pipeline。它执行主机发现,扫描一组精选的安全相关 TCP 端口,对可能的设备类型进行分类,对暴露的服务进行评分,并为下游工具写入结构化分析文件。 NetSniper 也是 **DeltaAegis** 的主动网络传感器。每次完成完整的 pipeline 运行都会创建一个不可变的遥测数据包,其中包含原始 Nmap XML、发现证据、邻居表丰富信息、解释的发现结果以及版本化清单。 ## 功能 - 使用 Nmap 进行本地子网主机发现。 - 精选的 TCP 服务扫描,与 TrueAegis 验证工作流保持一致。 - 设备分类和暴露评分。 - 用于自动化的结构化 JSON 分析输出。 - 可选的 Greenbone 集成,用于更深入的评估。 - 用于 DeltaAegis 的不可变 `netsniper-run-v2` 遥测数据包。 - 精确的受监控端口配置指纹识别,以防止在扫描配置更改后出现错误的历史差异。 - 归档的发现 XML 和邻居表遥测,用于基于 MAC 的身份关联。 ## 环境要求 ``` sudo apt update sudo apt install nmap jq -y ``` 可选的 Greenbone 集成需要配置好的 GVM 安装环境和 `gvm-cli`。 ## 安装说明 ``` git clone https://github.com/ParkerLee07/NetSniper.git cd NetSniper chmod +x netsniper.sh ./netsniper.sh ``` ## Pipeline ``` Discovery ↓ Curated service scan ↓ Relevant-host extraction ↓ Exposure analysis ↓ Report generation ↓ Immutable DeltaAegis telemetry bundle ``` ## 运行时输出 运行时输出被有意排除在 Git 之外。 ``` ~/NetSniper/ ├── discovery/ # latest discovery evidence ├── scans/ # latest service-scan evidence ├── targets/ # latest analysis files ├── reports/ # generated reports ├── runs/ # immutable DeltaAegis telemetry bundles └── config/ # local runtime configuration ``` 最终确定的 `runs//manifest.json` 文件标志着遥测数据包已准备好供下游摄取。 ## DeltaAegis 遥测契约 当前不可变的数据包使用: ``` netsniper-run-v2 ``` 版本化清单记录: - 精确的受监控 TCP 端口。 - SHA-256 扫描配置指纹。 - NetSniper 和 Nmap 版本。 - 目标子网。 - 发现接口。 - 扫描时间戳和主机计数。 - 归档的发现 XML、服务 XML、发现结果 JSON 和邻居遥测的路径。 请参阅 [`Docs/deltaaegis-integration.md`](Docs/deltaaegis-integration.md)。 ## 范围与限制 NetSniper 是一个专用的传感器,不是完整的 SIEM,也不是漏洞利用框架。它报告其配置的 TCP 配置文件的观察结果。它并不主张扫描所有可能的 TCP 或 UDP 端口。 ## 仅限授权使用 提供 NetSniper 旨在用于教育目的和授权的安全测试。仅在您获得明确许可的系统和网络上使用它。 ## 许可证 MIT 许可证。请参阅 [`LICENSE`](LICENSE)。
标签:Bash, CTI, Facebook API, GraphQL引擎检测, Greenbone, Nmap, 应用安全, 插件系统, 网络安全, 虚拟驱动器, 设备指纹, 隐私保护