Persediaan Pelanggan — Pemasangan Lesen di Premis Sendiri
Panduan ini untuk pelanggan di premis sendiri yang menerima token lesen daripada pembekal dan perlu melaksanakannya pada gerbang Yabanin atau pelayan pentadbir mereka.
Perkara yang diterima
Daripada kenalan pembekal, anda akan menerima:
- File token lesen — file JSON (contohnya,
acme-corp.json) yang mengandungi pengecam organisasi, tarikh luput, dan tandatangan kriptografi. - Kunci awam akar — 64 aksara heks (32 bait) yang mewakili kunci awam akar Ed25519 pembekal. Ia terbenam dalam setiap binari pengeluaran pada masa binaan.
- (Pilihan) File sijil perantaraan —
intermediate.json - (Pilihan) File CRL (Senarai Pembatalan Sijil) —
crl.json
Langkah 1 — Letakkan File Lesen
Salin token lesen ke pelayan anda:
mkdir -p /etc/yabanin/license
cp acme-corp.json /etc/yabanin/license/
chmod 600 /etc/yabanin/license/acme-corp.json # restrict access
Langkah 2 — Konfigurasikan Pemboleh Ubah Persekitaran
Tambah pemboleh ubah persekitaran berikut pada persekitaran perkhidmatan anda:
Untuk perkhidmatan systemd
Sunting /etc/systemd/system/yabanin-admin.service (atau yabanin-gateway.service):
[Service]
Environment="YABANIN_LICENSE_FILE=/etc/yabanin/license/acme-corp.json"
Environment="YABANIN_LICENSE_ROOT_PUBKEY=a1b2c3d4e5f6a1b2c3d4e5f6..."
# Optional:
Environment="YABANIN_LICENSE_CRL_FILE=/etc/yabanin/license/crl.json"
Kemudian muat semula dan mulakan semula:
systemctl daemon-reload
systemctl restart yabanin-admin
Untuk Docker / docker-compose
Dalam docker-compose.yml anda:
services:
admin:
environment:
- YABANIN_LICENSE_FILE=/data/license/acme-corp.json
- YABANIN_LICENSE_ROOT_PUBKEY=a1b2c3d4e5f6a1b2c3d4e5f6...
- YABANIN_LICENSE_CRL_FILE=/data/license/crl.json
volumes:
- ./license:/data/license:ro
Untuk pelaksanaan binari secara terus
export YABANIN_LICENSE_FILE=/etc/yabanin/license/acme-corp.json
export YABANIN_LICENSE_ROOT_PUBKEY=a1b2c3d4e5f6a1b2c3d4e5f6...
./yabanin-admin
Langkah 3 — Sahkan Permulaan
Selepas memulakan perkhidmatan, semak log:
# Successful startup:
# License verified successfully
# admin panel running addr=:8086
# Failed startup (license invalid):
# FATAL: LICENSE INVALID — license expired at 2025-01-01T00:00:00Z — service cannot start without a valid license
# (exit code 1)
Langkah 4 — Sahkan Kesahan Lesen (Pilihan)
Lesen boleh disahkan secara bebas sebelum atau selepas pelaksanaan:
./yabanin license verify \
--license-file=/etc/yabanin/license/acme-corp.json \
--root-pubkey=a1b2c3d4e5f6a1b2c3d4e5f6... \
--crl-file=/etc/yabanin/license/crl.json
# Output: LICENSE VALID
Luput Lesen dan Tempoh Tangguh
| Masa sejak luput | Tingkah laku |
|---|---|
| Belum luput | Operasi penuh |
| 0 — 7 hari | Mod terjejas (direkodkan dalam log sebagai "expired") |
| > 7 hari | Luput keras; perkhidmatan enggan bermula |
Tempoh tangguh 7 hari memberi masa untuk memohon lesen yang diperbaharui daripada pembekal tanpa gangguan perkhidmatan serta-merta.
Memperbaharui Lesen
Apabila lesen menghampiri tarikh luput:
- Hubungi pembekal dengan
customer_idanda (terdapat dalam JSON lesen). - Pembekal mengeluarkan token baharu dengan tarikh luput yang dikemas kini.
- Gantikan file lama dan mulakan semula perkhidmatan:
cp new-license.json /etc/yabanin/license/acme-corp.json
systemctl restart yabanin-admin
Penyelesaian Masalah
| Gejala | Punca dan pembetulan |
|---|---|
| "LICENSE INVALID — license expired" | Token telah luput. Mohon token baharu daripada pembekal. |
| "LICENSE INVALID — intermediate verification" | Kunci awam akar tidak sepadan. Sahkan nilai heks sepadan dengan yang pembekal berikan untuk binaan binari ini. |
| "read license file: no such file or directory" | Semak laluan YABANIN_LICENSE_FILE dan kebenaran file (mesti boleh dibaca oleh pengguna perkhidmatan). |
| "parse root pub: encoding/hex: invalid byte" | Heks kunci awam akar cacat bentuk — mesti tepat 64 aksara heks, tanpa ruang. |
| "intermediate cert serial X is revoked" | Pembekal menerbitkan CRL yang membatalkan sijil perantaraan anda. Mohon lesen baharu daripada pembekal. |
Amalan Terbaik Keselamatan
- Kebenaran file: Kekalkan file lesen pada
0600(baca/tulis pemilik sahaja). - Lekapan baca sahaja: Jika menggunakan Docker, lekapkan direktori lesen sebagai
:ro. - Jangan sekali-kali komit file lesen ke kawalan versi.
- Putar dengan segera apabila menerima token yang diperbaharui — token lama kekal sah sehingga tarikh luputnya.