Timestamp GIT

← All posts

2026-11-20

Настройте защиту интеллектуальной собственности одним установлением GitHub App

Настройте защиту интеллектуальной собственности одним установлением GitHub App
timestamp git blockchain proof

Настройка защиты интеллектуальной собственности одним установленным GitHub App

Вам не нужен юридический бюджет, набор CLI-инструментов или изменение того, как ваша команда пишет код, чтобы получить криптографическое доказательство того, что ваш репозиторий существовал в определённый момент времени. Вам нужна одна установка.

Это руководство описывает весь процесс настройки github app for intellectual property protection: установите Timestamp GIT GitHub App, выберите репозитории, позвольте ночной автоматизации пакетировать хеши коммитов и привязывать их к Bitcoin, а затем убедитесь, что доказательство реально. Каждый шаг ниже — это клик, настройка или короткий конфигурационный файл. Ни один разработчик в вашей команде не вводит новую команду, и никакой исходный код никогда не покидает вашу организацию GitHub.

Что вы получите в итоге: неизменяемую квитанцию .ots за каждый день, публичную страницу статуса на основе данных блоков Bitcoin, бейдж в вашем README и CSV-журнал аудита или PDF-сертификат, который можно передать юристу или аудитору.

Почему GitHub App — самый быстрый путь к защите ИС

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

Управляемый способ — одна установка GitHub App. Timestamp GIT построен на тех же криптографических примитивах, но скрывает протокол за автоматизацией:

  • Установка один раз. Никакого CLI, локальных инструментов, ничего не нужно устанавливать на машины разработчиков.
  • Автоматическое обнаружение. Каждый новый коммит в отслеживаемый репозиторий улавливается через вебхуки.
  • Ночная привязка. Хеши пакетируются в полночь, объединяются в корень Меркла и привязываются к Bitcoin через OpenTimestamps.
  • Доставка обратно вам. Манифесты и квитанции .ots попадают в выделенную ветку или отдельный теневой репозиторий.
  • Zero-knowledge. Обрабатываются только хеши коммитов. Ваш исходный код никогда не читается, не копируется и не хранится.

Если перед началом работы с настройками вы хотите понять стратегический контекст того, почему это важно с юридической точки зрения, прочитайте Prove Prior Art Before You File: A Founder’s Guide. Эта статья сосредоточена на настройке.

Предварительные требования: что нужно перед началом

  • Учётная запись GitHub с правами администратора на репозиторий — или организацию — который вы хотите защитить. Вы не можете установить GitHub App на репозиторий, к которому у вас есть только доступ на запись.
  • Учётная запись Timestamp GIT. Уровень Open Source бесплатен для публичных репозиториев; для приватных репозиториев требуется платный план.
  • Базовое понимание Git. Вы должны знать, что у коммита есть хеш SHA-1 или SHA-256. Это весь объём знаний по криптографии, который требуется.
  • Решение о том, где хранятся доказательства. В том же репозитории на выделенной ветке или в отдельном теневом репозитории. Теневой репозиторий сохраняет основной репозиторий чистым, но требует целевого репозитория, на который вы можете выдать доступ на запись.
  • Опционально: Docker. Только если вы планируете развернуть самостоятельно позже — это описано в отдельном разделе.

Шаг 1: Установите Timestamp GIT GitHub App

  1. Перейдите на timestampgit.dev и войдите через GitHub.
  2. Нажмите Install GitHub App.
  3. Выберите All repositories или Only select repositories, затем выберите репозитории, которые хотите отслеживать.
  4. Просмотрите разрешения, которые показывает GitHub. В стандартном режиме приложению нужны:
    • Доступ только на чтение к вашим исходным репозиториям — GitHub не предлагает доступ только к хешам коммитов, поэтому доступ на чтение является минимумом.
    • Доступ на чтение и запись к целевому репозиторию, куда записываются доказательства.
  5. Подтвердите. Вы попадёте на панель управления со списком подключённых репозиториев.

Вы можете в любой момент вернуться и изменить выбор репозиториев на странице настроек GitHub App; приложению не требуется переустановка, чтобы подхватить новые добавленные репозитории.

Шаг 2: Настройте параметры репозитория

Выберите репозиторий, который вы только что подключили. Здесь важны два решения:

Куда попадают доказательства? Либо в выделенную ветку timestamps в том же репозитории, либо в отдельный теневой репозиторий. Если вы ставите временные метки на репозиторий, который планируете позже открыть, теневой репозиторий держит историю доказательств вне публичного дерева, пока вы не захотите её показать.

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

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

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

Сохраните настройки. Хеши коммитов начнут поступать в очередь немедленно.

Шаг 3: Позвольте автоматизации работать

Здесь делать ничего не нужно, кроме как пушить код. За кулисами:

  1. Обнаружение коммитов — GitHub App видит новые коммиты через вебхуки.
  2. Очередь хешей — хеши коммитов накапливаются в хранилище «ключ-значение» в памяти для пакетирования.
  3. Полуночный cron-воркер — воркер группирует все ожидающие хеши, записывает текстовый файл манифеста для каждого репозитория, нативно строит дерево Меркла, генерирует доказательства OpenTimestamps по публичным календарям OTS и привязывает корень Меркла к Bitcoin.
  4. Доставка доказательств — файлы манифеста и квитанции .ots отправляются обратно в вашу ветку timestamps или теневой репозиторий.

Учитывайте окно подтверждения Bitcoin. Пакет отправляется в полночь, но включение в блок обычно занимает около трёх часов. На практике доказательства для коммита, отправленного сегодня, будут доступны завтра утром.

Снова о принципе zero-knowledge, потому что именно об этом спрашивают аудиторы: сервис всегда работает только с хешами коммитов. Ваш diff, ваши файлы, ваши секреты — ничего из этого не передаётся.

Шаг 4: Добавьте проверочный бейдж в ваш README

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

<!-- Copy the real snippet from timestampgit.dev/connected/{user}/{repo} -->
[![Bitcoin-timestamped](BADGE_URL_FROM_TIMESTAMPGIT)](https://timestampgit.dev/status/your-user/your-repo)

Любой, кто перейдёт по ссылке, попадёт на публичную страницу статуса и сможет самостоятельно перепроверить временную метку по файлу .ots. Именно этот публичный путь проверки по клику превращает проприетарное заявление в доказательство, которое примет третья сторона.

Как убедиться, что всё сработало

Дайте этому одну ночь, затем проверьте три вещи.

1. Страница статуса репозитория. Откройте /status/{user}/{repo}. Вы должны увидеть долговечность доказательств, дату самого раннего якоря, ежедневную регулярность, данные блока и транзакции Bitcoin для каждого якоря, а также календарную тепловую карту. Пробел в тепловой карте означает день без коммитов — это не сбой.

2. API, если вы хотите видеть это на дашборде.

# Last anchored Bitcoin block
curl https://timestampgit.dev/api/statusLast/your-user/your-repo

# Total stamped commit count
curl https://timestampgit.dev/api/statusCount/your-user/your-repo

# Full audit ledger as CSV
curl -O https://timestampgit.dev/api/audit/your-user/your-repo

3. PDF-сертификат для конкретной даты. Скачайте его для любого дня с привязкой:

curl -O https://timestampgit.dev/api/report/your-user/your-repo/2026-11-19

Полное пошаговое описание того, как на самом деле выглядит проверка цепочки Меркла — всё вычисляется локально в вашем браузере — см. в How to Verify a Bitcoin Timestamp Proof for Your Code. Короткая версия: файл .ots и манифест — это стандартные доказательства OpenTimestamps, проверяемые по данным блоков Bitcoin любым совместимым инструментом. Никакой привязки к вендору, никакой зависимости от того, продолжим ли мы работать.

Опционально: самостоятельное развёртывание с Docker для изолированных сред

Для максимального контроля — регулируемые среды, изолированные сети или команды, которые хотят разместить сервис на собственной инфраструктуре — 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 и, опционально, номер телефона; вы получите файл лицензии для скачивания. Самостоятельное развёртывание означает управление собственным GitHub App и инфраструктурой, но гарантии zero-knowledge идентичны.

Устранение типичных проблем при настройке

  • Установка не удаётся или разрешения выглядят неправильно. Вам нужны права администратора на репозиторий или организацию, а в стандартном режиме приложению также должен быть предоставлен доступ к целевому репозиторию, куда записываются доказательства. Отсутствующий целевой репозиторий — самая частая причина ситуации «подключено, но ничего не происходит».
  • Нет доказательств через 24 часа. Убедитесь, что в репозиторий действительно поступают коммиты и что приложение не было приостановлено со стороны GitHub. Проверьте страницу статуса на наличие ошибок, прежде чем что-либо оформлять — неактивный репозиторий не создаёт манифест, и это ожидаемое поведение.
  • Бейдж отображается как сломанное изображение. Скопируйте URL бейджа заново со страницы подключённого репозитория. Для приватных репозиториев URL должен содержать зашифрованный HMAC; усечённый URL не сработает.
  • Якорь задерживается. Время блоков Bitcoin варьируется. Задержанное подтверждение всё равно привязывается — как только блок существует, доказательство неизменяемо. Ничего не нужно запускать повторно.
  • Доказательства появляются в неожиданном месте. Проверьте, настроен ли репозиторий на ветку в том же репозитории или на теневой репозиторий; переключение режимов не перезаписывает исторические доказательства.

FAQ

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

Какие разрешения GitHub требуются Timestamp GIT? В стандартном режиме приложению нужен доступ только на чтение к вашим исходным репозиториям (для чтения хешей коммитов) и доступ на чтение и запись к целевому репозиторию, где хранятся доказательства. Корпоративный режим ZK меняет это местами с помощью GitHub Action, который отправляет только хеш коммита из вашей собственной инфраструктуры, поэтому сервису вообще не нужен доступ на чтение к исходному репозиторию.

Сколько времени занимает проставление временной метки коммита в Bitcoin? Хеши коммитов пакетируются и привязываются раз в день в полночь. После отправки пакета в блокчейн Bitcoin через OpenTimestamps подтверждение обычно занимает около 3 часов — поэтому доказательства обычно доступны на следующее утро.

Могу ли я проверить доказательство временной метки независимо, без Timestamp GIT? Да. Файл квитанции .ots и манифест — это стандартные доказательства OpenTimestamps. Вы можете проверить их с помощью любого инструмента, совместимого с OpenTimestamps, по блокчейну Bitcoin, что обеспечивает независимость от вендора.

Установка — это весь проект

Одна установка GitHub App, один выбор репозитория, одна страница настроек. После этого защита ИС становится фоновым свойством вашего репозитория, а не ежеквартальной рутиной: каждый хеш коммита пакетируется каждую ночь, каждый пакет объединяется в корень Меркла и попадает в блок Bitcoin, каждое доказательство записывается обратно в ветку, которую вы контролируете, и проверяется любым человеком с файлом .ots.

Это вся стоимость внедрения. Если вы откладывали защиту prior art, потому что она выглядела как юридический процесс с инженерным налогом, начните с бесплатного уровня Open Source на публичном репозитории сегодня и посмотрите, как первое доказательство появится завтра утром — начните здесь. Для команд, которые сначала оценивают инструменты, Best Tools to Timestamp Source Code for Auditors сравнивает варианты.

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

EU label: AI-generated content