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 persekitaranYABANIN_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:
- Jana perantaraan baharu daripada akar.
- Terbitkan CRL yang menyenaraikan siri lama sebagai dibatalkan.
- 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 JSONYABANIN_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
| Risiko | Mitigasi |
|---|---|
| Kompromi kunci akar | Kekalkan akar luar talian; putar perantaraan secara berkala |
| Kecurian kunci perantaraan | Kesahan pendek (90 hari); CRL untuk pembatalan |
| Kecurian token lesen | Ikat kepada org_id pelanggan; penguatkuasaan tarikh luput |
| Pengusikan binari | Kunci awam akar dibenamkan pada masa bina |
| Main semula lesen lama | Tarikh luput + tempoh tangguh (7 hari) |