Panduan Pengeluaran Lesen Pembekal
Panduan ini untuk pembekal (pasukan YABANIN) yang mengawal kunci akar dan mengeluarkan lesen kepada pelanggan di premis sendiri.
⚠️ Semua arahan pengeluaran mesti dijalankan daripada mesin berjurang udara dan luar talian. Kunci persendirian akar tidak sekali-kali boleh menyentuh sistem yang bersambung ke rangkaian.
Prasyarat
- Go 1.25+ dipasang pada mesin pengeluaran.
- Binari
yabanindibina:make unified
Langkah 1 — Jana Pasangan Kunci Akar
# 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)
Simpan kunci persendirian akar dalam HSM atau storan luar talian yang disulitkan. Kunci awam akan dibenamkan ke dalam binari pengeluaran pada masa binaan.
Pembenaman Kunci pada Masa Binaan
Apabila membina binari pengeluaran, tetapkan kunci awam akar sebagai pemboleh ubah persekitaran:
YABANIN_LICENSE_ROOT_PUBKEY=a1b2c3d4e5f6... \
go generate ./pkg/license/... # generates pkg/license/zz_keys.go
make all # builds binaries with embedded root pubkey
Alat keys_gen.go menulis zz_keys.go yang mengandungi:
const VendorPublicKey = "a1b2c3d4e5f6..." // 64 hex chars
Langkah 2 — Cipta Sijil Perantara
Perantara berhayat pendek (biasanya 90 hari). Jana yang baharu sebelum setiap suku tahun.
./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)
Rekod medan serial. Medan itu diperlukan apabila mengeluarkan lesen dan
apabila menarik balik perantara.
Bila Hendak Memutar Perantara
| Pencetus | Tindakan |
|---|---|
| Tamat tempoh menghampiri (< 14 hari) | Jana perantara baharu + keluarkan token baharu |
| Kebocoran kunci disyaki | Tambah serial lama ke CRL, jana yang baharu |
| Kitaran suku tahunan | Putaran proaktif |
Langkah 3 — Keluarkan Token Lesen Pelanggan
./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>"
# }
Serahkan acme-corp.json kepada pelanggan melalui saluran selamat pilihan anda.
Langkah 4 — Tarik Balik Perantara (CRL)
Jika kunci perantara dikompromi, tambah serialnya ke 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() pelanggan akan menolak lesen jika serial perantara mereka
muncul dalam CRL.
Rujukan Pantas
| Arahan | Tujuan |
|---|---|
gen-root --key-file=X | Jana pasangan kunci akar |
issue-intermediate --root-key=X ... | Cipta sijil perantara |
issue --customer=X --expiry=Y ... | Keluarkan lesen bagi setiap pelanggan |
verify --license-file=X ... | Sahkan lesen (untuk ujian) |
Penyelesaian Masalah
"invalid root key seed" — rentetan hex bukan tepat 64 aksara (32 bait). Semak ruang putih atau aksara yang hilang.
"intermediate cert signature invalid" — kunci akar yang digunakan untuk menandatangani tidak
sepadan dengan kunci awam akar yang dibenamkan dalam binari. Pastikan --root-key sepadan
dengan kunci yang kunci awamnya dibenamkan pada masa binaan.
"license expired" — tarikh tamat tempoh token telah berlalu. Jana token baharu dengan tarikh tamat tempoh pada masa hadapan.