GitHub Actions под замком: lockfile вместо длинных SHA

· 6 мин чтения
github-actions security supply-chain-security ci-cd best-practices
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.

Источник: https://hugovk.dev/blog/2026/lock-github-actions/