gh-workflow-hardener - GitHub Actions security scanner: pin actions to SH

项目说明

gh-workflow-hardener

![Python 3.8+]()

Secure your GitHub Actions workflows against supply chain attacks. Detects unpinned actions (the tj-actions attack ), dangerous permissions, and script injection — all in one scan.

After the tj-actions supply chain attack compromised 23k+ repositories, teams realized: GitHub Actions workflows are a security blind spot. This tool fixes that.

What It Detects

🔴 Critical Issues

🟡 High/Medium Issues

📋 Low Issues

Hosted API (No Install)

Scan any public repo with a single HTTP call:

Response:

Free, no auth required.

Installation

As a CLI tool

Option 1: Homebrew (macOS & Linux)

Option 2: From source

As a GitHub Action (recommended)

Add to .github/workflows/security-check.yml:

Usage

CLI

Example Output

Real-World Results

We scanned workflows from 8 popular open-source repositories (Feb 2026):

| Repository | Stars | Workflows | Findings | Score |
|---|---|---|---|---|
| facebook/react | 236k | 20 | 197 | 0/100 |
| /next.js | 132k | 25 | 143 | 0/100 |
| langchain-ai/langchain | 105k | 16 | 89 | 0/100 |
| django/django | 83k | 16 | 56 | 0/100 |
| fastapi/fastapi | 82k | 19 | 121 | 0/100 |
| microsoft/ | 170k | 12 | 66 | 0/100 |
| astral-sh/ruff | 40k | 19 | 8 | 40/100 |
| pallets/flask | 69k | 4 | 6 | 55/100 |

686 findings across 131 workflow files. Zero false positives.

73% of findings are unpinned action references, the exact exploited in the tj-actions attack. Repos that already pin to SHAs (ruff, flask) score dramatically higher.

Why This Matters

The tj-actions attack showed that a single compromised action can:

By pinning actions to specific commit SHAs and permissions, you eliminate entire attack .

GitHub Action Inputs

| Input | Default | Description |
|-------|---------|-------------|
| fail_on | critical | Exit with error if findings at this se or abo: critical, high, medium, low, none |
| format | text | Output format: text, json, markdown, sarif |
| fix | false | Auto-fix unpinned actions by pinning to commit SHAs |
| github_token | ${{ github.token }} | GitHub token for SHA resolution (needed for auto-fix) |

Zero Dependencies (CLI)

The CLI requires only pyyaml and click. No hea frameworks, no bloat. Fast. Auditable.

VS Code Extension

Prefer catching issues as you type? The companion GitHub Workflow Hardener VS Code extension runs the same checks inline while you edit .github/workflows/ files — no CLI needed.

Contributing

Found a false positive? Have a better detection rule? Open an issue or PR.

License

MIT

项目信息

开发语言：Python

Star 数：13

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕GitHub Actions security scanner: pin actions to SHAs, detect script injection, audit permissions. Fix supply chain vulnerabilities.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。