Timestamp GIT

← All posts

2026-11-20

GitHub Appを1回インストールするだけでIP保護を設定

GitHub Appを1回インストールするだけでIP保護を設定
timestamp git blockchain proof

単一のGitHub AppインストールでIP保護をセットアップする

法的な予算も、CLIツールチェーンも、チームのコードの書き方を変える必要もなく、リポジトリが特定の時点に存在していたという暗号学的な証明を得ることができます。必要なのは1回のインストールだけです。

このガイドでは、知的財産保護のためのGitHub Appのセットアップ全体を順を追って説明します。Timestamp GIT GitHub Appをインストールし、対象リポジトリを選択し、夜間の自動処理でコミットハッシュをバッチ処理してBitcoinにアンカーさせ、その証明が本物であることを確認します。以下のすべてのステップは、クリック、設定、または短い設定ファイルです。チームの開発者が新しいコマンドを入力することはなく、ソースコードがGitHub組織の外に出ることもありません。

最終的に得られるもの: 毎日の不変な.otsレシート、Bitcoinのブロックデータに裏付けられた公開ステータスページ、READMEのバッジ、そして弁護士や監査人に渡せる監査CSVまたはPDF証明書です。

GitHub AppがIP保護への最速ルートである理由

これを手作業で行うのは大変です — OpenTimestampsツールを手動で実行し、各バッチのBitcoin確認を追跡する必要があります。動作はしますが、エラーが起きやすく、誰か1人が実行を覚えておく必要があり、開発者が5人で1日100コミットになると破綻します。

マネージドな方法は、単一のGitHub Appインストールです。Timestamp GITは同じ暗号学的プリミティブの上に構築されていますが、プロトコルを自動化の背後に隠します:

  • 1回インストールするだけ。 CLIもローカルツールも不要で、開発者のマシンに何もインストールする必要はありません。
  • 自動検出。 監視対象リポジトリへの新しいコミットはすべてWebhook経由で取得されます。
  • 夜間アンカリング。 ハッシュは深夜0時にバッチ処理され、Merkleルート化され、OpenTimestamps経由でBitcoinにアンカーされます。
  • あなたに返却。 マニフェストと.otsレシートは専用ブランチまたは別のシャドウリポジトリに配置されます。
  • ゼロ知識。 処理されるのはコミットハッシュのみです。ソースが読み取られたり、コピーされたり、保存されたりすることはありません。

クリックを始める前に、これが法的に重要である戦略的背景を知りたい場合は、Prove Prior Art Before You File: A Founder’s Guideをお読みください。この記事はセットアップに焦点を当てています。

前提条件: 開始前に必要なもの

  • リポジトリまたは組織に対する管理者権限を持つGitHubアカウント — 保護したいリポジトリまたは組織の管理者権限が必要です。書き込みアクセスしかないリポジトリにはGitHub Appをインストールできません。
  • Timestamp GITアカウント。 オープンソース層は公開リポジトリで無料です。プライベートリポジトリには有料プランが必要です。
  • 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: リポジトリ設定を構成する

接続したリポジトリを選択します。ここでは2つの決定が重要です:

証明はどこに保存されますか? 同じリポジトリ内の専用timestampsブランチ、または別のシャドウリポジトリのいずれかです。後でオープンソース化する予定のリポジトリをタイムスタンプする場合、シャドウリポジトリは公開ツリーに証明履歴を表示したくないときまで隠しておけます。

アンカリングはいつ実行されますか? 深夜0時の夜間実行がデフォルトで推奨設定です — 多数のコミットを1つのMerkleルートにバッチ処理することが、毎日の証明を安価で一貫性のあるものにします。スケジュールをそのままにしておくのがほぼ常に正しい判断です。

次に、バッジの埋め込みコードをコピーします。接続済みリポジトリページ(/connected/{user}/{repo})を開くと、Shields.io検証バッジのライブプレビューと貼り付けるべき正確なMarkdownが表示されます。

プライバシーに関する注意: プライベートリポジトリのステータスURLには、サーバーインスタンス固有の暗号化されたHMACが含まれています。そのため、認可されたユーザーのみがプライベートリポジトリのステータスを読むことができます。URLをコピーする際にそのパラメータを削除しないでください。

設定を保存します。コミットハッシュがすぐにキューに流れ始めます。

ステップ3: 自動化を実行させる

ここですることはコードをプッシュするだけです。舞台裏では:

  1. コミット検出 — GitHub AppがWebhook経由で新しいコミットを検知します。
  2. ハッシュキュー — コミットハッシュがバッチ処理のためにインメモリのキーバリューストアに蓄積されます。
  3. 深夜0時のcronワーカー — ワーカーが保留中のすべてのハッシュをグループ化し、リポジトリごとにマニフェストテキストファイルを書き込み、Merkleツリーをネイティブに構築し、公開OTSカレンダーに対してOpenTimestamps証明を生成し、MerkleルートをBitcoinにアンカーします。
  4. 証明の配信 — マニフェストと.otsレシートファイルがtimestampsブランチまたはシャドウリポジトリにプッシュバックされます。

Bitcoinの確認ウィンドウを見込んでおいてください。バッチは深夜0時に送信されますが、ブロックへの取り込みには通常約3時間かかります。実際には、今日プッシュしたコミットの証明は明日の朝に利用可能になります。

ゼロ知識の点についてもう一度言及します。これは監査人が尋ねる事柄だからです: サービスはコミットハッシュのみを扱います。あなたの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ファイルからタイムスタンプを自分で再検証できます。この公開されたクリックスルー検証パスが、独自の主張を第三者が受け入れる証拠に変えるのです。

動作したことを確認する方法

一晩待ってから、3つのことを確認してください。

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

Merkleチェーン検証が実際にステップバイステップでどのように行われるかの完全なウォークスルー — すべてブラウザ内でローカルに計算されます — については、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ページから氏名、会社名、メールアドレス、任意で電話番号を添えて期間限定のデモライセンスをリクエストしてください。ダウンロード用のライセンスファイルが提供されます。セルフホストは独自のGitHub Appとインフラを管理することを意味しますが、ゼロ知識の保証は同一です。

よくあるセットアップの問題のトラブルシューティング

  • インストールが失敗する、または権限がおかしい。 リポジトリまたは組織に対する管理者権限が必要で、標準モードでは証明が書き込まれるターゲットリポジトリへのアクセスもアプリに付与する必要があります。ターゲットリポジトリの欠落は、「接続されたが何も起きない」の最も一般的な原因です。
  • 24時間経っても証明がない。 リポジトリが実際にコミットを受信していること、GitHub側でアプリが一時停止されていないことを確認してください。何かを報告する前にステータスページでエラーを確認してください — アイドル状態のリポジトリはマニフェストを生成しませんが、これは想定された動作です。
  • バッジが壊れた画像として表示される。 接続ページからバッジURLを再コピーしてください。プライベートリポジトリの場合、URLには暗号化されたHMACを含める必要があります。切り詰めたURLは失敗します。
  • アンカーが遅れている。 Bitcoinのブロック時間は変動します。確認が遅れてもアンカーは行われます — ブロックが存在すれば、証明は不変です。再実行する必要はありません。
  • 証明が予期しない場所に表示される。 リポジトリが同一リポジトリのブランチ用に構成されているか、シャドウリポジトリ用に構成されているかを確認してください。モードを切り替えても過去の証明は書き換えられません。

FAQ

Timestamp GITを使用するためにGitワークフローを変更する必要がありますか? いいえ。GitHub Appをインストールすれば、新しいコミットを自動的に検出し、夜間にアンカーします。開発者は通常どおりGitを使い続けられます — 新しいコマンドやツールを覚える必要はありません。

Timestamp GITにはどのようなGitHub権限が必要ですか? 標準モードでは、アプリはソースリポジトリへの読み取り専用アクセス(コミットハッシュを読むため)と、証明が保存されるターゲットリポジトリへの読み書きアクセスが必要です。エンタープライズZKモードでは、これをGitHub Actionに置き換え、自社インフラからコミットハッシュのみをプッシュするため、サービスはソースリポジトリへの読み取りアクセスをまったく必要としません。

コミットがBitcoinでタイムスタンプされるまでどのくらいかかりますか? コミットハッシュは1日1回深夜0時にバッチ処理され、アンカーされます。バッチがOpenTimestamps経由でBitcoinブロックチェーンに送信された後、確認には通常約3時間かかります — そのため証明は通常翌朝に利用可能になります。

Timestamp GITなしでタイムスタンプ証明を独立して検証できますか? はい。.otsレシートファイルとマニフェストは標準のOpenTimestamps証明です。OpenTimestamps互換の任意のツールを使用してBitcoinブロックチェーンに対して検証でき、ベンダー独立性が確保されます。

インストールがプロジェクトのすべて

1回のGitHub Appインストール、1回のリポジトリ選択、1つの設定ページ。あとはIP保護は四半期ごとの面倒な作業ではなく、リポジトリのバックグラウンド特性になります: すべてのコミットハッシュが毎晩バッチ処理され、すべてのバッチがBitcoinブロックにMerkleルート化され、すべての証明があなたが管理するブランチに書き戻され、.otsファイルを持つ誰でも検証できます。

それが導入コストのすべてです。エンジニアリングの負担が伴う法的手続きのように見えたために先行技術保護を先延ばしにしてきたなら、今日公開リポジトリで無料のオープンソース層を始めて、明日の朝に最初の証明が届くのを確認してください — ここから始める。まずツールの状況を評価したいチームには、Best Tools to Timestamp Source Code for Auditorsが選択肢を比較しています。

関連記事

EU label: AI-generated content