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:
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,MachineGuidtrong registry trên Windows, đã bỏ khoảng trắng đầu cuối.- Có
app_idtrong 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:
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 ở
activatevà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 domax_concurrent_sessionsgiớ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ý.