Skip to main content

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:

  1. File token lesen — file JSON (contohnya, acme-corp.json) yang mengandungi pengecam organisasi, tarikh luput, dan tandatangan kriptografi.
  2. Kunci awam akar — 64 aksara heks (32 bait) yang mewakili kunci awam akar Ed25519 pembekal. Ia terbenam dalam setiap binari pengeluaran pada masa binaan.
  3. (Pilihan) File sijil perantaraan — intermediate.json
  4. (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 luputTingkah laku
Belum luputOperasi penuh
0 — 7 hariMod terjejas (direkodkan dalam log sebagai "expired")
> 7 hariLuput 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:

  1. Hubungi pembekal dengan customer_id anda (terdapat dalam JSON lesen).
  2. Pembekal mengeluarkan token baharu dengan tarikh luput yang dikemas kini.
  3. Gantikan file lama dan mulakan semula perkhidmatan:
cp new-license.json /etc/yabanin/license/acme-corp.json
systemctl restart yabanin-admin

Penyelesaian Masalah​

GejalaPunca 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.