Skip to main content

Seni bina PKI untuk pengesahan lesen luar talian

Gambaran keseluruhan​

Yabanin menggunakan hierarki PKI luar talian untuk mengurus token lesen di premis sendiri. Tiada keperluan untuk menghubungi pelayan vendor: setiap pengesahan berlaku secara tempatan menggunakan tandatangan kriptografi 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 │
└───────────────────────────────────────────────────────┘

Model kepercayaan​

Kunci akar (generate-root)​

  • Pasangan kunci Ed25519, tidak pernah meninggalkan persekitaran jurang udara vendor.
  • Kunci awam dibenamkan ke dalam setiap binari pengeluaran pada masa bina melalui keys_gen.go (dijalankan dengan pemboleh ubah persekitaran YABANIN_LICENSE_ROOT_PUBKEY).
  • Jika terkompromi, seluruh PKI mesti dikeluarkan semula.

Sijil perantaraan (issue-intermediate)​

  • Pasangan kunci Ed25519 berhayat pendek (lalai 90 hari) yang ditandatangani oleh akar.
  • Digunakan secara eksklusif untuk mengeluarkan token lesen pelanggan.

Apabila perantaraan tamat tempoh atau disyaki terkompromi:

  1. Jana perantaraan baharu daripada akar.
  2. Terbitkan CRL yang menyenaraikan siri lama sebagai dibatalkan.
  3. Laksanakan sijil baharu + CRL kepada pelanggan.

Token lesen (issue)​

  • Token JSON bagi setiap pelanggan yang mengandungi customer_id, expiry, serial.
  • Ditandatangani oleh kunci perantaraan semasa.
  • Diserahkan kepada pelanggan (USB, e-mel selamat, muat turun portal).

Pelanggan meletakkannya pada pelayan mereka dan menetapkan pemboleh ubah persekitaran:

  • YABANIN_LICENSE_FILE — laluan ke token JSON
  • YABANIN_LICENSE_ROOT_PUBKEY — heks kunci awam akar (64 aksara)
  • YABANIN_LICENSE_CRL_FILE — laluan CRL pilihan

CRL (crl.go)​

  • File JSON pilihan yang menyenaraikan siri sijil perantaraan yang dibatalkan.
  • Digunakan untuk membatalkan kesahan perantaraan yang terkompromi/tamat tempoh tanpa membina semula binari.

Aliran penjanaan & pelaksanaan kunci​

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

Pertimbangan keselamatan​

RisikoMitigasi
Kompromi kunci akarKekalkan akar luar talian; putar perantaraan secara berkala
Kecurian kunci perantaraanKesahan pendek (90 hari); CRL untuk pembatalan
Kecurian token lesenIkat kepada org_id pelanggan; penguatkuasaan tarikh luput
Pengusikan binariKunci awam akar dibenamkan pada masa bina
Main semula lesen lamaTarikh luput + tempoh tangguh (7 hari)