Timestamp GIT

← All posts

2026-10-31

Почему ваш Git-лог — не доказательство, и как сделать его защищённым от подделки

Почему ваш Git-лог — не доказательство, и как сделать его защищённым от подделки
timestamp git blockchain proof

Почему ваш 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-воркеру выполнить закрепление

Здесь вы ничего не делаете. Каждую ночь воркер:

  1. Группирует все ожидающие хеши коммитов из очереди в памяти.
  2. Строит манифест .txt для каждого репозитория.
  3. Нативно конструирует дерево Меркла по пакету.
  4. Создаёт доказательства OpenTimestamps с помощью публичных календарей OTS.
  5. Закрепляет корень Меркла в блокчейне Bitcoin.

Смысл в пакетировании — тысяча коммитов по сотне репозиториев стоит одного закрепления.

Шаг 4 — Соберите квитанции .ots и манифесты

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

Шаг 5 — Встройте бейдж верификации

Возьмите сниппет со страницы подключённого репозитория (/connected/{user}/{repo}), который отображает живой предпросмотр Shields.io:

[![Bitcoin timestamped](https://img.shields.io/endpoint?url=https://timestampgit.dev/api/statusSummary/acme/payments-service)](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 и аудиторские экспорты для того дня, когда они действительно понадобятся.

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

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

EU label: AI-generated content