GitHub App で Git コミットのタイムスタンプを自動化する
あなたのコミットには暗号学的な存在証明がふさわしいと判断したのですね。結構です。ならば運用上、重要な問いはこれだけです:その証明はあなたが意識したときに生成されるのか、それとも誰が意識しようがしまいが毎晩生成されるのか?
タイムスタンプ処理の最初のバージョンはたいてい手動です。チームの誰かがスクリプトを書き、リリース前に実行し、どこかにファイルを保存して、それなりに守られている気になります。6週間後、その人は休暇中で、スクリプトは再イメージングされたノートPCの中にあり、リリースブランチは一度もスタンプされていません。さらに悪いことに、誰も気づきません — タイムスタンプのカバレッジが部分的にしかないリポジトリは、監査人が特定の日付について尋ねるまで、完全にカバーされたリポジトリと見分けがつかないからです。
本記事は自動化の道筋についてです:1回のインストール、コミットごとの儀式なし、開発者マシン上のツールなし。初回セットアップ、git push から Bitcoin ブロックまでの間に実際に何が起きるか、そのパイプラインをどう監視するか、そして自動化が静かに失敗しうる箇所について説明します。
手動タイムスタンプの罠(そして自動化が勝つ理由)
手動タイムスタンプには予測可能な失敗のパターンがあります:規律に比例してスケールするのですが、規律はチーム、リポジトリ、タイムゾーンをまたいでスケールしません。
具体的には、手動アプローチとは対象のコミットごとに CLI ステップや特注スクリプトを実行すること — さらに悪ければ、基盤となる Bitcoin トランザクションデータを手作業で組み立てること — を意味します。それは困難な方法であり、3つの箇所で破綻します:
- コミット単位である。 週に100コミットあれば、ステップを飛ばす機会が100回になります。
- 環境依存である。 スクリプトはリポジトリの履歴ではなく、誰かのマシン上に存在します。新入社員は持っておらず、CI もデフォルトでは持っていません。
- ポリシーとして検証できない。 コンプライアンス部門は、タイムスタンプの欠落がその日に何もなかったためなのか、誰かが忘れたためなのかを判別できません。
開発者にとって要件はシンプルです:自分のワークフローでは何も変わらないこと。 コンプライアンスにとっても要件は同じくシンプルです:監視対象のすべてのリポジトリのすべてのコミットがカバーされ、それを証明できること。
これが、CLI ではなく GitHub App を自動化の接点とする理由です。Timestamp GIT の GitHub App は組織レベルで一度インストールすれば、選択したリポジトリへのすべてのコミットを監視し、全員が帰宅したずっと後に、毎晩それらを Bitcoin にアンカーします。
初回セットアップ:GitHub App をインストールして忘れる
セットアップは1回だけで、各開発者ではなく管理者が行います。
- App をインストールする(GitHub 組織または個人アカウント上)。
- 監視するリポジトリを選択する。リポジトリごとの設定ファイルも、CI の変更も、開発者マシンへのインストールもありません。
- 権限を付与する。GitHub の権限システムには「コミットハッシュのみ」というスコープがないため、App にはソースリポジトリへの読み取り専用アクセスと、証明が書き込まれるターゲットリポジトリへの読み書きアクセスが必要です。その読み書きターゲットは、同じリポジトリ内の専用
timestampsブランチか、別のシャドウリポジトリのいずれか — お好みで選べます。 - 完了。 以降、検出は GitHub webhook 経由で実行され、チームには何も要求されません。
より厳格な分離モデルを望むなら、Enterprise ZK モードは webhook 検出を、自社インフラ上で実行される12行の GitHub Action に置き換えます。この Action はコミットハッシュのみを Timestamp GIT API にプッシュします。このモードでは、サービスはソースリポジトリへの読み取りアクセスを一切必要とせず、証明を受け取るターゲットリポジトリへの読み書きアクセスのみを必要とします。もちろん、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 ページから氏名、会社名、メールアドレス、任意で電話番号を提出して申請します。
自動化パイプラインの内部:コミットから Bitcoin アンカーまで
インストール後、パイプラインは設計上ありふれたものです。それが要点です —退屈であるべきなのです。
1. コミット検出。 GitHub App は webhook 経由で新しいコミットを捕捉します。Enterprise ZK モードでは、代わりに GitHub Action がハッシュを API にプッシュします。いずれの場合も、移動するのはコミットハッシュだけです。
2. ハッシュキュー。 ハッシュはインメモリのキーバリューストアに格納され、次のバッチを待ちます。これは意図的なもので、数百のコミットを1つの Bitcoin アンカーにバッチ化することが、所有するすべてのリポジトリで実行するのに十分安価にする秘訣です。
3. 深夜の cron ワーカー。 毎晩、ワーカーが保留中のすべてのハッシュをグループ化し、リポジトリごとのマニフェストファイル(.txt)を書き込み、Merkle ツリーをネイティブに構築し、公開 OTS カレンダーに対して OpenTimestamps 証明を作成し、Merkle ルートを Bitcoin ブロックチェーンにアンカーします。
4. 証明の配信。 マニフェストと .ots レシートファイルはリポジトリにプッシュで戻されます — 専用の timestamps ブランチまたはシャドウリポジトリへ。Bitcoin の承認には通常約3時間かかるため、証明の書き込みは通常バッチ開始から数時間後に完了します。
ZK モードが行う API 呼び出しは次のようになります({hash} セグメントは署名付き URL の HMAC 値であり、コミットハッシュではありません):
curl -X POST \
"https://timestampgit.dev/api/timestamp/acme/payments-api/proofs/<hmac>/<commit-sha>/<commit-id>"
このペイロードに含まれないものに注目してください:diff も、ファイル内容も、ブランチ名も、コミット ID が示す以上の作者情報もありません。ここでのゼロ知識セキュリティはマーケティング用語ではありません — サービスはソースコードを一切見ず、コピーせず、保存せず、Git ハッシュのみを扱います。
そして、開発者に要求されないものにも注目してください:コマンドも、フックも、フラグもありません。いつも通りプッシュするだけです。証明は翌朝に現れます。
監視と障害対応:証明の信頼性を保つ
観測できない自動化は、手順が増えただけの希望にすぎません。可視性には3つのレベルがあり、すべてを使うべきです。
公開ステータスダッシュボード
監視対象の各リポジトリには https://timestampgit.dev/status/{user}/{repo} のステータスページが用意され、証明の存続期間(カバレッジがどこまで遡るか)、最も古いアンカー日、毎日の規則性、Bitcoin ブロックとトランザクションデータ、カレンダーヒートマップを表示します。ヒートマップはギャップを見つける最速の方法です:1日欠けていればすぐに目立ちます。
README バッジ
https://timestampgit.dev/connected/{user}/{repo} から埋め込みウィジェットを取得すると、ライブの Shields.io プレビューとコピー&ペースト可能な Markdown が得られます。バッジは誰でも確認できる公開検証ページにリンクします — 顧客や監査人にアカウント作成なしでカバレッジを確認してもらいたいときに便利です。
# Returns badge URLs and ready-to-paste markdown snippets
curl https://timestampgit.dev/api/badgeLink/acme/payments-api
プライベートリポジトリにも対応しています:その URL はサーバーインスタンス固有の暗号化された HMAC を伴うため、認可されたユーザーのみがステータスを読めます。
プログラムによる監視と監査エクスポート
公開ステータスエンドポイントは、自社ツールからポーリングされるように設計されています:
# Last anchored Bitcoin block info (JSON)
curl https://timestampgit.dev/api/statusLast/acme/payments-api
# Total committed / stamped commit count (JSON)
curl https://timestampgit.dev/api/statusCount/acme/payments-api
# Combined summary used by Shields.io
curl https://timestampgit.dev/api/statusSummary/acme/payments-api
コンプライアンス報告には、GET /api/audit/{user}/{repo} で監査台帳全体を CSV として取得し、GET /api/report/{user}/{repo}/{date} で日次 PDF 証明書を取得します。
実行が失敗したとき
夜間実行が遅延または失敗した場合、保留中のハッシュはキューに残り、次のバッチに繰り越されます — コミットが捨てられることはありません。実際には、問題の症状はデータの喪失ではなく、ステータスヒートマップの平坦な区間として現れます。2か所で監視してください:セルフホストインスタンスでは docker compose logs -f timestampgit、SaaS ではダッシュボードです。
自動コミットタイムスタンプのベストプラクティス
自動化はコミットごとのコストを取り除くため、適切なデフォルトが変わります:カバレッジは厳選ではなく広範であるべきです。
- IP を含むすべてのリポジトリを監視する。 「重要な」リポジトリを選別することは、自動化を装った手動の判断です — そして飛ばしたリポジトリこそが、必ず重要だと判明するものです。リポジトリを1つ増やす限界コストは、既存バッチに夜間ハッシュが1つ加わるだけです。
- 機密性の高いコードベースには Enterprise ZK モードを使う。 ポリシー上、コミットハッシュ自体が第三者を経由すべきでないなら、GitHub Action の経路はハッシュ以外のすべてを自社の境界内に保ちます。完全に分離された環境では、Docker セルフホストライセンスが同じ範囲をカバーします。
- 監査台帳を定期的にエクスポートする。 法務文書と同じフォルダにある CSV は、紛争時に忘れてしまうダッシュボードのログインより優れています。
- 監視対象ブランチでは早く頻繁にコミットする。 多数の小さなコミットは、リリース時に1つの大きなスカッシュを行うよりも、日付の立証がしやすい密な証明の軌跡をもたらします。
- 先行技術として依拠するブランチでは履歴の書き換えを避ける。 force-push は新しいハッシュを生み出します。古いハッシュはアンカーされたままですが、「このコード」と「この証明」の対応関係を弁護士に説明するのが難しくなります。書き換えが避けられない場合は、書き換え前の状態にまずタグを付けましょう。
- 証明ブランチをソースブランチから分離しておく。
timestampsブランチやシャドウリポジトリは生成物です — 読み取り専用として扱えば、mainへの誤ったマージを避けられます。
覚えておくべき境界が1つあります:バッチ処理と約3時間の Bitcoin 承認により、午後5時のコミットは午後5時5分には証明できません。今日証明が必要なら、即時決済を期待するのではなく、夜間の時間枠を前提に計画してください。
FAQ
コミットのタイムスタンプを取るために、開発者はコマンドを実行したりツールをインストールしたりする必要がありますか?
いいえ。GitHub App をインストールすれば、監視対象リポジトリへのすべてのコミットは自動的に検出され、毎晩 Bitcoin にアンカーされます。開発者はいつも通り Git を使い続けます — CLI も手動ステップもありません。
コミットからどれくらいでタイムスタンプ証明が利用可能になりますか?
コミットはバッチ化され、1晩に1回アンカーされます。バッチが送信された後、Bitcoin の承認には通常約3時間かかるため、証明は通常翌朝に利用可能になります。
Timestamp GIT に依存せずにタイムスタンプを検証できますか?
はい。.ots レシートファイルと Merkle 証明はベンダー非依存です — SHA-256 と Bitcoin ブロックデータであり、独自形式ではありません。ダウンロードして標準の OpenTimestamps ツールで Bitcoin ブロックチェーンに対して検証するか、すべての計算をブラウザ内でローカルに行うブラウザ内検証ページを使えます。このローカル検証については別途読む価値があります:ブラウザで Bitcoin タイムスタンプ証明を検証する方法をご覧ください。
リポジトリがプライベートだったり、機密コードを含んでいたりする場合は?
Timestamp GIT はソースコードを一切読み取りも保存もしません — 処理されるのはコミットハッシュのみです。より厳格な分離には、Enterprise ZK モードの GitHub Action が自社インフラからハッシュのみをプッシュするか、Docker でセルフホストできます。他のアプローチとのトレードオフを検討しているなら、Timestamp GIT の代替案:まず比較すべきことが比較の観点を扱っています。
複数の GitHub 組織を使っている場合は?
各組織に App をインストールし、必要なリポジトリを監視します。ダッシュボードは監視対象のすべてのリポジトリを1か所に集約します。
結論
タイムスタンプの価値は、それが要求する注意の量に反比例します。手動で生成した証明は、覚えていたコミットに対してのみ存在する証明です — 監査では、それは保護されたプロセスではなく一貫性のないプロセスとして映ります。
GitHub App のインストールは管理者の1セッションで済みます。その後は、監視対象リポジトリへのすべてのコミットが、あなたが眠っている間にハッシュ化され、バッチ化され、Merkle ルート化され、Bitcoin にアンカーされます。公開の信頼性のためのバッジ、コンプライアンスのための CSV 台帳、あらゆるベンダーより長く残る .ots レシートも揃います。開発者は何も変えません。
手作業をやめる準備はできましたか? 組織に GitHub App をインストールしましょう — 公開リポジトリは無料、プライベートリポジトリとハッシュのみのワークフロー向けに Pro Agency と Enterprise ZK の各ティアがあります。
関連記事
- CLI なしの OpenTimestamps:マネージド Bitcoin タイムスタンプ
- ブラウザで Bitcoin タイムスタンプ証明を検証する方法
- コマンドラインなしで Git コミットにタイムスタンプを付ける方法