Почему ваш Git-лог — не доказательство, и как сделать его защищённым от подделки
Задайте себе конкретный вопрос: если бы адвокат, аудитор или юрист патентного тролля попросил вас доказать, что определённый коммит существовал в определённую дату, что бы вы им на самом деле предъявили?
Скриншот git log? Экспорт вашей активности на GitHub? И то, и другое отбрасывается без труда. Если вам нужно настоящее доказательство защиты истории Git от подделки с помощью Bitcoin, ответ — не улучшенный экспорт, а метка времени, которую никто, включая вас, не может задним числом датировать или изменить. Это руководство разбирает механику того, почему ваш лог не годится как доказательство, а затем — точные шаги, чтобы сделать его защищённым от подделки, причём GitHub App сделает всю работу за ночь.
Почему ваш Git-лог не защищён от подделки (и что это значит для комплаенса)
Git адресуется по содержимому, и это вводит людей в заблуждение, будто история неизменна. Это не так. Каждый хеш коммита — это хеш дерева, родителя, сообщения и метаданных, но цепочка этих хешей живёт в репозитории на сервере, который вы не контролируете. Три вещи подрывают доказательственную ценность:
- История перезаписываема по замыслу.
git rebase,git commit --amendи force-push заменят коммиты новыми хешами. Старые объекты остаются до сборки мусора, а затем исчезают. Мейнтейнер с правами на push может переписать месяцы истории за минуту. - Даты указываются самостоятельно. Метки времени автора и коммиттера — это просто метаданные, которые вы можете задать. Любой внутренний лог, фиксирующий время, надёжен ровно настолько, насколько надёжна машина, которая его записала.
- Лог живёт на чужой инфраструктуре. Ваша организация на GitHub, база данных CI, внутренняя вики — всё редактируемо, всё под вашим контролем. На юридическом аудите это делает их «заинтересованными» доказательствами, которые легко оспорить.
Последний пункт важнее, чем ожидают разработчики. Запись, которую вы могли изменить, — это запись, про которую другая сторона будет утверждать, что вы её изменили. Решение — не больше логирования, а вынесение доказательства во внешнюю систему, чью историю не может переписать ни одна сторона.
В этом и идея криптографического prior art: вы берёте отпечатки, которые Git и так создаёт (хеши коммитов), группируете их, хешируете пакет ещё раз в дерево Меркла и закрепляете корень в блокчейне Bitcoin через протокол OpenTimestamps. Кто-то может переписать ваш репозиторий, но не может переписать блок Bitcoin.
Timestamp GIT автоматизирует всю эту цепочку — без CLI-инструментов, без команд OpenTimestamps, без изменений в рабочем процессе разработчиков. Для более глубокого контекста см. как доказать prior art для программной идеи без патента и является ли блокчейн-метка времени юридически действительным доказательством.
Предварительные требования: что нужно перед закреплением первого коммита
- Репозиторий GitHub (публичный или приватный), где у вас есть права администратора, чтобы установить GitHub App Timestamp GIT.
- Аккаунт Timestamp GIT — бесплатно для open source / публичных репозиториев, Pro Agency ($49/мес) для приватных репозиториев, Enterprise ZK ($199/мес) для режима GitHub Actions.
- Целевой репозиторий для доказательств. Либо ветка в том же репозитории, либо отдельный теневой репозиторий. Модель разрешений GitHub требует как минимум доступа на чтение к исходному репозиторию (области «только хеш коммита» нет), плюс чтение-запись к целевому.
- Для режима Enterprise ZK: рабочий процесс GitHub Actions и API-ключ. Здесь требуется только доступ на чтение-запись к целевому репозиторию — исходному репозиторию доступ на чтение вообще не нужен.
- Для self-hosted: Docker и Docker Compose, а также временная демо-лицензия со страницы Docker License.
На машинах разработчиков ничего не устанавливается.
Пошагово: сделайте историю Git защищённой от подделки с Timestamp GIT
Шаг 1 — Установите GitHub App и подключите репозиторий
Установите GitHub App Timestamp GIT в вашей организации и выберите репозитории для мониторинга. Предоставьте доступ на чтение к исходным репозиториям и чтение-запись к целевому (ветка или теневой репозиторий). Приложение регистрирует вебхуки и автоматически обнаруживает новые коммиты — никаких действий на каждый коммит от вашей команды не требуется.
В стандартном режиме приложение читает только хеш коммита HEAD каждого отслеживаемого репозитория. Оно никогда не читает рабочее дерево, диффы или содержимое файлов.
Шаг 2 — (Необязательно) Переключитесь в режим Enterprise ZK
Если даже хеш коммита, покидающий вашу сеть, — это слишком много, режим Enterprise ZK заменяет путь через вебхук коротким GitHub Action, который выполняется на ваших собственных раннерах. Он отправляет только хеш — сервис вообще не получает доступа на чтение к исходному репозиторию.
name: Timestamp commit hash
on:
push:
jobs:
anchor:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Push HEAD hash to Timestamp GIT
env:
TSGIT_API_KEY: ${{ secrets.TSGIT_API_KEY }}
run: |
HASH=$(git rev-parse HEAD)
# POST $HASH + repo metadata to the Timestamp GIT API.
# The workflow is generated for you by the Enterprise setup wizard
# at https://timestampgit.dev/enterprise/{phase}.
Вот и вся поверхность: один хеш, один аутентифицированный запрос.
Шаг 3 — Позвольте ночному cron-воркеру выполнить закрепление
Здесь вы ничего не делаете. Каждую ночь воркер:
- Группирует все ожидающие хеши коммитов из очереди в памяти.
- Строит манифест
.txtдля каждого репозитория. - Нативно конструирует дерево Меркла по пакету.
- Создаёт доказательства OpenTimestamps с помощью публичных календарей OTS.
- Закрепляет корень Меркла в блокчейне Bitcoin.
Смысл в пакетировании — тысяча коммитов по сотне репозиториев стоит одного закрепления.
Шаг 4 — Соберите квитанции .ots и манифесты
После подтверждения в Bitcoin манифест и файлы квитанций .ots отправляются обратно в вашу выделенную ветку timestamps или теневой репозиторий. Подтверждение в Bitcoin обычно занимает около 3 часов, поэтому доказательства появляются через несколько часов после ночного запуска — не мгновенно. Планируйте ожидания соответственно, особенно если демонстрируете это комплаенс-команде.
Шаг 5 — Встройте бейдж верификации
Возьмите сниппет со страницы подключённого репозитория (/connected/{user}/{repo}), который отображает живой предпросмотр Shields.io:
[](https://timestampgit.dev/status/acme/payments-service)
Любой, кто перейдёт по ссылке, попадёт на публичную панель статуса. Приватные репозитории добавляют к URL зашифрованный HMAC — специфичный для экземпляра — так что данные видят только авторизованные зрители.
Шаг 6 — (Альтернатива) Self-host с Docker Compose
Для изолированных сред или сред с максимальным контролем тот же конвейер работает как 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 на место, когда будет предложено.
Как убедиться, что всё сработало: верификация и аудиторские следы
Четыре проверки в порядке возрастания строгости:
1. Панель статуса. Посетите /status/{user}/{repo}, чтобы увидеть долговечность доказательств, самую раннюю дату закрепления, ежедневную регулярность, а также данные блока и транзакции Bitcoin, лежащие в основе каждого пакета. Тепловая карта-календарь делает пробелы очевидными — полезно, когда аудитор спрашивает: «было ли это непрерывно?»
2. Страница верификации. /verification/{user}/{repo}/{date} проведёт вас по многоуровневой цепочке Меркла шаг за шагом. Все вычисления происходят локально в вашем браузере: zero-knowledge, и никто не видит, что вы проверяете. Это страница, которую стоит открыть на встрече, когда кто-то ставит под сомнение метку времени.
3. Аудиторские экспорты. Получите структурированные записи для комплаенса:
# Full audit ledger as CSV
curl -O https://timestampgit.dev/api/audit/acme/payments-service
# PDF certificate for a specific anchored date
curl -OJ https://timestampgit.dev/api/report/acme/payments-service/2026-10-30
# Raw Merkle chain data for local verification
curl https://timestampgit.dev/api/verify/acme/payments-service/2026-10-30
4. Независимая верификация. Поскольку доказательство опирается только на SHA-256 и данные блоков Bitcoin, любой может проверить квитанцию .ots по блокчейну стандартными инструментами верификации OpenTimestamps — офлайн, без Timestamp GIT. Это и есть гарантия независимости от вендора: если компания исчезнет завтра, ваши доказательства всё равно проверяются.
Решение типичных проблем
- Приложение установлено, но ничего не отслеживается. Перепроверьте разрешения: чтение к исходному, чтение-запись к целевому. Режим Enterprise ZK — исключение: ему нужен только доступ на чтение-запись к целевому и никакого доступа на чтение к исходному.
- Доказательства «пропали» после push. Они не пропали. Подтверждение в Bitcoin занимает несколько часов, и файлы доказательств записываются после этого. Проверьте страницу статуса на наличие ожидающих закреплений, прежде чем заводить баг.
- Бейдж возвращает 404 на приватном репозитории. URL содержит зашифрованный HMAC, специфичный для вашего экземпляра сервера. Копируйте ссылку из
/api/badgeLink/{user}/{repo}, а не собирайте её вручную. - Self-hosted контейнер запускается, но мастер настройки падает. Убедитесь, что
./dataсмонтирован правильно и доступен для записи, затем проверьтеdocker compose logs -f timestampgit. Большинство сбоев при первом запуске — это проблема разрешений или тома, а не приложения.
FAQ
Могу ли я по-прежнему переписывать историю Git после использования Timestamp GIT? Да — вы можете делать rebase, amend или force-push локально. Но закреплённые хеши коммитов в Bitcoin остаются неизменными. Любая подделка исходных коммитов становится очевидной, потому что закреплённые в Bitcoin хеши не совпадут с изменённой историей.
Есть ли у Timestamp GIT доступ к моему исходному коду? Нет. В стандартном режиме GitHub App читает только хеш коммита HEAD. В режиме Enterprise ZK GitHub Action отправляет в API только хеш коммита. Ваш исходный код никогда не покидает вашу среду.
Что произойдёт, если Timestamp GIT прекратит работу?
Ваши доказательства не зависят от вендора. Файлы квитанций .ots вместе с данными блокчейна Bitcoin позволяют любому проверить метку времени офлайн стандартными инструментами OpenTimestamps, не полагаясь на Timestamp GIT.
Сколько времени занимает закрепление коммита?
Коммиты пакетируются каждую ночь. После закрепления пакета подтверждение в Bitcoin обычно занимает около 3 часов, а файлы доказательств записываются ещё через несколько часов. Квитанции .ots вы найдёте в ветке timestamps вашего репозитория.
Заключение
Ваш Git-лог — это операционная запись, а не доказательство. Она лежит на инфраструктуре, которую вы контролируете, содержит даты, которые вы можете задать, и может быть переписана любым, у кого есть права на push — именно поэтому аудиторы её не учитывают. Закрепление хешей коммитов в Bitcoin превращает эту запись в нечто вне вашего контроля и вне вашей возможности изменить.
Timestamp GIT делает это, не заставляя ваших разработчиков изучать протокол: установите GitHub App один раз, дайте ночному воркеру выполнить закрепление, встройте бейдж и храните квитанции .ots и аудиторские экспорты для того дня, когда они действительно понадобятся.
Следующий шаг: установите приложение на ваш самый критичный для бизнеса репозиторий уже сегодня. Самое старое закрепление, которое у вас когда-либо будет, — то, которое вы создадите сегодня вечером.
Похожие статьи
- Автоматизация защиты ИС для кода стартапа: руководство для основателя
- Является ли блокчейн-метка времени юридически действительным доказательством?
- Timestamp GIT против OpenTimestamps CLI: что подходит вашей команде?