Xác minh chữ ký
Mọi câu trả lời của client API được ký Ed25519 trên đúng byte thân phản hồi. Xác minh chữ ký, nonce, app_id và server_time trước khi tin vào kết quả.
Chữ ký chứng minh câu trả lời do LRS gửi, đúng cho lần gọi này. Không xác minh thì ai cũng dựng được một server giả trả {"ok": true}. SDK chính thức đã làm sẵn các bước dưới đây (lệch giờ thì báo qua callback).
Header
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
X-LR-Signature: lsk_vectorkeyone=ru3Gnl1xj7v2-e1v0uvoVs1b9WUofKLAe4Hre_5vLOrs7dbtGZ0rsB2Iyd6tK7m5XkR8XeRDZOGjzRICVjczAAĐịnh dạng: kid=chữ_ký, nhiều chữ ký cách nhau bởi dấu phẩy (kid=…, kid2=…) khi ứng dụng đang xoay khoá. Chữ ký là 64 byte Ed25519 mã hoá base64url không padding.
Các bước
- Giữ nguyên byte thân phản hồi. Đọc thân thô (
res.arrayBuffer(),io.ReadAll,CURLOPT_RETURNTRANSFER) trước khi parse JSON. Parse rồi serialize lại sẽ làm sai chữ ký. - Tách header theo dấu phẩy; mỗi phần là
kid=chữ_ký. Bỏ quakidbạn không nhúng. - Xác minh Ed25519 chữ ký trên đúng các byte đó bằng khoá công khai của
kidtương ứng. Cần ít nhất một chữ ký hợp lệ với khoá đã nhúng. - So
noncetrong thân với nonce bạn vừa gửi. Mỗi lần gọi sinh nonce mới từ bộ sinh số ngẫu nhiên an toàn (CSPRNG), 16–64 ký tự[A-Za-z0-9_-]. Nonce khác nghĩa là câu trả lời cũ bị phát lại. - So
app_idtrong thân vớiapp_idcủa phần mềm. - Kiểm tra
server_time(RFC 3339): lệch quá 300 giây so với giờ máy thì cảnh báo (đồng hồ máy người dùng hay sai, SDK chỉ báo, không chặn). Nếu cho chạy offline sau lầncheckcuối, tính hạn ân hạn theoserver_timeđã ký, không theo giờ máy.
Chỉ khi qua cả 5 bước đầu mới đọc ok và code. Thiếu header, không chữ ký nào hợp lệ, sai nonce hoặc sai app_id → coi là thất bại, không bao giờ là thành công.
Khoá công khai
- Nhúng khoá vào phần mềm (hằng số trong mã). Không tải khoá công khai từ mạng lúc chạy: kẻ giả server sẽ đưa khoá của chính hắn.
- Nhúng cả khoá đang dùng và khoá trước/sau khi xoay vòng (xem Tổng quan). Chỉ cần một chữ ký khớp.
- Khoá công khai ở dạng
base64url(32 byte, giốngxcủa Ed25519 JWK) vàhex— chọn dạng tiện cho ngôn ngữ của bạn.
Vector kiểm thử
Dùng các trường hợp dưới đây để tự kiểm tra code. Mỗi trường hợp: thân phản hồi (body, đúng từng byte UTF-8), header chữ ký, các kid mà client nhúng (embedded), nonce và app_id client mong đợi, và kết quả đúng (valid). Vector do Go crypto/ed25519 sinh, giống hệt cách server ký.
{
"cases": [
{
"app_id": "lapp_vector",
"body": "{\"app\":{\"latest_version\":\"1.4.2\"},\"app_id\":\"lapp_vector\",\"code\":\"ok\",\"license\":{\"devices\":1,\"expires_at\":\"2026-11-22T10:00:00Z\",\"level\":2,\"level_name\":\"VIP\",\"max_devices\":1},\"message\":\"Khoá hợp lệ.\",\"nonce\":\"n0nce-vector-000001\",\"ok\":true,\"server_time\":\"2026-10-23T10:00:00Z\",\"session\":\"lss_vectorsession\",\"session_expires_at\":\"2026-10-23T11:00:00Z\"}",
"embedded": ["lsk_vectorkeyone"],
"name": "ok signed by key one",
"nonce": "n0nce-vector-000001",
"signature_header": "lsk_vectorkeyone=ru3Gnl1xj7v2-e1v0uvoVs1b9WUofKLAe4Hre_5vLOrs7dbtGZ0rsB2Iyd6tK7m5XkR8XeRDZOGjzRICVjczAA",
"valid": true
},
{
"app_id": "lapp_vector",
"body": "{\"app_id\":\"lapp_vector\",\"code\":\"key_expired\",\"message\":\"Khoá bản quyền đã hết hạn.\",\"nonce\":\"n0nce-vector-000002\",\"ok\":false,\"server_time\":\"2026-10-23T10:00:00Z\"}",
"embedded": ["lsk_vectorkeyone"],
"name": "denial signed by two keys, client embeds only key one",
"nonce": "n0nce-vector-000002",
"signature_header": "lsk_vectorkeytwo=XkBjO3YQ4l85pi-yfroyTIi3PtoPX0Xtp45x4OY4ghr0hemiwBjr6sBl5PsD1pybPzIWn33iNqtj2wvkkayEBA, lsk_vectorkeyone=k3acZYhEeugmqAoGjsf76qVCtC-V5Z7N-yXcgaKUcpgDFcC14kwyxiY_hzSHGKFENjOX1jT5NyxTRTgHSGA9Cg",
"valid": true
},
{
"app_id": "lapp_vector",
"body": "{\"app\":{\"latest_version\":\"1.4.2\"},\"app_id\":\"lapp_vector\",\"code\":\"ok\",\"license\":{\"devices\":1,\"expires_at\":\"2026-11-22T10:00:00Z\",\"level\":2,\"level_name\":\"VIP\",\"max_devices\":1},\"message\":\"Khoá hợp lệ.\",\"nonce\":\"n0nce-vector-000001\",\"ok\":true,\"server_time\":\"2026-10-23T10:00:00Z\",\"session\":\"lss_vectorsession\",\"session_expires_at\":\"2026-10-23T11:00:00Z9}",
"embedded": ["lsk_vectorkeyone"],
"name": "tampered body",
"nonce": "n0nce-vector-000001",
"signature_header": "lsk_vectorkeyone=ru3Gnl1xj7v2-e1v0uvoVs1b9WUofKLAe4Hre_5vLOrs7dbtGZ0rsB2Iyd6tK7m5XkR8XeRDZOGjzRICVjczAA",
"valid": false
},
{
"app_id": "lapp_vector",
"body": "{\"app_id\":\"lapp_vector\",\"code\":\"key_expired\",\"message\":\"Khoá bản quyền đã hết hạn.\",\"nonce\":\"n0nce-vector-000002\",\"ok\":false,\"server_time\":\"2026-10-23T10:00:00Z\"}",
"embedded": ["lsk_vectorkeyone"],
"name": "signed by a key the client does not embed",
"nonce": "n0nce-vector-000002",
"signature_header": "lsk_vectorkeytwo=XkBjO3YQ4l85pi-yfroyTIi3PtoPX0Xtp45x4OY4ghr0hemiwBjr6sBl5PsD1pybPzIWn33iNqtj2wvkkayEBA",
"valid": false
},
{
"app_id": "lapp_vector",
"body": "{\"app\":{\"latest_version\":\"1.4.2\"},\"app_id\":\"lapp_vector\",\"code\":\"ok\",\"license\":{\"devices\":1,\"expires_at\":\"2026-11-22T10:00:00Z\",\"level\":2,\"level_name\":\"VIP\",\"max_devices\":1},\"message\":\"Khoá hợp lệ.\",\"nonce\":\"n0nce-vector-000001\",\"ok\":true,\"server_time\":\"2026-10-23T10:00:00Z\",\"session\":\"lss_vectorsession\",\"session_expires_at\":\"2026-10-23T11:00:00Z\"}",
"embedded": ["lsk_vectorkeyone"],
"name": "valid signature, wrong nonce (replay)",
"nonce": "another-nonce-0001",
"signature_header": "lsk_vectorkeyone=ru3Gnl1xj7v2-e1v0uvoVs1b9WUofKLAe4Hre_5vLOrs7dbtGZ0rsB2Iyd6tK7m5XkR8XeRDZOGjzRICVjczAA",
"valid": false
}
],
"description": "Signed client answers of LR License (Ed25519 over the exact body bytes). Generated with Go crypto/ed25519 like internal/licensing/client.go reply().",
"public_keys": {
"lsk_vectorkeyone": {
"base64url": "ebVWLo_mVPlAeLES6KmLp5AfhTrmlb7X4OORC60ElmQ",
"hex": "79b5562e8fe654f94078b112e8a98ba7901f853ae695bed7e0e3910bad049664"
},
"lsk_vectorkeytwo": {
"base64url": "J07WsmgF0v6NBgUp7povKHY7aXbZxf0d7jj_NrO3aTk",
"hex": "274ed6b26805d2fe8d060529ee9a2f28763b6976d9c5fd1dee38ff36b3b76939"
}
}
}Kết quả mong đợi: hai trường hợp đầu hợp lệ (kể cả khi chỉ nhúng một trong hai khoá); thân bị sửa, khoá không nhúng và nonce sai (phát lại) đều phải bị từ chối.
Go
Thư viện chuẩn crypto/ed25519:
// Package lrverify verifies an answer of the LR License client API.
package lrverify
import (
"crypto/ed25519"
"crypto/rand"
"encoding/base64"
"encoding/json"
"errors"
"strings"
)
var b64 = base64.RawURLEncoding
// ErrInvalidSignature: never treat such an answer as a success.
var ErrInvalidSignature = errors.New("invalid_signature")
// NewNonce returns a fresh nonce (24 characters [A-Za-z0-9_-]) for one call.
func NewNonce() string {
raw := make([]byte, 18)
if _, err := rand.Read(raw); err != nil {
panic(err)
}
return b64.EncodeToString(raw)
}
// Verify checks X-LR-Signature over the raw body bytes with the public keys
// embedded in your program (kid -> base64url), then the nonce you sent and
// your app_id. It returns the parsed answer only when all three hold.
func Verify(body []byte, header string, keys map[string]string, nonce, appID string) (map[string]any, error) {
signed := false
for _, part := range strings.Split(header, ",") {
kid, sig64, found := strings.Cut(strings.TrimSpace(part), "=")
key, known := keys[kid]
if !found || !known {
continue
}
pub, err := b64.DecodeString(key)
if err != nil || len(pub) != ed25519.PublicKeySize {
continue
}
sig, err := b64.DecodeString(sig64)
if err == nil && ed25519.Verify(ed25519.PublicKey(pub), body, sig) {
signed = true
break
}
}
if !signed {
return nil, ErrInvalidSignature
}
var answer map[string]any
if err := json.Unmarshal(body, &answer); err != nil {
return nil, ErrInvalidSignature
}
if answer["nonce"] != nonce || answer["app_id"] != appID {
return nil, ErrInvalidSignature
}
return answer, nil
}PHP
PHP ≥ 7.2 có sẵn ext-sodium (sodium_crypto_sign_verify_detached). Lấy thân bằng curl_exec với CURLOPT_RETURNTRANSFER và header qua CURLOPT_HEADERFUNCTION:
<?php
// LR License: verify a client API answer. PHP >= 7.2 with ext-sodium.
// A fresh nonce (24 characters [A-Za-z0-9_-]) for one call.
function lr_new_nonce(): string
{
return sodium_bin2base64(random_bytes(18), SODIUM_BASE64_VARIANT_URLSAFE_NO_PADDING);
}
// Checks X-LR-Signature over the raw body with the public keys embedded in
// your program (kid => base64url), then the nonce you sent and your app_id.
// Returns the decoded answer, or null: never treat null as a success.
function lr_verify(string $body, string $header, array $keys, string $nonce, string $appId): ?array
{
$signed = false;
foreach (explode(',', $header) as $part) {
$pair = explode('=', trim($part), 2);
if (count($pair) !== 2 || !isset($keys[$pair[0]])) {
continue;
}
try {
$pub = sodium_base642bin($keys[$pair[0]], SODIUM_BASE64_VARIANT_URLSAFE_NO_PADDING);
$sig = sodium_base642bin($pair[1], SODIUM_BASE64_VARIANT_URLSAFE_NO_PADDING);
} catch (SodiumException $e) {
continue;
}
if (strlen($pub) === SODIUM_CRYPTO_SIGN_PUBLICKEYBYTES
&& strlen($sig) === SODIUM_CRYPTO_SIGN_BYTES
&& sodium_crypto_sign_verify_detached($sig, $body, $pub)) {
$signed = true;
break;
}
}
if (!$signed) {
return null;
}
$answer = json_decode($body, true);
if (!is_array($answer) || ($answer['nonce'] ?? null) !== $nonce || ($answer['app_id'] ?? null) !== $appId) {
return null;
}
return $answer;
}JavaScript (WebCrypto)
Chạy trên Deno, Bun, trình duyệt và Node ≥ 22 (crypto.subtle có Ed25519). Truyền new Uint8Array(await res.arrayBuffer()) và res.headers.get("X-LR-Signature"). Trên Node có thể dùng thẳng SDK @lrs/license.
// LR License: verify a client API answer with WebCrypto (Deno, Bun, browsers, Node >= 22).
const B64URL = /^[A-Za-z0-9_-]+$/;
function fromB64url(text) {
const bin = atob(text.replace(/-/g, "+").replace(/_/g, "/"));
return Uint8Array.from(bin, (ch) => ch.charCodeAt(0));
}
/** A fresh nonce (24 characters [A-Za-z0-9_-]) for one call. */
export function newNonce() {
const raw = crypto.getRandomValues(new Uint8Array(18));
return btoa(String.fromCharCode(...raw))
.replace(/\+/g, "-")
.replace(/\//g, "_");
}
/**
* Checks X-LR-Signature over the raw body bytes (Uint8Array from res.arrayBuffer()) with the public keys
* embedded in your program ({ kid: base64url }), then the nonce you sent and your app_id.
* Returns the parsed answer, or null: never treat null as a success.
*/
export async function verifyAnswer(body, header, keys, nonce, appId) {
let signed = false;
for (const part of (header ?? "").split(",")) {
const item = part.trim();
const eq = item.indexOf("=");
const kid = item.slice(0, eq);
const sig = item.slice(eq + 1);
if (eq <= 0 || !Object.hasOwn(keys, kid) || !B64URL.test(sig) || !B64URL.test(keys[kid]))
continue;
try {
const key = await crypto.subtle.importKey(
"raw",
fromB64url(keys[kid]),
{ name: "Ed25519" },
false,
["verify"],
);
if (await crypto.subtle.verify({ name: "Ed25519" }, key, fromB64url(sig), body)) {
signed = true;
break;
}
} catch {
// Wrong key length or signature: try the next one.
}
}
if (!signed) return null;
let answer;
try {
answer = JSON.parse(new TextDecoder().decode(body));
} catch {
return null;
}
if (answer === null || answer.nonce !== nonce || answer.app_id !== appId) return null;
return answer;
}Lua và FiveM
Lua của FiveM không có Ed25519, nên không có mẫu Lua: một client Lua không xác minh được chữ ký thì không an toàn. Script server FiveM hãy dùng SDK Node (chạy trong runtime JavaScript của FiveM, có ví dụ examples/fivem/ trong gói); resource Lua hỏi kết quả qua export hoặc event của resource JavaScript đó.
Chữ ký bảo vệ gì
Chữ ký chặn server giả và câu trả lời bị phát lại. Nó không chặn việc vá file nhị phân để bỏ qua bước kiểm tra — xem Giới hạn & bảo mật.