研发安全左移落地指南,把安全扫描内建进极狐GitLab流水线

极狐GitLab
2026年11月16日
10520
分享:

研发安全左移落地指南,把安全扫描内建进极狐GitLab流水线

安全左移:在编码与合并等早期环节引入自动化安全检测,让漏洞在进入默认分支前被发现和修复,而非等到上线后再打补丁。

一笔先算清楚的账:为什么左移

漏洞修复成本随发现阶段后移而陡增,这不是口号,而是流水线结构的必然结果。问题在功能分支上被发现,改几行代码、加一次提交就能收尾;等到默认分支甚至生产环境才暴露,牵扯的就是回滚窗口、紧急发版和跨团队协调。极狐GitLab 官方文档对应用安全测试的定位也印证了这一点:安全发现会直接显示在合并请求中,在代码合并前通知开发者,这种主动方式可降低在开发后期修复问题的成本和工作量。

左移的关键不是"多跑几个扫描器",而是把检测点放在合并请求这道门禁上——所有代码进入主干前必经的地方。下面按官方文档逐项拆解怎么落。

三道内建扫描,各管一段

极狐GitLab 在流水线中内建了多种安全扫描能力,与安全左移直接相关的核心三件套如下:

扫描能力

管什么

流水线模板

可用版本

SAST(静态应用安全测试)

源代码自身缺陷(注入、反模式等)

Jobs/SAST.gitlab-ci.yml

基础/专业/旗舰版

密钥检测

提交中的令牌、私钥等静态凭据

Jobs/Secret-Detection.gitlab-ci.yml

基础/专业/旗舰版

依赖扫描

第三方依赖中的已知漏洞

Jobs/Dependency-Scanning.gitlab-ci.yml

旗舰版

三点官方语义边界需要先说清,避免配置时踩坑:

  1. SAST 默认只在分支流水线运行,不在合并请求流水线运行,需要额外配置才会随 MR 触发——不少团队"配了却没扫",根因就在这里(见 SAST 官方文档)。

  2. 依赖扫描已转向 SBOM 路线。基于 Gemnasium 分析器的依赖扫描在极狐GitLab 17.9 中已弃用、计划在 20.0 中移除,官方推荐新项目使用"使用 SBOM 的依赖扫描"(分析器在流水线中生成 CycloneDX SBOM 产物,再与安全公告数据库比对)(见依赖扫描官方文档)。

  3. 密钥检测要按多层防护启用。官方文档明确建议启用所有可用方式:密钥推送保护在推送时直接阻止含密钥的提交;流水线密钥检测扫描默认分支及合并请求流水线中开发分支的提交;客户端密钥检测则扫描议题与合并请求的描述和评论。

落地第一步:在 .gitlab-ci.yml 里内建扫描

三个模板一次 include,配合排除路径变量,最小可用配置如下:

include:
  - template: Jobs/SAST.gitlab-ci.yml
  - template: Jobs/Secret-Detection.gitlab-ci.yml
  - template: Jobs/Dependency-Scanning.gitlab-ci.yml

variables:
  # 测试脚手架、示例目录不参与扫描
  SAST_EXCLUDED_PATHS: "spec, test, e2e"
  # 旗舰版可启用 Advanced SAST(taint 分析,降低误报)
  GITLAB_ADVANCED_SAST_ENABLED: "true"

几个参数的选型逻辑:

  • SAST_EXCLUDED_PATHS 支持逗号分隔的 glob 路径,用于把非生产代码挡在扫描之外,减少噪声;

  • SAST 前提条件是 .gitlab-ci.yml 包含 test 阶段,且需要基于 Linux 的 Runner(Docker/Kubernetes 执行器),Windows Runner 不受支持;

  • 旗舰版用户也可在安全 > 安全配置页面一键启用 SAST,不必手写 YAML。

落地第二步:给合并请求装上安全门禁

扫描只报数不管卡,左移就少了牙齿。极狐GitLab 旗舰版的合并请求审批策略通过 scan_finding 规则,可以按严重级别对新增漏洞强制审批,未获批无法合并:

approval_policy:
- name: block critical findings
  description: 高危漏洞合并前必须安全审批
  enabled: true
  rules:
  - type: scan_finding
    branches:
    - main
    scanners:
    - sast
    - secret_detection
    - dependency_scanning
    vulnerabilities_allowed: 0
    severity_levels:
    - critical
    - high
    vulnerability_states:
    - new_needs_triage
  actions:
  - type: require_approval
    approvals_required: 1

官方文档里几个门禁细节值得记住:severity_levels 可取 info 到 critical 六级;vulnerability_states 留空数组等价于同时评估新发现的"待分诊"与"已忽略"两类;规则默认 fallback_behavior: fail: closed——规则评估不了时也要求审批,宁可多拦不会漏放。策略通过安全策略项目管理,开发团队无法绕过或修改,这正是职责分离的官方设计。想先观察一段时间再收紧,可配合警告模式试运行,机器人只留评论不阻断。

落地五步清单

按官方文档能力拼装,一个可复制的推进路径:

  1. 在目标项目的 .gitlab-ci.yml 中 include 三个扫描模板,确认流水线出现 test 阶段的安全作业;

  2. 开启密钥推送保护,把凭据拦截在推送环节,而不是等流水线报漏洞;

  3. 在合并请求中查看安全部件:官方文档说明,发现先在功能分支生成,合并到默认分支后才成为"漏洞",MR 里展示的是新增或已解决的发现;

  4. 配置合并请求审批策略,从 critical 单一级别起步,稳定后再纳入 high;

  5. 用漏洞报告管理存量:新代码靠门禁挡,历史漏洞按优先级排期修复,避免门禁被存量噪声冲垮。

常见疑问

Q1:SAST 配了为什么合并请求里看不到结果?

先确认两点:一是 SAST 默认只在分支流水线运行,合并请求流水线需要单独配置;二是同一流水线中任一安全作业失败,安全仪表板就不会显示结果,需先排掉失败作业。另外只有合并到默认分支后,发现才会进入漏洞报告。

Q2:还在用 Gemnasium 那套依赖扫描,要紧吗?

要规划迁移了。官方文档明确:基于 Gemnasium 的依赖扫描在 17.9 已弃用、20.0 移除,官方提供了迁移指南,方向是 SBOM 依赖扫描与持续依赖扫描——后者在公告库更新时自动重扫最近一次成功流水线的 SBOM,新披露漏洞无需重跑流水线即可显现。

Q3:误报太多会不会把门禁变成摆设?

三个抓手:SAST_EXCLUDED_PATHS 排除非生产路径;.gitlab/sast-ruleset.toml 可按规则 ID 禁用特定规则;旗舰版配合极狐GitLab Duo 附加组件可自动分析误报并给出置信度评分,Agentic 漏洞解决还能生成带修复代码的合并请求。审批策略侧则可用 vulnerability_attributes 过滤误报后强制审批。


安全左移不是买一个扫描器,而是把检测、门禁、审批串成一条开发团队绕不过去的流水线。极狐GitLab 的 SAST、密钥检测、依赖扫描与合并请求审批策略已经把这四个环节做成开箱即用的模板,缺的只是落地那一步。现在就可以预约演示,或直接进入极狐GitLab 文档中心动手体验;想评估 Advanced SAST 与 Duo 误报检测的实际效果,联系极狐GitLab获取试用方案。