GitHub Actions под замком: lockfile вместо длинных SHA
Раньше стандартный совет по безопасности GitHub Actions звучал так: фиксируйте action не на теге, а на полном SHA коммита. Тег — это просто ссылка, её можно передвинуть. Полный SHA передвинуть нельзя. У подхода был заметный недостаток: 40-символьные хеши делают workflow нечитаемым. Выбор получался неприятный: либо удобный тег, который можно подменить, либо безопасный хеш, который невозможно прочесть.
28 октября 2026 года GitHub представил workflow lockfiles — и теперь читаемость и безопасность совместимы. Хуго ван Кеменаде (Hugo van Kemenade) показал на примере своих репозиториев, как перевести проект на lockfile за пару команд.
Зачем вообще фиксировать версии
Action в GitHub Actions — это обычный Git-репозиторий. Строка uses: actions/checkout@v5 означает «возьми код этого репозитория по тегу v5». Тег не привязан к коммиту навсегда: владелец репозитория может передвинуть его в любой момент.
Именно так работают атаки на цепочку поставок (supply-chain attacks). Злоумышленник получает доступ к популярному репозиторию с action и направляет «безопасный» тег на вредоносный код. Тысячи проектов, которые ссылаются на этот тег, на следующем запуске CI тянут заражённую версию. Громкий пример — атака на tj-actions/changed-files в марте 2025 года.
Механика обмана держится на устройстве Git. Тег — не копия кода, а закладка в книге: она указывает на конкретный коммит, и переложить её можно в любой момент. Хеш коммита, в отличие от тега, вычисляется из содержимого. Подменить код и сохранить прежний хеш нельзя.
Классическая защита — закрепить action на полном SHA. Старый workflow выглядел так:
name: Lint
on: [push, pull_request, workflow_dispatch]
permissions: {}
env:
FORCE_COLOR: 1
RUFF_OUTPUT_FORMAT: github
jobs:
lint:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- uses: j178/prek-action@44924fe9ef4a6f88253c4b6b1bf11c689d3ce53d # v3.1.0
Такую ссылку задним числом не подменишь. Но версию видно только в комментарии # v7.0.1, который кто-то поддерживает вручную. Обновлять такие ссылки неудобно, а строка uses не читается без напряжения глаз.
Что такое workflow lockfile
Идея знакома каждому, кто видел package-lock.json или uv.lock. Lockfile — это файл, в котором зафиксированы точные версии зависимостей: не просто «v7.0.1», а конкретный коммит. В коде живут понятные версии, а хеши хранятся отдельно, в машинно-генерируемом файле. GitHub перенёс этот подход на GitHub Actions и называет его workflow lockfile.
Схема такая:
- в workflow остаётся читаемый тег вида
actions/checkout@v7.0.1; - рядом появляется файл
.github/workflows/actions.lock, где для каждого action записаны тег, хеш коммита и ID владельца и репозитория; - CI проверяет, что lockfile соответствует workflow и что каждая зафиксированная версия по-прежнему совпадает с тем, что опубликовано у владельца.
Устанавливаем расширение
Всё делается через gh CLI и расширение gh-actions-lock:
$ gh extension install github/gh-actions-lock
✓ Installed extension github/gh-actions-lock
Закрываем workflow на замок
В корне репозитория:
$ gh actions-lock
✓ All 1 workflows valid
Команда переписывает workflow: полный SHA меняется на читаемый тег.
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 946971c..3503607 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -13,7 +13,7 @@ jobs:
runs-on: ubuntu-latest
steps:
- - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+ - uses: actions/checkout@v7.0.1
with:
persist-credentials: false
- - uses: j178/prek-action@44924fe9ef4a6f88253c4b6b1bf11c689d3ce53d # v3.1.0
+ - uses: j178/prek-action@v3.1.0
И создаёт lockfile .github/workflows/actions.lock:
# This file is machine-generated by S0 .
# Do not edit by hand; run S1 to update.
# Docs: https://gh.io/actions-lockfile
version: 'v0.0.3'
workflows:
'.github/workflows/lint.yml':
- 'actions/checkout@v7.0.1'
- 'j178/prek-action@v3.1.0'
dependencies:
'actions/checkout@v7.0.1':
ref: 'v7.0.1'
commit: 'sha1-3d3c42e5aac5ba805825da76410c181273ba90b1'
owner_id: 44036562
repo_id: 197814629
'j178/prek-action@v3.1.0':
ref: 'v3.1.0'
commit: 'sha1-44924fe9ef4a6f88253c4b6b1bf11c689d3ce53d'
owner_id: 10510431
repo_id: 1052387486
Изменённые workflow и новый lockfile коммитим вместе. Формат файла описан в документации: gh.io/actions-lockfile.
Renovate и Dependabot уже всё умеют
Renovate и Dependabot — боты, которые сами открывают pull request с обновлением зависимостей. Dependabot встроен в GitHub, Renovate подключается отдельным приложением. Хорошая новость: плановые обновления не сломаются. Оба уже поддерживают lockfile (Renovate, Dependabot): регулярные обновления подтянут новые версии и заодно обновят actions.lock.
Второй совет автора — использовать cooldowns, «период выдержки»: обновлять зависимости не сразу после релиза, а через несколько дней. Смысл простой: свежий релиз — не значит проверенный. Если релиз окажется вредоносным, за это время его обычно отзывают, и до вашего репозитория он не доедет.
Проверяем lockfile в CI
Lockfile может разойтись с workflow — например, кто-то добавил новый action и забыл перегенерировать файл. GitHub рекомендует проверять lockfile в CI: файл должен быть актуальным и не повреждённым. Готовый пример — файл verify-lockfile.yml в репозитории расширения.
Автор встроил проверку отдельной job в свой lint workflow: так она работает независимо и параллельно с остальными проверками.
name: Lint
on: [push, pull_request, workflow_dispatch]
permissions: {}
env:
FORCE_COLOR: 1
RUFF_OUTPUT_FORMAT: github
jobs:
lint:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7.0.1
with:
persist-credentials: false
- uses: j178/prek-action@v3.1.0
# Fails when .github/workflows/actions.lock is out of sync with the
# workflows or a locked pin no longer verifies upstream.
lockfile:
runs-on: ubuntu-slim
env:
GH_TOKEN: ${{ github.token }}
steps:
- uses: actions/checkout@v7.0.1
with:
persist-credentials: false
- run: gh extension install github/gh-actions-lock --pin v0.4.1
- run: gh actions-lock --verify
Три детали.
- Команда
gh actions-lock --verifyсверяет lockfile с workflow и с реальными коммитами в репозиториях action. Если хоть что-то не сходится, job падает. Токен для проверки берётся из встроенного github.token. - Раннер ubuntu-slim лёгкий: для такой проверки тяжёлая машина не нужна.
- Версия расширения зафиксирована флагом
--pin v0.4.1. Её придётся периодически обновлять — автоматизации пока нет. - После любых изменений в actions нужно снова запустить
gh actions-lock. Если вы правили существующий workflow, где action уже в lockfile, по сути ничего не меняется. А вот новый файл — например, отдельный verify-lockfile.yml — потребует перегенерации. CI об этом напомнит.
zizmor
zizmor — линтер безопасности для GitHub Actions: он проверяет workflow-файлы на известные проблемы. Автор рекомендует его настоятельно: если вы им ещё не пользуетесь, начните.
Нюанс совместимости: версии zizmor до v1.32.0 требуют фиксации action на хеше коммита. Поддержка lockfile появилась только в v1.32.0.
Автор запускает zizmor через prek, в .pre-commit-config.yaml настройка выглядит так:
- repo: https://github.com/zizmorcore/zizmor-pre-commit
rev: v1.32.0
hooks:
- id: zizmor
Итог
Осталось закоммитить и запушить. Цена перехода — две команды и один job в CI. Схема выходит аккуратной: в коде — читаемые версии, в lockfile — точные хеши, в CI — автоматическая проверка, а zizmor присматривает за всем остальным.
Примеры внедрения в проектах экосистемы Python:
Документация по lockfile: gh.io/actions-lockfile.