メインコンテンツまでスキップ

ベンダーライセンス発行ガイド

このガイドは、ルート鍵を管理し、オンプレミスの顧客へライセンスを発行する ベンダー(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 フィールドを記録してください。 ライセンスの発行時と、中間証明書の失効時に必要です。

中間証明書をローテーションするとき​

きっかけ対応
有効期限が近い(14 日未満)新しい中間証明書を生成し、新しいトークンを発行する
鍵漏えいの疑い古いシリアルを CRL に追加し、新しいものを生成する
四半期ごとの周期予防的にローテーションする

ステップ 3 — 顧客ライセンストークンの発行​

./yabanin license issue \
--customer="acme-corp" \
--expiry=2027-12-31 \
--inter-key=/secure/inter-2027q1.priv \
--inter-serial=aabbccdd... \
--output=licenses/acme-corp.json

# Output (JSON):
# {
# "v": "1",
# "c": "acme-corp",
# "s": "<license serial>",
# "intermediate": "aabbccdd...",
# "e": "2027-12-31T00:00:00Z",
# "i": "2027-01-01T00:00:00Z",
# "sig": "<signature>"
# }

希望する安全なチャネルで、acme-corp.json を顧客へ渡します。

ステップ 4 — 中間証明書の失効(CRL)​

中間鍵が侵害された場合は、そのシリアルを CRL に追加します。

# Create or update a CRL file:
echo '{
"revoked_serials": ["aabbccdd..."],
"updated_at": "'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"
}' > deploy/license/crl.json

# Deploy crl.json alongside the new intermediate cert to customers.

顧客側の VerifyLicenseChain() は、中間証明書のシリアルが CRL に現れると、ライセンスを拒否します。

クイックリファレンス​

コマンド目的
gen-root --key-file=Xルート鍵ペアを生成する
issue-intermediate --root-key=X ...中間証明書を作成する
issue --customer=X --expiry=Y ...顧客ごとのライセンスを発行する
verify --license-file=X ...ライセンスを検証する(テスト用)

トラブルシューティング​

「invalid root key seed」 — 16 進文字列がちょうど 64 文字(32 バイト)ではありません。空白や、欠けた文字がないか確認してください。

「intermediate cert signature invalid」 — 署名に使ったルート鍵が、バイナリに埋め込まれたルート公開鍵と一致しません。--root-key が、ビルド時に公開鍵を埋め込んだ鍵と一致することを確認してください。

「license expired」 — トークンの有効期限を過ぎています。将来の有効期限で、新しいトークンを生成してください。