あなたのGitログが証拠にならない理由 — そして改ざん不可能にする方法
具体的な問いを自分に投げかけてみてください。弁護士、監査人、あるいはパテント・トロールの代理人から「特定のコミットが特定の日に存在したことを証明してほしい」と言われたら、あなたは実際に何を渡しますか?
git log のスクリーンショット? GitHubアクティビティのエクスポート? どちらもあっさり退けられます。Bitcoinを使った本物のGit履歴改ざん証明を求めるなら、答えは「より良いエクスポート」ではなく、あなた自身を含む誰も日付を遡らせたり改変したりできないタイムスタンプです。このガイドでは、あなたのログがなぜ証拠として機能しないのかという仕組みを解説し、その後、改ざん証跡を備えたものにするための具体的な手順を説明します。GitHub Appが夜間に処理をこなします。
あなたのGitログが改ざん不可能でない理由(そしてコンプライアンスにとってそれが何を意味するか)
Gitは内容アドレス指定方式を採用しているため、人々は履歴が不変だと錯覚します。そうではありません。すべてのコミットハッシュはツリー、親、メッセージ、メタデータのハッシュですが、それらのハッシュの連鎖は、あなたが管理していないサーバー上のリポジトリに存在します。証拠能力を損なう3つの要因があります。
- 履歴は設計上書き換え可能です。
git rebase、git commit --amend、force-pushはコミットを新しいハッシュに置き換えます。古いオブジェクトはガベージコレクションまで残り、その後消えます。プッシュ権限を持つメンテナーは、数か月分の履歴を1分で書き換えられます。 - 日付は自己申告です。 作者とコミッターのタイムスタンプは、単に設定できるメタデータにすぎません。時刻を記録する内部ログは、それを書いたマシンと同じ程度にしか信頼できません。
- ログは他人のインフラ上に存在します。 あなたのGitHub組織、CIデータベース、社内wiki — すべて編集可能で、すべてあなたの管理下にあります。法的監査では、それらは「自己に都合の良い」証拠となり、容易に異議を唱えられます。
最後の点は、開発者が予想する以上に重要です。あなたが変更できた記録は、相手方が「あなたが変更した」と主張する記録です。解決策はより多くのログではなく、単一の当事者が書き換えられないシステムに証明を外部化することです。
これが暗号学的先行技術の考え方です。Gitがすでに生成するフィンガープリント(コミットハッシュ)を取得し、バッチ化し、そのバッチを再度Merkleツリーにハッシュ化し、ルートをOpenTimestampsプロトコル経由でBitcoinブロックチェーンにアンカーします。誰かがあなたのリポジトリを書き換えることはできても、Bitcoinブロックを書き換えることはできません。
Timestamp GITはこのチェーン全体を自動化します — CLIツールも、OpenTimestampsコマンドも、開発者ワークフローの変更も不要です。より深い背景については、特許なしでソフトウェアアイデアの先行技術を証明する方法とブロックチェーンタイムスタンプは法的に有効な証拠かをご覧ください。
前提条件:最初のコミットをアンカーする前に必要なもの
- GitHubリポジトリ(パブリックまたはプライベート)で、管理者権限を持ち、Timestamp GIT GitHub Appをインストールできること。
- Timestamp GITアカウント — オープンソース/パブリックリポジトリは無料、プライベートリポジトリはPro Agency(月額$49)、GitHub ActionsモードはEnterprise ZK(月額$199)。
- 証明用のターゲットリポジトリ。 同じリポジトリ内のブランチ、または別のシャドウリポジトリのいずれか。GitHubの権限モデルでは、ソースリポジトリへの少なくとも読み取り専用アクセス(「コミットハッシュのみ」というスコープはありません)と、ターゲットへの読み書きアクセスが必要です。
- Enterprise ZKモードの場合: GitHub ActionsワークフローとAPIキー。ここではターゲットリポジトリへの読み書きアクセスのみが必要で、ソースリポジトリへの読み取りアクセスは一切不要です。
- セルフホストの場合: DockerとDocker Compose、およびDockerライセンスページから取得した期間限定のデモライセンス。
開発者のマシンには何もインストールされません。
ステップバイステップ:Timestamp GITでGit履歴を改ざん不可能にする
ステップ1 — GitHub Appをインストールし、リポジトリを接続する
組織にTimestamp GIT GitHub Appをインストールし、監視するリポジトリを選択します。ソースリポジトリには読み取り専用、ターゲット(ブランチまたはシャドウリポジトリ)には読み書きアクセスを付与します。アプリはwebhookを登録し、新しいコミットを自動的に検出します — チームによるコミットごとの操作は不要です。
Standardモードでは、アプリは監視対象の各リポジトリのHEADコミットハッシュのみを読み取ります。ワーキングツリー、差分、ファイル内容は一切読み取りません。
ステップ2 — (任意)Enterprise ZKモードに切り替える
コミットハッシュさえネットワーク外に出るのが許容できない場合、Enterprise ZKモードはwebhook経路を、自社ランナー上で実行される短い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}.
接触面はこれだけです。1つのハッシュ、1つの認証済みリクエスト。
ステップ3 — 夜間cronワーカーにアンカーリングを任せる
ここであなたがすることはありません。毎晩、ワーカーが以下を実行します。
- インメモリキューから保留中のすべてのコミットハッシュをグループ化する。
- リポジトリごとにマニフェスト
.txtを構築する。 - バッチ上にネイティブにMerkleツリーを構築する。
- 公開OTSカレンダーを使用してOpenTimestamps証明を作成する。
- MerkleルートをBitcoinブロックチェーンにアンカーする。
バッチ処理が要点です — 100リポジトリにまたがる1000コミットでも、アンカーは1つで済みます。
ステップ4 — .otsレシートとマニフェストを収集する
Bitcoinの確認後、マニフェストと.otsレシートファイルが専用のtimestampsブランチまたはシャドウリポジトリにプッシュされます。Bitcoinの確認には通常約3時間かかるため、証明は夜間実行の数時間後に到着します — 即時ではありません。特にコンプライアンス部門にデモする場合は、これを踏まえて期待値を調整してください。
ステップ5 — 検証バッジを埋め込む
リポジトリ接続ページ(/connected/{user}/{repo})からスニペットを取得します。これはライブのShields.ioプレビューをレンダリングします。
[](https://timestampgit.dev/status/acme/payments-service)
クリックした人は誰でも公開ステータスダッシュボードにたどり着きます。プライベートリポジトリではURLに暗号化されたHMACが付加されます — インスタンス固有のもの — ので、認可された閲覧者だけがデータを見られます。
ステップ6 — (代替)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ライセンスページから取得したデモライセンスを所定の場所に配置してください。
動作を確認する方法:検証と監査証跡
厳密さの順に4つのチェックがあります。
1. ステータスダッシュボード。 /status/{user}/{repo}にアクセスすると、証明の寿命、最古のアンカー日、毎日の規則性、各バッチを支えるBitcoinブロックとトランザクションデータを確認できます。カレンダーヒートマップはギャップを明らかにします — 監査人が「これは継続的だったのか?」と尋ねたときに役立ちます。
2. 検証ページ。 /verification/{user}/{repo}/{date}は、多層Merkleチェーンをステップごとに案内します。すべての計算はブラウザ内でローカルに行われます。ゼロ知識であり、誰もあなたが検証している内容を見ることはありません。タイムスタンプに疑問を呈する人がいる会議で開くべきページです。
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ブロックデータのみに依存するため、誰でも標準のOpenTimestamps検証ツールを使って.otsレシートをブロックチェーンに対して検証できます — オフラインで、Timestamp GITなしで。これがベンダー非依存の保証です。会社が明日消えても、あなたの証明は検証可能なままです。
よくある問題のトラブルシューティング
- Appをインストールしたのに何も監視されない。 権限を再確認してください。ソースは読み取り専用、ターゲットは読み書きです。Enterprise ZKモードは例外で、ターゲットへの読み書きのみが必要で、ソースへの読み取りアクセスは不要です。
- プッシュ後に証明が「見つからない」。 そうではありません。Bitcoinの確認には数時間かかり、証明ファイルはその後で書き込まれます。バグ報告の前に、ステータスページで保留中のアンカーを確認してください。
- プライベートリポジトリでバッジが404を返す。 URLにはサーバーインスタンス固有の暗号化されたHMACが含まれています。手動で構築するのではなく、
/api/badgeLink/{user}/{repo}からリンクをコピーしてください。 - セルフホストのコンテナは起動するがウィザードが失敗する。
./dataが正しくマウントされ書き込み可能であることを確認し、docker compose logs -f timestampgitを確認してください。初回実行時の失敗のほとんどはアプリではなく、権限またはボリュームの問題です。
FAQ
Timestamp GITを使用した後でもGit履歴を書き換えられますか? はい — ローカルでrebase、amend、force-pushができます。しかしBitcoinにアンカーされたコミットハッシュは不変のままです。元のコミットへの改ざんは明らかになります。Bitcoinにアンカーされたハッシュが改変された履歴と一致しないからです。
Timestamp GITは私のソースコードにアクセスできますか? いいえ。Standardモードでは、GitHub AppはHEADコミットハッシュのみを読み取ります。Enterprise ZKモードでは、GitHub ActionがコミットハッシュのみをAPIにプッシュします。ソースコードがあなたの環境から出ることはありません。
Timestamp GITが事業を停止したらどうなりますか?
あなたの証明はベンダー非依存です。.otsレシートファイルとBitcoinブロックチェーンデータがあれば、Timestamp GITに依存せず、標準のOpenTimestampsツールを使って誰でもオフラインでタイムスタンプを検証できます。
コミットがアンカーされるまでどのくらいかかりますか?
コミットは毎晩バッチ化されます。バッチがアンカーされた後、Bitcoinの確認には通常約3時間かかり、証明ファイルはさらに数時間後に書き込まれます。.otsレシートはリポジトリのtimestampsブランチにあります。
結論
あなたのGitログは運用記録であり、証拠ではありません。それはあなたが管理するインフラ上にあり、あなたが設定できる日付を含み、プッシュ権限を持つ誰でも書き換えられます — まさにそれが監査人がそれを割り引く理由です。コミットハッシュをBitcoinにアンカーすることで、その記録はあなたの管理外、そしてあなたが改変できないものに変わります。
Timestamp GITは、開発者にプロトコルを学ばせることなくこれを実現します。GitHub Appを一度インストールし、夜間ワーカーにアンカーリングを任せ、バッジを埋め込み、実際に必要になる日のために.otsレシートと監査エクスポートを保管しておくだけです。
次のステップ: 今日、最もビジネスクリティカルなリポジトリにアプリをインストールしてください。あなたが持つ最古のアンカーは、今夜作成するものです。
関連記事
- スタートアップコードのIP保護を自動化する:創業者向けガイド
- ブロックチェーンタイムスタンプは法的に有効な証拠か?
- Timestamp GIT vs OpenTimestamps CLI:あなたのチームに合うのはどちらか?