pcfens/sast-parser

sast-parser

概述

sast-parser 是一个简单工具，旨在帮助简化 GitLab SAST 报告的理解过程，通过命令行方式解析报告文件并支持结果筛选，提升 SAST 报告分析效率。

核心功能与特性

• GitLab SAST 报告解析：专门针对 GitLab SAST 生成的报告文件进行解析
• 结果筛选：支持通过严重级别（--only-severities）和 JSONPath 表达式（--jsonpath-filter）筛选报告结果
• 便捷部署：提供 Docker 镜像形式，无需复杂环境配置即可快速使用

使用场景与适用范围

适用于开发人员、安全审计人员在进行代码安全扫描后，需要快速分析和理解 GitLab SAST 报告内容的场景，尤其适合需要针对性筛选特定严重级别或条件漏洞的场景。

使用方法与配置说明

Docker 运行方式

基本命令格式

bash
docker run --rm -it -v "$(pwd):/reports" sast-parser [-h] [--only-severities ONLY_SEVERITIES] [--jsonpath-filter JSONPATH_FILTER] files [files ...]

参数说明

• -h：显示帮助信息
• --only-severities ONLY_SEVERITIES：指定仅显示特定严重级别的结果（如：critical,high）
• --jsonpath-filter JSONPATH_FILTER：使用 JSONPath 表达式筛选报告结果
• files [files ...]：需要解析的 GitLab SAST 报告文件路径（相对于当前挂载目录）

创建别名（可选）

为简化命令，可创建别名：

bash
alias sast-parser="docker run --rm -it -v \"$(pwd):/reports\" sast-parser"

创建后可直接使用 sast-parser 命令调用，例如：

bash
sast-parser --only-severities critical,high report.json

注意事项

• 运行时需将当前工作目录挂载至容器内 /reports 目录，确保工具可访问报告文件
• 报告文件路径需相对于挂载的当前目录进行指定