登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  科技周边 >  业界新闻

OpenSSF Scorecard 的 Pinned-Dependencies 检查怎样判断依赖是否固定

来源:17golang原创

时间:2026-11-20 10:11:46 259浏览 收藏

OpenSSF Scorecard 的 Pinned-Dependencies 检查,核心不是要求仓库里每个依赖都写成同一种格式,而是观察构建和发布路径是否依赖了可以随时间变化的引用。典型对象包括 Dockerfile、Shell 脚本和 GitHub Actions 工作流中的镜像、Action、下载脚本与包管理器依赖。

官方地址:https://scorecard.dev/

看到该项得分偏低时,先定位报告指出的构建文件,再把浮动标签、分支或版本范围改成可复现的版本号、提交 SHA 或镜像 digest。Scorecard 的结果是风险信号,不是对整个项目安全性的最终认证。

Pinned-Dependencies 检查到底看什么

Scorecard 把依赖固定理解为:构建或发布时使用的外部依赖,应该明确落到一个不会随远端默认分支或标签移动的版本。比如 GitHub Actions 使用完整提交 SHA,容器基础镜像使用 digest,下载脚本使用固定版本和校验信息。这样同一份源码在不同时间运行,才更容易得到相同的构建输入。

检查范围有两个重要边界:它主要面向 GitHub 仓库,并重点观察构建、测试和发布路径;它不等于通用漏洞扫描,也不会因为发现一个未固定引用就证明项目一定被攻破。

OpenSSF Scorecard 将构建路径、依赖引用和风险报告连接起来的静态说明图
图1:这是一张静态说明图,展示 Pinned-Dependencies 从构建路径读取依赖引用并形成风险报告的关系,不是实际运行截图。

怎样把报告线索映射到构建文件

排查时不要从仓库全文搜索所有版本字符串开始。先按报告给出的依赖类型分层定位,通常可以按下面的顺序处理:

  1. 先看 .github/workflows/,检查 uses: 是否指向分支、浮动标签或短 SHA。
  2. 再看 Dockerfile,区分基础镜像标签和 digest;同一个镜像名的标签可能在以后指向另一份内容。
  3. 最后检查构建脚本、安装脚本和发布脚本中的下载地址、包管理器参数与远程脚本。

每找到一处引用,就记录“文件、依赖、当前引用、固定方式、更新责任人”五列。这个小表比单纯把总分抄进周报更有用,因为它能直接落到修改动作。

Go 模块、Dockerfile 和 GitHub Actions 各自怎么固定

不同生态的“固定”写法不一样,不能机械地把所有字符串都替换成哈希。

GitHub Actions 使用完整提交 SHA

# 用完整提交 SHA 固定 Action,避免标签移动后构建输入变化
name: build
on: [push]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      # 这里的 SHA 应对应已审阅的 Action 版本
      - uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608
      # 业务代码测试仍由仓库自己的命令负责
      - run: go test ./...

完整 SHA 的维护成本是更新时要重新审阅并提交变更,但它把“更新依赖”和“执行构建”分开了,适合需要可追溯流水线的仓库。

容器镜像使用 digest

# 用 digest 固定基础镜像内容,避免同名标签被重新推送
FROM golang:1.25@sha256:REPLACE_WITH_REVIEWED_DIGEST

# 复制源码后构建;真实项目应在变更记录中保存 digest 来源
WORKDIR /src
COPY . .
RUN go build -trimpath -o /out/app ./cmd/app

上面的 digest 只是写法示意,实际项目必须填入经过审阅的真实摘要;不要把示例摘要当成可直接使用的版本。镜像标签仍可保留作人类可读信息,但决定内容的是 digest。

Go 模块要结合 Go 的校验机制理解

Scorecard 文档对 Go 模块有特殊说明:完整语义版本在 Go 模块下载和校验语义下通常会被视为固定输入。因此看到 go.mod 中的版本号时,不要直接把它和 Docker 镜像标签、GitHub Action 标签等同处理;应该确认构建是否使用提交后的 go.sum,以及更新是否经过审阅。

把一次低分排查成可执行的修复清单

可以把每一条报告拆成四个问题:它位于哪个构建入口?依赖引用能否随远端变化?固定值由谁更新?更新后是否能留下审阅记录?下面的关系图把这四个问题连接到常见文件类型,方便在代码评审中逐项讨论。

Pinned-Dependencies 将 GitHub Actions、Dockerfile、Shell 脚本和 Go 模块映射到固定引用策略的静态说明图
图2:这是一张静态结构图,展示不同构建文件对应的固定引用策略与复查记录,不是实际运行结果或软件截图。
  1. 列出入口:记录工作流、Dockerfile、构建脚本和发布脚本的路径。
  2. 替换浮动引用:Action 优先使用完整 SHA,镜像优先使用经过审阅的 digest,脚本下载使用固定版本和校验值。
  3. 补齐更新记录:说明固定值对应的上游版本、更新时间和审阅依据。
  4. 复看识别边界:如果 Scorecard 仍未识别,先确认文件是否属于它当前支持的路径,再判断是否需要向项目提交支持请求。

哪些结果不能直接当成安全结论

第一,低分不代表项目一定存在已被利用的漏洞;它更多说明构建输入可能缺乏稳定性或可追溯性。第二,检查未发现问题也不代表所有依赖都绝对安全,因为自动化工具只能识别它支持的文件格式和发布方式。第三,固定依赖不是永不更新,而是把更新变成可审阅、可回滚的变更。

如果项目使用非 GitHub 代码托管、非标准发布流程或自定义构建工具,报告可能出现“未识别”与“确实未固定”难以区分的情况。此时应回到 Scorecard 官方检查说明,结合仓库自己的构建入口补充人工记录,而不是为了追求分数盲目修改文件。

相关问题

Pinned-Dependencies 只检查 Go 模块吗?

不是。它还会关注 Dockerfile、Shell 脚本和 GitHub Actions 等构建或发布路径。Go 模块只是因为自身有版本与校验语义,需要单独理解。

为什么镜像标签和 digest 要分开讨论?

标签便于阅读和升级,但标签指向的内容可能变化;digest 绑定具体镜像内容。生产构建通常需要把二者的可读性和可复现性结合起来。

修复后只看总分可以吗?

不建议。应保留文件路径、原引用、固定值和更新依据,确认单项报告已反映变化;总分只适合做概览,不能替代逐项复查。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>