Timestamp GIT

← All posts

2026-11-07

Автоматизация отметок времени Git-коммитов с помощью GitHub App

Автоматизация отметок времени Git-коммитов с помощью GitHub App
timestamp git blockchain proof

Автоматизация проставления временных меток на коммиты Git с помощью GitHub App

Вы решили, что ваши коммиты заслуживают криптографического доказательства существования. Отлично. Теперь единственный вопрос, который имеет операционное значение, таков: это доказательство создаётся, когда вы о нём вспомните, или оно создаётся каждую ночь независимо от того, вспомнит кто-то о нём или нет?

Первая версия любого процесса проставления временных меток — ручная. Кто-то из команды пишет скрипт, запускает его перед релизом, сохраняет файл куда-нибудь и чувствует себя относительно защищённым. Шесть недель спустя этот человек в отпуске, скрипт лежит на ноутбуке, который переустановили, а релизная ветка так и не была отмечена. Хуже того, никто этого не замечает — потому что репозиторий с частичным покрытием временными метками выглядит точно так же, как полностью покрытый, пока аудитор не спросит о конкретной дате.

Эта статья — о пути автоматизации: одна установка, никаких ритуалов на каждый коммит, никакого инструментария на машинах разработчиков. Мы рассмотрим разовую настройку, что на самом деле происходит между git push и блоком Bitcoin, как отслеживать этот конвейер и где автоматизация может незаметно дать сбой.

Ловушка ручного проставления временных меток (и почему автоматизация побеждает)

У ручного проставления временных меток есть предсказуемый режим отказа: оно масштабируется вместе с дисциплиной, а дисциплина не масштабируется на команды, репозитории и часовые пояса.

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

  • Это делается на каждый коммит. Сто коммитов в неделю превращаются в сто возможностей пропустить этот шаг.
  • Это зависит от окружения. Скрипт живёт на чьей-то машине, а не в истории репозитория. У новых сотрудников его нет; у CI его нет по умолчанию.
  • Это невозможно проверить как политику. Комплаенс не может определить, отсутствует ли временная метка потому, что в тот день ничего не происходило, или потому, что кто-то забыл.

Для разработчиков требование простое: в моём рабочем процессе ничего не меняется. Для комплаенса требование столь же простое: каждый коммит в каждом отслеживаемом репозитории покрыт, и я могу это доказать.

Вот аргумент в пользу GitHub App как поверхности автоматизации, а не CLI. GitHub App от Timestamp GIT устанавливается один раз на уровне организации, затем отслеживает каждый коммит в выбранных вами репозиториях и каждую ночь привязывает их к Bitcoin — спустя много времени после того, как все разошлись по домам.

Разовая настройка: установите GitHub App и забудьте

Настройка выполняется за один проход администратором, а не каждым разработчиком.

  1. Установите App в вашей организации GitHub или личном аккаунте.
  2. Выберите репозитории для отслеживания. Никакого конфигурационного файла на репозиторий, никаких изменений в CI и никакой установки на машине разработчика.
  3. Предоставьте разрешения. Система разрешений GitHub не предлагает область «только хеш коммита», поэтому App нужен доступ только на чтение к вашим исходным репозиториям и доступ на чтение и запись к целевому репозиторию, куда записываются доказательства. Этот целевой репозиторий с доступом на запись — либо выделенная ветка timestamps в том же репозитории, либо отдельный теневой репозиторий — на ваше усмотрение.
  4. Готово. С этого момента обнаружение работает через вебхуки GitHub, и больше ничего от вашей команды не требуется.

Если вам нужна более строгая модель изоляции, режим Enterprise ZK заменяет обнаружение через вебхуки на GitHub Action из 12 строк, который выполняется на вашей собственной инфраструктуре. Этот Action отправляет в API Timestamp GIT только хеш коммита. В этом режиме сервису вообще не нужен доступ на чтение к вашим исходным репозиториям — только доступ на чтение и запись к целевому репозиторию, который получает доказательства. Вам, конечно, нужно установить сам Action.

Самостоятельный хостинг в изолированной или высокозащищённой среде

Для максимального контроля Timestamp GIT поставляется как Docker-образ по лицензии для самостоятельного хостинга. Быстрый старт с Docker Compose выглядит так:

services:
  timestampgit:
    image: rue1401/timestampgit:prod
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    restart: unless-stopped
  valkey:
    image: valkey/valkey:8
    restart: unless-stopped

Запустите и следите за логами:

docker compose pull
docker compose up -d
docker compose logs -f timestampgit

Приложение доступно по адресу http://localhost:8080, как только запустится. При первом запуске мастер настройки проведёт вас через подключение GitHub App и настройку экземпляра. Оценочный режим работает на демо-лицензии с ограниченным сроком, которую запрашивают через страницу Docker License, указав имя, компанию, email и, по желанию, номер телефона.

Внутри автоматизированного конвейера: от коммита до привязки к Bitcoin

После установки конвейер по замыслу ничем не примечателен. В этом и смысл — он должен быть скучным.

1. Обнаружение коммитов. GitHub App перехватывает новые коммиты через вебхуки. В режиме Enterprise ZK вместо этого ваш GitHub Action отправляет хеши в API. В любом случае передаются только хеши коммитов.

2. Очередь хешей. Хеши попадают в хранилище «ключ-значение» в памяти и ждут следующего пакета. Это сделано намеренно: объединение сотен коммитов в одну привязку к Bitcoin — именно то, что делает всё это достаточно дешёвым, чтобы запускать на каждом вашем репозитории.

3. Ночной cron-воркер. Каждую ночь воркер группирует все ожидающие хеши, записывает файл манифеста для каждого репозитория (.txt), строит дерево Меркла нативно, создаёт доказательства OpenTimestamps по публичным календарям OTS и привязывает корень Меркла в блокчейн Bitcoin.

4. Доставка доказательств. Манифест и файлы квитанций .ots отправляются обратно в ваш репозиторий — в выделенную ветку timestamps или в теневой репозиторий. Подтверждение Bitcoin обычно занимает около 3 часов, поэтому запись доказательств обычно завершается через несколько часов после старта пакета.

Вызов API, который делает режим ZK, выглядит так (сегмент {hash} — это значение HMAC из подписанного URL, а не хеш коммита):

curl -X POST \
  "https://timestampgit.dev/api/timestamp/acme/payments-api/proofs/<hmac>/<commit-sha>/<commit-id>"

Обратите внимание, чего в этом запросе нет: ни диффа, ни содержимого файлов, ни имени ветки, ни личности автора сверх того, что подразумевает ID коммита. Zero-knowledge безопасность здесь — не маркетинговая фраза: сервис никогда не видит, не копирует и не хранит ваш исходный код, только Git-хеш.

И обратите внимание, чего не требуется от ваших разработчиков: никаких команд, никаких хуков, никаких флагов. Они пушат как обычно. Доказательство появляется на следующее утро.

Мониторинг и обработка сбоев: как обеспечить надёжность доказательств

Автоматизация, за которой вы не можете наблюдать, — это просто надежда с лишними шагами. Есть три уровня видимости, и стоит использовать все.

Публичные панели статуса

Каждый отслеживаемый репозиторий получает страницу статуса по адресу https://timestampgit.dev/status/{user}/{repo}, где показаны срок хранения доказательств (насколько далеко назад простирается покрытие), самая ранняя дата привязки, ежедневная регулярность, данные блока и транзакции Bitcoin, а также календарь-теплокарта. Теплокарта — самый быстрый способ заметить пробел: один пропущенный день сразу бросается в глаза.

Бейджи для README

Возьмите виджет для встраивания по адресу https://timestampgit.dev/connected/{user}/{repo} — он даёт живой предпросмотр Shields.io и готовый Markdown для копирования. Бейдж ведёт на публичную страницу проверки, которую может открыть любой, — полезно, когда вы хотите, чтобы клиент или аудитор подтвердил покрытие без создания аккаунта.

# Returns badge URLs and ready-to-paste markdown snippets
curl https://timestampgit.dev/api/badgeLink/acme/payments-api

Приватные репозитории тоже поддерживаются: их URL содержат зашифрованный HMAC, специфичный для экземпляра сервера, поэтому читать статус могут только авторизованные пользователи.

Программный мониторинг и экспорт для аудита

Публичные эндпоинты статуса рассчитаны на опрос вашим собственным инструментарием:

# Last anchored Bitcoin block info (JSON)
curl https://timestampgit.dev/api/statusLast/acme/payments-api

# Total committed / stamped commit count (JSON)
curl https://timestampgit.dev/api/statusCount/acme/payments-api

# Combined summary used by Shields.io
curl https://timestampgit.dev/api/statusSummary/acme/payments-api

Для отчётности по комплаенсу выгружайте полный журнал аудита в CSV через GET /api/audit/{user}/{repo} и ежедневные PDF-сертификаты через GET /api/report/{user}/{repo}/{date}.

Когда запуск завершается сбоем

Если ночной запуск задерживается или завершается сбоем, ожидающие хеши остаются в очереди и переходят в следующий пакет — коммиты не теряются. На практике симптомом проблемы становится ровный участок на теплокарте статуса, а не потеря данных. Следите за этим в двух местах: docker compose logs -f timestampgit для самостоятельно размещённых экземпляров и панель управления для SaaS.

Лучшие практики автоматического проставления временных меток на коммиты

Автоматизация убирает затраты на каждый коммит, поэтому правильное значение по умолчанию меняется: покрытие должно быть широким, а не выборочным.

  • Отслеживайте каждый репозиторий, содержащий интеллектуальную собственность. Выбор «важных» репозиториев — это ручное решение, замаскированное под автоматизацию, и пропущенный репозиторий всегда оказывается тем, который в итоге важен. Предельная стоимость ещё одного репозитория — ночной хеш в существующем пакете.
  • Используйте режим Enterprise ZK для чувствительных кодовых баз. Если ваша политика требует, чтобы сами хеши коммитов не проходили через третью сторону, маршрут через GitHub Action оставляет внутри вашего периметра всё, кроме хеша. Для полностью изолированных сред лицензия на самостоятельный хостинг Docker покрывает те же потребности.
  • Экспортируйте журналы аудита по расписанию. CSV в той же папке, что и ваши юридические документы, лучше входа в панель управления, о котором вы забудете во время спора.
  • Коммитьте рано и часто в отслеживаемых ветках. Множество мелких коммитов дают более плотный след доказательств с более защищаемыми датами, чем один крупный squash к моменту релиза.
  • Избегайте переписывания истории в ветках, на которые вы опираетесь как на prior art. Force-push создаёт новые хеши; старые остаются привязанными, но связь между «этим кодом» и «этим доказательством» становится сложнее объяснить юристу. Если переписывание необходимо, сначала поставьте тег на состояние до переписывания.
  • Держите ветку с доказательствами отдельно от исходных веток. Ветка timestamps или теневой репозиторий — это сгенерированный результат; отношение к ней как к доступной только для чтения помогает избежать случайных слияний в main.

Одна граница, которую стоит помнить: пакетирование плюс примерно 3 часа подтверждения Bitcoin означают, что коммит, сделанный в 17:00, не будет доказуем к 17:05. Если доказательство нужно сегодня, планируйте с учётом ночного окна, а не рассчитывайте на мгновенный расчёт.

FAQ

Нужно ли разработчикам запускать какие-либо команды или устанавливать инструменты для проставления временных меток на коммиты?

Нет. После установки GitHub App каждый коммит в отслеживаемый репозиторий автоматически обнаруживается и каждую ночь привязывается к Bitcoin. Разработчики продолжают пользоваться Git как обычно — никакого CLI, никаких ручных шагов.

Через сколько после коммита становится доступно доказательство временной метки?

Коммиты пакетируются и привязываются раз в ночь. После отправки пакета подтверждение Bitcoin обычно занимает около 3 часов, поэтому доказательства обычно доступны на следующее утро.

Могу ли я проверить временную метку, не полагаясь на Timestamp GIT?

Да. Файлы квитанций .ots и доказательства Меркла не зависят от вендора — SHA-256 плюс данные блока Bitcoin, никакого проприетарного формата. Вы можете скачать их и проверить по блокчейну Bitcoin стандартными инструментами OpenTimestamps или воспользоваться страницей проверки в браузере, которая выполняет все вычисления локально в вашем браузере. О локальной проверке стоит почитать отдельно: см. How to Verify a Bitcoin Timestamp Proof in Your Browser.

Что если мой репозиторий приватный или содержит чувствительный код?

Timestamp GIT никогда не читает и не хранит ваш исходный код — обрабатываются только хеши коммитов. Для более строгой изоляции в режиме Enterprise ZK GitHub Action отправляет только хеши с вашей собственной инфраструктуры, либо вы можете разместить решение самостоятельно с помощью Docker. Если вы взвешиваете компромиссы по сравнению с другими подходами, Timestamp GIT Alternatives: What to Compare First охватывает критерии сравнения.

Что если я использую несколько организаций GitHub?

Установите App в каждой организации и отслеживайте нужные репозитории. Ваша панель управления агрегирует все отслеживаемые репозитории в одном месте.

Заключение

Ценность временной метки обратно пропорциональна тому, сколько внимания она требует. Доказательство, которое вы создаёте вручную, — это доказательство, существующее для коммитов, о которых вы вспомнили, — а на аудите это читается как непоследовательный процесс, а не как защищённый.

Установка GitHub App занимает одну сессию администратора. После этого каждый коммит в отслеживаемый репозиторий хешируется, пакетируется, сводится в корень Меркла и привязывается к Bitcoin, пока вы спите, — с бейджами для публичного доверия, CSV-журналами для комплаенса и квитанциями .ots, которые переживут любого вендора. Разработчики не меняют ничего.

Готовы перестать делать это вручную? Установите GitHub App для вашей организации — бесплатно для публичных репозиториев, с тарифами Pro Agency и Enterprise ZK для приватных репозиториев и рабочих процессов только с хешами.

Похожие статьи

EU label: AI-generated content