Инженерия · Безопасность цепочки поставок

С нуля до золота OpenSSF меньше чем за два дня

Репозиторий bitg был создан 11 ноября 2026 года в 17:08 UTC. Через 36 часов проект достиг золотого уровня OpenSSF Best Practices. Большинство критериев, связанных с кодом, заняли часы; самые трудные касались людей, а один мы сначала отметили неверно и потом исправили.

· 5 мин чтения

bitg — метод ввода. В Windows это DLL, которая загружается в каждое приложение, где вы печатаете, то есть ровно тот тип программ, к которому стоит относиться с подозрением. Мы хотели, чтобы наши практики безопасности мог проверить человек, который нас не знает, поэтому взяли критерии OpenSSF Best Practices как чек-лист и опубликовали результат.

Публичная запись проекта 16620 показывает хронологию. Запись создана 12 ноября 2026 года в 17:15 UTC. Уровень passing достигнут в 17:47, silver — в 20:24, gold — 13 ноября в 05:02. Сам репозиторий был создан накануне в 17:08 UTC. В этой статье — что на самом деле требовал от нас каждый уровень, куда ушла работа и о чём значок не говорит.

  1. Passing (17:47)Ясность лицензии, политика безопасности, тесты в CI и заголовки REUSE в каждом файле.
  2. Silver (20:24)Документ об управлении, обоснование безопасности, порог покрытия и первый релиз с подписанным происхождением.
  3. Код для gold (ночью)Покрытие ветвей, воспроизводимые MSI и .pkg, письменный аудит безопасности, SLSA Build L3.
  4. Люди для gold (05:02)Ревью вторым человеком, обязательная 2FA, участники извне проекта, bus factor больше единицы.
Рисунок 1

Passing и silver: в основном записать то, что уже правда

Большая часть passing и silver — документация, и полезной дисциплиной было писать только то, что репозиторий может доказать. К середине дня 12 ноября у bitg уже были CI на трёх операционных системах, оценочный набор и политика безопасности. За час до создания записи мы влили аттестации релизов с SBOM, workflow OpenSSF Scorecard и кодекс поведения (PR #16), затем фаззинг ядра, бандлы релизов и закреплённые по SHA образы контейнеров (#17).

Соответствие REUSE (#22) добавило заголовок лицензии SPDX в каждый исходный файл и было влито в 17:47 — в ту же минуту, когда был получен passing. Оно же стало причиной самой поучительной ошибки дня. В одном тестовом скрипте PowerShell новый заголовок оказался выше метки порядка байтов UTF-8, и метка очутилась в середине файла. Windows PowerShell 5.1 перестал разбирать блок param() скрипта, и сквозной тест молча перестал работать, пока мы не нашли и не исправили это в #30. Изменение ради соответствия — всё равно изменение кода; его diff нужно смотреть так же, как любой другой.

Silver попросил того, что одиночные проекты обычно пропускают: документ об управлении с правилами принятия решений и преемственностью, дорожную карту, описание архитектуры и обоснование безопасности с требованиями, моделью угроз, границами доверия и известными пробелами (#24). Тот же PR поднял покрытие строк в CI до 91,38% с порогом 90% и стал первым pull request в проекте с одобряющим ревью. Сам silver пришёл через несколько минут после релиза v0.3.1 — первого, где каждый файл имел подписанный build provenance и аттестацию SBOM. Мы проверили их через gh attestation verify на опубликованных файлах, а не стали предполагать, что workflow сработал.

Gold, часть про код: одна ночь

Четыре критерия gold требовали инженерной работы, и каждый стал отдельным pull request той ночью:

  • Покрытие ветвей (#36). Для покрытия ветвей нужна nightly-версия Rust, поэтому CI закрепляет одну из них и запускает cargo llvm-cov --branch. На Linux покрыто 94,81% ветвей (1 223 из 1 290) и 97,19% строк. Пороги — 90% и 95%. Одна ловушка: составное assert!(a && b) в тесте тоже считается ветвями.
  • Воспроизводимые сборки (#48). Пакеты .deb уже были воспроизводимы байт в байт; MSI и .pkg стали такими после ночи охоты за временными метками — об этом отдельная статья.
  • Аудит безопасности (#48). Письменная проверка кода на одном коммите против обоснования безопасности: ручное чтение unsafe-кода, границ FFI и COM, записи файлов, вызовов логирования и workflow. Зафиксировано 11 находок, ни одной критической или высокой. Исправления вошли в тот же PR и через несколько часов в #49, а сам аудит опубликован в docs/ASSURANCE.md.
  • SLSA Build L3 (#63). Пакеты релиза теперь собирает переиспользуемый workflow. Jobs, которые компилируют код, не могут запросить токен подписи; аттестации пишет отдельный job, который ничего не компилирует. Workflow релиза публикует его только после того, как каждый пакет прошёл gh attestation verify с ожидаемым подписывающим workflow и тегом.

Всё это было быстрым не потому, что было лёгким. Быстрым это было потому, что проект маленький и новый: один Rust workspace, три скрипта упаковки и никакого наследия, которое пришлось бы переносить.

Gold, часть про людей: медленная половина

Оставшиеся критерии gold нельзя выполнить одним написанием кода. Они спрашивают, смотрит ли изменения больше одного человека, защищены ли аккаунты, вносят ли вклад люди вне проекта и переживёт ли проект потерю любого одного человека.

Ревью. До вечера 12 ноября ни один pull request не проходил ревью: из 18 влитых до 19:00 UTC одобрения не было ни у одного. Затем в проекте появился второй мейнтейнер, проводящий ревью, новый документ об управлении сделал ревью частью процесса, а набор правил ветки main теперь требует одобряющего ревью от кого-то, кроме автора последнего push. Из 21 pull request, влитого между релизом v0.3.1 и получением gold, у 17 было одобряющее ревью; четыре из 21 были обновлениями зависимостей.

Двухфакторная аутентификация. Здесь мы ошиблись в анкете. Сначала мы отметили «2FA обязательна» как выполненный критерий, потому что все активные мейнтейнеры ею пользовались. Но критерий — про принуждение, а организация её не требовала. Мы исправили ответ на «не выполнено». Позже мы включили в организации настройку, которая требует 2FA и принимает только безопасные методы. Это означало исключить участников организации, не включивших 2FA. Только после этого мы отметили оба критерия 2FA как выполненные.

Доказательства, а не утверждения. Для некоторых критериев анкета считает ответ «Met» без URL недостающей информацией. Пять наших ответов считались неизвестными, пока мы не добавили ссылки на файлы или запуски workflow, которые их доказывают.

Участники и bus factor. Последние два критерия сдвинулись только тогда, когда pull request открыли люди извне проекта. Мы написали пошаговое руководство «первый вклад» и открыли задачи для новичков; первые внешние pull request (#64 и #67) были влиты за 35 минут до того, как был зафиксирован gold.

Ограничения

  • Значок измеряет процесс, а не зрелость. На момент gold репозиторию было 36 часов. Scorecard, автоматически проверяющий репозиторий, 13 ноября дал 8,1 из 10; его проверка «Maintained» даёт 0, потому что проекту меньше 90 дней, а «Signed-Releases» — 2.
  • История ревью короткая. 17 одобренных pull request были просмотрены за одну ночь, многие из них — небольшие изменения документации и CI. Доля показывает, что ревью происходит, но не показывает, насколько оно глубокое.
  • Некоторые ответы держатся на нашем слове. Например, «не связан» ли участник с проектом, анкета принимает как самооценку.
  • Gold — это снимок. Критерии перепроверяются по мере изменения проекта. Покрытие ветвей, ревью вторым человеком и внешний вклад имеют смысл, только если через полгода они всё ещё в силе.

Что мы сказали бы другому небольшому проекту: критерии про код — это хорошие выходные работы, и они стоят того сами по себе. Критерии про людей — настоящая проверка, и на них должно уйти больше времени, чем ушло у нас.

Повторите сами

Первая команда выводит уровень и три отметки времени; вторая — текущую оценку Scorecard; третья проверяет выпущенный пакет по его подписанному происхождению.

$ curl -s https://www.bestpractices.dev/projects/16620.json | jq '.badge_level, .achieved_passing_at, .achieved_silver_at, .achieved_gold_at'
$ curl -s https://api.securityscorecards.dev/projects/github.com/dtwinuz/bitg | jq '.score, (.checks[] | {name, score})'
$ gh release download v0.3.1 -R dtwinuz/bitg -p 'bitg_0.3.1_amd64.deb' && gh attestation verify bitg_0.3.1_amd64.deb -R dtwinuz/bitg
Репозиторий
dtwinuz/bitg
Коммит
2de5c94
Материалы
wonmortech/research

Источники

  1. www.bestpractices.dev/projects/16620
  2. www.bestpractices.dev/projects/16620.json
  3. api.securityscorecards.dev/projects/github.com/dtwinuz/bitg
  4. github.com/dtwinuz/bitg/pulls?q=is%3Apr+is%3Amerged
  5. dtwinuz/bitg GOVERNANCE.md, docs/ASSURANCE.md, CHANGELOG.md

Похожие материалы

Смотреть ещё