Bỏ qua đến nội dung

Tài liệu kỹ thuật

Tích hợp LRS trong một buổi chiều.

Mã thiết bị (HWID)

HWID cho LRS biết khoá đang chạy trên máy nào để giới hạn số thiết bị. Cách SDK tính HWID mặc định, và khi nào nên tự truyền mã riêng.

HWID là chuỗi bất kỳ tối đa 256 ký tự, ổn định trên cùng một máy. Với khoá ràng buộc hwid, LRS so chuỗi này để đếm chỗ thiết bị (max_devices); ở mọi chế độ nó dùng để chặn theo thiết bị và được ghi theo phiên.

Cách tính khuyến nghị

Bốn SDK chính thức dùng cùng một công thức:

Mã
hwid = hex( HMAC_SHA256( key = machine_id, message = "lr-license|" + app_id ) )
  • machine_id: /etc/machine-id (hoặc /var/lib/dbus/machine-id) trên Linux, MachineGuid trong registry trên Windows, đã bỏ khoảng trắng đầu cuối.
  • Có app_id trong công thức nên mỗi ứng dụng thấy một HWID khác nhau cho cùng một máy: người bán không theo dõi chéo được người dùng.
  • Không đọc được machine-id thì SDK dùng tên máy kèm hệ điều hành (yếu hơn).

Tự tính trên Linux để so với SDK:

Shell
printf '%s' "lr-license|$APP_ID" | openssl dgst -sha256 -hmac "$(cat /etc/machine-id)" | awk '{print $NF}'

Khi nào truyền HWID riêng

Máy ảo và container nhân bản từ cùng một image dùng chung machine-id, nên cũng dùng chung HWID: mọi bản sao chỉ chiếm một chỗ thiết bị. Nếu điều đó không đúng ý bạn, hãy tự tạo mã riêng (ví dụ lưu một UUID ngẫu nhiên khi cài đặt) và truyền vào activate/check thay cho mặc định.

Lưu ý

  • Gửi đúng cùng một HWID ở activate và check; khác nhau trả hwid_mismatch.
  • HWID của người dùng là dữ liệu cá nhân: đừng gửi số serial phần cứng thô, hãy băm như trên.
  • Khoá ràng buộc none: HWID không bắt buộc và không đếm thiết bị; số máy chạy cùng lúc do max_concurrent_sessions giới hạn.
  • Người dùng đổi máy: người bán reset thiết bị của khoá trong dashboard hoặc qua API quản lý.