オフラインライセンス検証の PKI アーキテクチャ
概要
Yabanin は、オンプレミスのライセンストークンを管理するために、オフラインの PKI 階層を使います。外部への通信(phone-home)は不要です。すべての検証は Ed25519 の暗号署名を使い、ローカルで行われます。
┌───────────────────────────────────────────────────────┐
│ VENDOR (Air-Gapped) │
│ │
│ ┌──────────────────────┐ │
│ │ ROOT KEY │ Ed25519 │
│ │ (never online) │ Kept offline / HSM │
│ └─────────┬───────────┘ │
│ │ sign │
│ ▼ │
│ ┌─────────────────────┐ │
│ │ INTERMEDIATE CERT │ Ed25519 │
│ │ + signing key │ Signed by root │
│ └─────────┬───────────┘ │
│ │ sign │
│ ▼ │
│ ┌──────────────────────┐ │
│ │ LICENSE TOKEN │ Ed25519 │
│ │ (per-customer) │ Signed by intermediate │
│ └─────────────────────┘ │
│ │
│ ┌─────────────────────┐ │
│ │ CRL (optional) │ Revoked intermediate serials │
│ └─────────────────────┘ │
└───────────────────────────────────────────────────────┘
│ deliver (USB / secure email)
▼
┌────────────────────────────────────────────────────────┐
│ CUSTOMER ON-PREM ENVIRONMENT │
│ │
│ Embedded root public key (built into binary) │
│ Intermediate cert (deployed with release) │
│ License token (per-customer JSON file) │
│ CRL (optional, deployed separately) │
│ │
│ Startup: VerifyLicenseChain() │
│ 1. Parse license token │
│ 2. Check expiry │
│ 3. Load & verify intermediate cert against root │
│ 4. Verify license sig against intermediate pubkey │
│ 5. (Optional) Check CRL for revoked intermediates │
└───────────────────────────────────────────────────────┘
信頼モデル
ルートキー(generate-root)
- Ed25519 の鍵ペアで、ベンダーのエアギャップ環境から出ることはありません。
- 公開鍵はビルド時に、
keys_gen.go経由で(YABANIN_LICENSE_ROOT_PUBKEY環 境変数を付けて実行し)すべての本番バイナリへ埋め込まれます。 - 侵害された場合、PKI 全体を再発行する必要があります。
中間証明書(issue-intermediate)
- ルートが署名する、短命の Ed25519 鍵ペアです(デフォルトは 90 日)。
- 顧客のライセンストークンの発行にだけ使います。
中間証明書が期限切れになるか、侵害の疑いがあるとき:
- ルートから新しい中間証明書を生成します。
- 古いシリアルを失効として載せた CRL を公開します。
- 新しい証明書と CRL を顧客へ導入します。
ライセンストークン(issue)
- 顧客ごとの JSON トークンで、
customer_id、expiry、serialを含みます。 - 現在の中間鍵が署名します。
- 顧客へ届けます(USB、安全なメール、ポータルからのダウンロード)。
顧客はそれをサーバに置き、環境変数を設定します。
YABANIN_LICENSE_FILE— JSON トークンへのパスYABANIN_LICENSE_ROOT_PUBKEY— ルート公開鍵の16進(64文字)YABANIN_LICENSE_CRL_FILE— 任意の CRL パス
CRL(crl.go)
- 失効した中間証明書のシリアルを列挙する、任意の JSON ファイルです。
- バイナリを再ビルドせずに、侵害された、または期限切れの中間証明書を無効化するために使います。
鍵の生成と導入の流れ
Vendor air-gap:
yabanin license gen-root --key-file=root
yabanin license issue-intermediate --root-key=root.priv --validity=90 \
--key-file=inter-2027q1 --serial=...
yabanin license issue --customer="acme-corp" --expiry=2027-12-31 \
--inter-key=inter-2027q1.priv --inter-serial=<serial> \
--output=acme-corp-license.json
Build production binary:
YABANIN_LICENSE_ROOT_PUBKEY=<root.pub hex> go generate ./pkg/license/...
make all
Deploy to customer:
Place acme-corp-license.json on server
Set env vars in systemd/docker environment
Start admin/gateway — license verified at startup
セキュリティ上の考慮事項
| リスク | 緩和策 |
|---|---|
| ルート鍵の侵害 | ルートをオフラインに保ち、中間証明書を定期的にローテーションします |
| 中間鍵の盗難 | 短い有効期間(90日)。失効には CRL を使います |
| ライセンストークンの盗難 | 顧客の org_id に紐付け、期限を強制します |
| バイナリの改ざん | ルート公開鍵をビルド時に埋め込みます |
| 古いライセンスのリプレイ | 期限と猶予期間(7日) |