Zizmor项目中发现unpinned-uses规则对本地扩展的误报问题

在GitHub Actions安全审计工具Zizmor中，开发团队发现了一个关于unpinned-uses规则的误报问题。该规则原本设计用于检测工作流中未固定版本的外部action引用，但错误地将项目内部的本地action引用也标记为了安全问题。

问题背景

GitHub Actions允许用户通过uses关键字引用两种类型的action：一种是托管在GitHub Marketplace或其他仓库的外部action，另一种是存放在项目本地的action。对于外部action，最佳实践是固定其版本（通过tag、commit hash或特定分支），以避免潜在的供应链攻击风险。这就是unpinned-uses规则的设计初衷。

然而，在Zizmor的初始实现中，该规则没有区分外部action和本地action，导致对项目内部.github/actions目录下的本地action也发出了警告。例如，在pyca/cryptography项目中，类似uses: ./.github/actions/cache这样的本地引用被错误地标记为"未固定版本"。

技术影响

这种误报会产生两个主要问题：

1. 降低工具可信度：频繁的误报会让用户对工具的整体准确性产生怀疑，可能导致用户忽略真正重要的安全警告。

2. 增加维护负担：项目维护者需要花费额外时间处理这些误报，或者被迫为本地action添加不必要的版本固定（这实际上对本地action没有意义）。

解决方案

Zizmor团队迅速响应并修复了这个问题。修复方案的核心逻辑是：

1. 在检测uses引用时，首先判断是否为本地路径引用（以./或../开头的路径）。

2. 如果是本地引用，则跳过unpinned-uses规则的检查。

3. 仅对外部action（如actions/checkout@v3）执行版本固定检查。

这个修复既保持了对外部action的安全要求，又避免了对本地action的不必要警告，实现了更精确的安全审计。

最佳实践建议

虽然这个问题已经修复，但对于GitHub Actions用户来说，仍然需要注意：

1. 对于外部action引用，始终使用固定版本（推荐commit hash或特定版本tag）。

2. 对于本地action，保持清晰的目录结构（如统一放在.github/actions下），便于维护。

3. 定期使用类似Zizmor这样的工具进行工作流审计，确保没有遗漏真正的安全问题。

Zizmor团队对这类问题的快速响应展示了他们对工具准确性和用户体验的重视，这也是选择安全审计工具时需要考虑的重要因素之一。