Кальтер / Блог

GitHub artifact attestation: доступность, проверка и границы доказательства

Проверь план репозитория, digest и workflow identity, чтобы подтвердить происхождение бинарника или OCI-образа без обещаний безопасности.

Материал подготовлен с помощью ИИ; первичные источники проверены редакцией ZASLON. Учебные примеры явно обозначены и не описывают реальные результаты.

Происхождение сборки
Редакционная схема связи файла и сборки. Аттестация происхождения не доказывает безопасность программы.

GitHub artifact attestation помогает проверить происхождение конкретной сборки: с каким workflow и репозиторием связан артефакт. Это проверка provenance, а не сертификат безопасности кода или бинарника. Перед внедрением проверь доступность для своего плана и типа репозитория, а при приёмке сравни digest полученного файла с проверенной записью.

По актуальной на 16 ноября документации GitHub, на Free, Pro и Team функция доступна только публичным репозиториям; private/internal требуют Enterprise Cloud. В workflow для бинарника нужны id-token: write, contents: read, attestations: write и действие actions/attest@v4; пример OCI-образа добавляет packages: write (официальная документация). План, синтаксис и CLI могут измениться — перепроверь перед внедрением.

Решение по доступности

Видимость и план Артефакт Решение перед настройкой
Public, Free/Pro/Team Бинарник Документация указывает поддержку; зафиксируй файл subject и разрешённость публичной публикации
Private/internal, Free/Pro/Team Любой По текущим условиям плана private/internal не подходят; выясни доступный план или выбери иной процесс
Private/internal, Enterprise Cloud Бинарник или OCI Проверь организационные политики, событие запуска, job-level permissions и reusable workflows
Public или Enterprise Cloud OCI-образ Сверяй имя образа и digest; изменяемый tag не идентифицирует содержимое

Если workflow явно задаёт permissions, все неуказанные права становятся none; поэтому выдавай только требуемые scopes. Учитывай тип события и осторожно относись к pull_request_target, который имеет отдельную модель риска (синтаксис workflow). id-token: write разрешает получить OIDC-токен, но не даёт само по себе права записи в облаке: целевой доступ задаётся trust policy провайдера (документация OIDC).

Приёмка файла по digest

Допустим, заказчику передан файл tool-linux-amd64 из example/tool. Следующее значение только учебное и не является реальным digest: sha256:111111111111111111111111111111111111111111111111111111111111abcd.

  1. Самостоятельно вычисли SHA-256 полученного файла и сохрани полное значение в задаче поставки.
  2. Следуй актуальному примеру GitHub CLI: gh attestation verify ./tool-linux-amd64 -R example/tool (справка команды).
  3. Убедись, что подтверждённый subject соответствует именно этому digest, а владелец и репозиторий, commit и workflow identity совпадают с ожидаемой цепочкой сборки.
  4. Запиши дату, версию CLI, источник файла, ожидаемые repository/commit/workflow и итог проверки. В таблице ниже — только учебные ситуации: ни один файл или workflow здесь реально не проверялся.
Учебный результат Условный вывод проверки Решение по файлу
Ожидаемая цепочка совпала Digest, репозиторий, commit и workflow identity соответствуют заранее согласованным значениям Зафиксировать происхождение файла; перейти к отдельной функциональной и безопасностной приёмке
Commit или workflow не совпал Digest либо provenance указывает на другой commit/workflow, чем ожидалось Приостановить приёмку этой поставки и запросить разбор расхождения; не считать ожидаемую цепочку подтверждённой

Для OCI-образа документация показывает форму gh attestation verify oci://… -R owner/repo (справка команды); подставь точный registry и образ, а сравнивай digest, а не один tag. Вывод команды и допустимые параметры зависят от установленной версии CLI — смотри её справку и официальную документацию при проверке.

Граница доказательства

Успешная attestation связывает артефакт с указанным происхождением. Она не доказывает, что commit доброкачественный, зависимости безопасны, runner не скомпрометирован или программа проходит требования заказчика. Если нежелательный код попал в сборку, provenance может точно показать эту нежелательную цепочку.

Разделяй два решения: приёмка файла проверяет идентичность и происхождение сборки; приёмка системы проверяет требования, функциональность, эксплуатацию и безопасность приложения. Для общего набора критериев смотри чек-лист приёмки разработки. Это руководство не запускает workflow и не проверяет конкретный репозиторий.