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

オフラインライセンス検証の 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 日)。
  • 顧客のライセンストークンの発行にだけ使います。

中間証明書が期限切れになるか、侵害の疑いがあるとき:

  1. ルートから新しい中間証明書を生成します。
  2. 古いシリアルを失効として載せた CRL を公開します。
  3. 新しい証明書と 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日)