Skip to main content

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 yabanin dibina: 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​

PencetusTindakan
Tamat tempoh menghampiri (< 14 hari)Jana perantara baharu + keluarkan token baharu
Kebocoran kunci disyakiTambah serial lama ke CRL, jana yang baharu
Kitaran suku tahunanPutaran 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​

ArahanTujuan
gen-root --key-file=XJana 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.