CLI不要でGitコミットのタイムスタンプを自動化する
暗号学的な先行技術を求めるチームのほとんどは、それを手に入れられません。その理由はほぼ技術的なものではなく、運用上のものです。タイムスタンプを取る習慣は、人間が正しいタイミングで正しいコミットに対してツールを実行し、その証明を18か月後に監査人が見つけられる場所に保存することを覚えていて初めて機能します。締め切りのプレッシャーの中で、最初に失われるのがこの習慣です。
この記事は、その習慣自体をなくすことについてです。「タイムスタンプのコマンドをもっと頻繁に実行する方法」ではなく、監視対象のリポジトリのすべてのコミットを、チームの誰もコマンドを一切入力せずに、毎晩自動でBitcoinブロックチェーンにアンカーする方法です。生のプロトコルを学ぶ価値があるか、マネージドなGitHub Appを使うべきかを評価している場合は、そのトレードオフを別記事 OpenTimestamps vs Timestamp GIT: Manual Proofs or GitHub App? で扱っています。ここでは、自動化を望むと決めた前提で進めます。
手動タイムスタンプの罠(そして抜け出したい理由)
手動のタイムスタンプが実際にどう進むか想像してみてください。
- 誰かがフィーチャーブランチを終え、このコミットにタイムスタンプを付けるべきだったと(たいてい事後に)思い出す。
- ツールを実行して待ち、証明ファイルを受け取る。
- その証明は名前を変えられ、
proofs/フォルダに置かれ、コミットされるか、さらに悪い場合はマネージャーにメールで送られる。 - 次の40コミットでは、スプリントが忙しくなったという理由で誰もこれをやらない。
生のOpenTimestamps CLIは存在しますが、これは難しいやり方です。バッチ処理、証明ファイル、カレンダーとのやり取り、ファイル管理をすべて自分で担う専門家向けの道です。動きます。ただし、誰かが永遠に規律を保つことに依存しており、コミット 4f9c1ab には証明があり、コミット 8d2e0f3 にはない理由を説明する監査証跡を残しません。
コンプライアンス上の失敗は、単なる不便さより深刻です。穴の空いた先行技術の記録は、弁護士が突つける記録です。取引相手から「3月14日時点であなたのコードベースがどうだったか証明してください」と問われ、答えがスプレッドシートと開発者の記憶だとしたら、その時点でフレーミングに負けています。手動プロセスは監査も困難です。一貫した成果物も、定期的なケイデンスもなく、コンプライアンスレビュアーがエンジニアに自分の履歴を再構成させることなくカバレッジを確認する方法もありません。
自動化の約束は、程度の差ではなく種類の違いです。一度インストールすれば、その瞬間から監視対象リポジトリへのすべてのコミットがフィンガープリントされ、毎晩アンカーされます。学ぶべきCLIも、手作業でファイルする証明も、開発者のマシンにインストールするものもありません。証明の記録は、誰かの勤勉さの性質ではなく、リポジトリの性質になります。
一度きりのセットアップ:GitHub Appをインストールして忘れる
主要な方法は GitHub App です。リポジトリ単位または組織全体にインストールでき、セットアップは本当に一度きりです。リポジトリごとのスクリプトも、開発者のオンボーディング手順もありません。
Standardモード(GitHub App)。 Appは監視対象の各リポジトリのHEADコミットハッシュを自動で読み取ります。GitHubの権限モデルには「コミットハッシュのみ」というスコープがないため、Appはソースリポジトリへの少なくとも読み取り専用アクセスを必要とします。また、証明が書き込まれるターゲットリポジトリへの読み書きアクセスも必要です。ソースと同じリポジトリ内の専用のtimestampsブランチか、別のシャドウリポジトリです。
Enterprise ZKモード。 12行のGitHub Actionが自社インフラ上で実行され、コミットハッシュだけをTimestamp GIT APIにプッシュします。このモードでは、サービスはソースリポジトリへの読み取りアクセスを一切必要とせず、証明配信用のターゲットリポジトリへの読み書きアクセスのみを必要とします。そしてワークフローにActionをインストールします。ポリシー上の理由でソースコードの読み取りアクセスが論外である場合や、セキュリティレビューでハッシュが自社の境界内で生成されることを要求する場合に選びます。可動部分を最小限にしたい場合はStandardモードを選びます。
| Standard(GitHub App) | Enterprise ZK(GitHub Action) | |
|---|---|---|
| ソースリポジトリへのアクセス | 読み取り専用 | なし |
| ターゲットリポジトリへのアクセス | 読み書き | 読み書き |
| ハッシュの生成元 | App | 自社のCIランナー |
| セットアップの手間 | Appをインストール | Appをインストール + Actionを追加 |
どちらのモードでも、開発者のマシンには何もインストールされません。エンジニアは今日と同じようにコミットし続け、パイプライン全体はサーバー側で実行されます。サービスはソースコードを見ることも、コピーすることも、保存することも一切なく、扱うのはコミットハッシュだけです。
すべてを自社ネットワーク内で実行する必要がある場合、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ページから申請できます。デプロイについては Self-Host Git Timestamping With Docker Compose で詳しく扱っています。
自動パイプライン:コミットからBitcoinアンカーまで
Appをインストールすると、あなたなしで次のことが起こります。
- コミット検出。 GitHub AppがWebhook経由で新しいコミットを拾うか、GitHub ActionがコミットハッシュをAPIにプッシュします。移動するのはハッシュだけです。
- ハッシュキュー。 コミットハッシュはインメモリのキーバリューストアに入り、夜間バッチを待ちます。
- 深夜のcronワーカー。 毎晩、ワーカーが保留中のハッシュをすべてグループ化し、リポジトリごとにマニフェストテキストファイルを書き、Merkleツリーをネイティブに構築し、公開OTSカレンダーを使ってOpenTimestamps証明を作成し、MerkleルートをBitcoinブロックチェーンにアンカーします。
- 証明の配信。 マニフェストと
.ots証明ファイルはリポジトリにプッシュで戻されます。専用のtimestampsブランチまたはシャドウリポジトリで、証明が説明対象のコードの隣に存在します。
実用的なタイミングの注意点:Bitcoinの承認には数時間、通常は約3時間かかります。そのため火曜日に行われたコミットの確定した証明は、火曜日の夜ではなく水曜日の朝になります。これは公開された不変の台帳にアンカーするコストであり、支払う価値のあるコストです。
これをすべて信じる必要はありません。監視対象の各リポジトリには公開ステータスダッシュボードがあり、証明の寿命、最古のアンカー日、毎日の規則性、各アンカーの背後にあるBitcoinブロックとトランザクションデータ、そして目視で穴を確認できるカレンダーヒートマップを表示します。同じページでは監査用CSVとPDF証明書をダウンロードできます。検証自体は /verification/{user}/{repo}/{date} で行われ、多段のMerkleチェーンを段階的にたどります。そしてその計算はすべてブラウザ内でローカルに行われるため、検証内容を誰かに見られることはありません。
README向けには、埋め込み可能なバッジが検証ステータスを公開表示し、誰でもバッジのリンクをたどってサイト上でタイムスタンプを検証したり、PDFレポートをダウンロードしたりできます。
ステータスを自社のダッシュボードに組み込むための公開APIは、あえて地味な作りです。
# Last anchored Bitcoin block info
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api
# Total committed/stamped commit count
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api
# Combined summary (what the Shields.io badge consumes)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api
そしてコンプライアンスから成果物を求められたとき、金曜日の夕方5時にUIをクリックして回る必要はありません。
# Full audit ledger as CSV
curl -sL -o audit-acme-payments-api.csv \
https://timestampgit.dev/api/audit/acme/payments-api
# PDF certificate for a specific day
curl -sL -o certificate-2026-11-14.pdf \
https://timestampgit.dev/api/report/acme/payments-api/2026-11-14
バッジのURLと貼り付け可能なMarkdownは /api/badgeLink/{user}/{repo}(認証あり)から取得できます。プライベートリポジトリの場合、ステータスURLにはサーバーインスタンス固有の暗号化されたHMACが含まれるため、認可されたユーザーだけが読み取れます。
監視と障害対応:自動化を誠実に保つ
監視していない自動化は、動いているか分からない自動化です。習慣化する価値のあることが3つあります。
エラーではなく、穴を監視する。 夜間実行が失敗するとシステムはリトライし、保留中のハッシュは破棄されずインメモリキューに残ります。しかしキューの深さやリトライは内部的なもので、実際に読めるのはステータスページのカレンダーヒートマップです。欠けた日はグリッドの穴としてすぐに分かります。
ポーリングしてアラートを出す。 最新のステータスペイロードを前日のスナップショットと比較する小さなスケジュールジョブは、監査人より先にパイプラインの停止を検知します。
import json, pathlib, requests
REPO = "acme/payments-api"
URL = f"https://timestampgit.dev/api/statusSummary/{REPO}"
snapshot = pathlib.Path("last-status.json")
r = requests.get(URL, timeout=30)
r.raise_for_status()
current = r.json()
previous = json.loads(snapshot.read_text()) if snapshot.exists() else None
if previous == current:
print("WARNING: status unchanged since last poll - check the repo status page")
else:
print("new anchor data:", json.dumps(current))
snapshot.write_text(json.dumps(current, indent=2))
CIで1時間ごとに実行するか、cronの時間帯の直後に毎日実行し、警告を人間が見る場所にルーティングします。
承認遅延を考慮して監査を計画する。 cronワーカーの実行後、Bitcoinへのアンカーには数時間かかるため、「昨夜のリリースのすべてにタイムスタンプを付けて、10分で証明書が必要」という要求は誰にも満たせません。コンプライアンスにはシンプルなルールを伝えましょう。日 N の証明は日 N+1 までに確定する、と。
障害対応で心強いのは、サービスが完全に利用不能になった場合に何が起こるかです。検証に当社は不要です。.ots 証明ファイルは、標準のOpenTimestamps検証ツールを使ってBitcoinブロックチェーンに対してオフラインで検証できます。証明はSHA-256とBitcoinブロックデータだけに依存しており、独自技術もロックインもありません。ベンダーが消えても、証明は残ります。
手放しタイムスタンプのベストプラクティス
- 早く、頻繁にコミットする。 すべてのコミットが自動でフィンガープリントされるため、密なコミット履歴は密な先行技術の記録を生みます。特許出願の前夜に1か月分の作業を1コミットにまとめると、200個ではなく1個のアンカーしか得られません。
- セキュリティ態勢に合ったモードを選ぶ。 ソースリポジトリの読み取りアクセスが選択肢にない場合はEnterprise ZKモードを使います。GitHub Actionがプッシュするコミットハッシュだけが自社インフラの外に出ます。
- 監査台帳と証明書を定期的にエクスポートする。 コンプライアンスのアーカイブは、誰かがダウンロードリンクを覚えていることに依存すべきではありません。毎月
/api/audit/{user}/{repo}を、マイルストーンの日付には/api/report/{user}/{repo}/{date}を叩き、結果を法務成果物の保管場所に保存します。 - バッジをREADMEに載せる。 顧客へのシグナル以上の意味があり、ライブの検証バッジは「我々は独自に開発した」という主張に対する安価な抑止力になります。
- 証明は専用ブランチかシャドウリポジトリに置く。 毎日の証明コミットを専用のtimestampsブランチに着地させることで、メイン履歴を読みやすく保ちながら、証拠を同じリポジトリに紐付けられます。
- プロセスを文書化する。 監査人のために、誰がGitHub Appをインストールしたか、どのリポジトリが監視対象か、timestampsブランチがどこにあるかを記録します。数学は検証可能ですが、保管の連鎖には依然として一段落の説明が必要です。
FAQ
開発者のマシンにソフトウェアをインストールする必要はありますか?
いいえ。Timestamp GITはGitHub App経由ですべてサーバー側で動作するマネージドサービスです。開発者はいつも通りコミットするだけで、CLIツールやローカルインストールは不要です。
コミットにタイムスタンプが付くまでどのくらいかかりますか?
コミットは毎晩バッチ処理され、Bitcoinにアンカーされます。Bitcoinの承認には通常約3時間かかるため、証明は通常、夜間cronの実行から数時間後に利用可能になります。
サービスなしで証明を検証できますか?
はい。不変の .ots 証明ファイルを受け取り、標準のOpenTimestampsツールを使ってBitcoinブロックチェーンに対してオフラインで検証できます。証明はベンダー非依存で、SHA-256とBitcoinブロックデータだけに依存します。
プライベートリポジトリを使う場合はどうなりますか?
GitHub Appはプライベートリポジトリでも動作します。プライベートリポジトリのステータスURLにはサーバーインスタンス固有の暗号化されたHMACが含まれるため、認可されたユーザーだけがステータスを閲覧できます。
まとめ
先行技術の記録の価値は、必要なときに存在することにあり、それは人間がコマンドを覚えていることに依存できないという意味です。GitHub Appを一度インストールすれば、監視対象リポジトリのすべてのコミットがキューに入り、深夜にバッチ処理され、Merkleルート化され、Bitcoinにアンカーされます。証明は自分が所有するブランチにプッシュで戻され、確認できるステータスダッシュボードがあり、監査人向けにCSVとPDFのエクスポートも用意されます。
コードにタイムスタンプを付けてこなかった理由が「いつも面倒な作業に見えたから」だとしたら、その理由はもうなくなりました。timestampgit.dev から始めましょう。リポジトリを接続し、最初の夜間バッチを実行させ、翌朝カレンダーヒートマップを見てください。
関連記事
- OpenTimestamps vs Timestamp GIT: Manual Proofs or GitHub App?
- Self-Host Git Timestamping With Docker Compose
- Cryptographic Prior Art: The Startup Shield Against Patent Trolls