ベンダーライセンス発行ガイド
このガイドは、ルート鍵を管理し、オンプレミスの顧客へライセンスを発行する ベンダー(Yabanin チーム)向けです。
警告: すべての発行コマンドは、エアギャップされたオフラインのマシンで実行する必要があります。 ルート秘密鍵を、ネットワークに接続されたシステムに触れさせてはいけません。
前提条件
- 発行マシンに Go 1.25 以降がインストールされていること。
yabaninバイナリがビルド済みであること:make unified
ステップ 1 — ルート鍵ペアの生成
# On your air-gapped machine:
./yabanin license gen-root --key-file=/secure/root
# Output (JSON):
# {
# "public_key": "a1b2c3...", # 64 hex chars (32 bytes)
# "private_key": "d4e5f6..." # 96 hex chars (seed, do NOT share)
# }
# This creates two files:
# /secure/root.pub — root public key (safe to distribute)
# /secure/root.priv — root seed (KEEP SECRET, air-gapped only)
ルート秘密鍵は、HSM または暗号化されたオフラインストレージに保管します。 公開鍵は、ビルド時に本番バイナリへ埋め込まれます。
ビルド時の鍵の埋め込み
本番バイナリをビルドするときは、ルート公開鍵を環境変数に設定します。
YABANIN_LICENSE_ROOT_PUBKEY=a1b2c3d4e5f6... \
go generate ./pkg/license/... # generates pkg/license/zz_keys.go
make all # builds binaries with embedded root pubkey
keys_gen.go ツールは、次を含む zz_keys.go を書き出します。
const VendorPublicKey = "a1b2c3d4e5f6..." // 64 hex chars
ステップ 2 — 中間証明書の作成
中間証明書は短命です(通常 90 日)。四半期ごとに、その前に新しいものを生成します。
./yabanin license issue-intermediate \
--root-key=/secure/root.priv \
--validity=90 \
--key-file=/secure/inter-2027q1
# Output (JSON):
# {
# "version": "1",
# "serial": "aabbccdd...", # hex — record this!
# "pub_key": "...", # intermediate public key (hex)
# "root_sig": "...", # root signature over cert
# "expiry": "2027-04-01T00:00:00Z",
# "issued_at": "2027-01-01T00:00:00Z"
# }
# Creates:
# /secure/inter-2027q1.cert — intermediate cert JSON (deploy to customers)
# /secure/inter-2027q1.priv — intermediate private key (keep air-gapped)
serial フィールドを記録してください。 ライセンスの発行時と、中間証明書の失効時に必要です。