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.

Giới hạn, bảo mật & FAQ

Giới hạn của client API (theo mạng, theo khoá, chống dò khoá, hạn mức ngày, lượt đồng thời), những gì chữ ký bảo vệ và không bảo vệ, cùng câu hỏi thường gặp.

Giới hạn bảo vệ máy chủ của bạn và của các khách hàng khác. Khi bị giới hạn, chờ Retry-After giây rồi thử lại với nonce mới.

Giới hạn client API

Giới hạnMứcPhạm vi và câu trả lời khi vượt
Theo mạng60 lượt/phútMỗi địa chỉ IPv4 hoặc dải IPv6 /64, cấu hình chung của LRS. 429 rate_limited không ký — kiểm tra trước khi đọc ứng dụng.
Theo khoá30 lượt/phútactivate và check của cùng một khoá từ mọi địa chỉ, cấu hình chung của LRS. 429 rate_limited có ký, kèm retry_after.
Heartbeat20 lượt/phútMỗi phiên. 429 rate_limited có ký.
Dò khoá20 lượt/phútLượt key_invalid / session_invalid của mỗi mạng, và 100 lượt/phút cho mỗi ứng dụng từ mọi mạng. 429 rate_limited có ký. Chỉ lượt thất bại bị đếm: khoá đúng sau NAT dùng chung vẫn chạy.
Hạn mức ngàyTheo tổ chứcLượt activate/check có khoá hoặc phiên hợp lệ trong ngày (giờ Việt Nam); heartbeat không tính (được đếm riêng). 200 quota_exceeded có ký.
Đồng thời8 lượtLượt client API xử lý cùng lúc trên máy chủ. 503 license_busy không ký, Retry-After: 5.
Cổng API100/giâyMỗi IP, trước khi tới máy chủ ứng dụng. 429 của cổng, không ký.

Hạn mức của tổ chức hiện ở /app/license. Lượt bị từ chối không có khoá hoặc phiên hợp lệ chỉ được đếm, không ghi vào nhật ký (HWID và địa chỉ do người gọi tự chọn).

Bảo mật

  • Không bao giờ nhúng API key lrs_… vào phần mềm. Ai giải nén được phần mềm sẽ tạo được khoá cho chính mình. Phần mềm chỉ cần app_id và khoá công khai — cả hai đều không phải bí mật.
  • Xác minh chữ ký, nonce và app_id cho mọi câu trả lời (Xác minh chữ ký). Câu trả lời không ký không bao giờ là thành công.
  • Nhúng khoá công khai trong mã, không tải từ mạng.
  • Chỉ gọi https://; không đi theo chuyển hướng.
  • Khoá bản quyền là của người dùng: chỉ hiện key_last4 trong giao diện của bạn, xem khoá đầy đủ qua …/reveal khi thật cần.

Chữ ký bảo vệ: server giả trả "hợp lệ", câu trả lời cũ bị phát lại, nội dung bị sửa trên đường truyền.

Chữ ký không bảo vệ: người có file phần mềm vá nhị phân để bỏ qua bước kiểm tra, hoặc thay khoá công khai đã nhúng. Không dịch vụ cấp phép nào chặn được hoàn toàn việc này; hãy làm rối mã, kiểm tra hash bản dựng (integrity_hashes), và đặt tính năng quan trọng ở phía máy chủ khi có thể.

Câu hỏi thường gặp

Mất mạng thì phần mềm có dừng không?

Không nên. Lỗi mạng (network_error: không có chữ ký, HTTP khác 200) chỉ là tạm thời. Hãy cho chạy tiếp, thử lại sau Retry-After, và chỉ dừng khi quá thời gian ân hạn tính từ server_time đã ký của lần check thành công gần nhất.

Người dùng đổi máy thì sao?

Với ràng buộc hwid, máy mới nhận device_limit nếu khoá đã đủ thiết bị. Người bán reset thiết bị của khoá trong dashboard hoặc qua POST …/keys/{keyId}/reset-devices; người dùng kích hoạt lại trên máy mới.

Một khoá dùng cho nhiều server FiveM được không?

Mỗi server là một thiết bị (HWID khác nhau). Đặt max_devices của khoá theo số server bạn cho phép, và max_concurrent_sessions ít nhất bằng số server chạy cùng lúc.

Khoá dùng trên nhiều máy thì giới hạn thế nào?

Có hai cách, chọn theo cách bạn bán:

  • Theo máy (ràng buộc hwid): khoá chỉ chạy trên max_devices máy đã kích hoạt; muốn đổi máy phải reset thiết bị.
  • Theo số phiên (ràng buộc none): khoá chạy trên máy nào cũng được, nhưng chỉ max_concurrent_sessions máy cùng lúc. Tắt phần mềm (end) là máy khác dùng được ngay; phần mềm sập thì chỗ được trả sau heartbeat_timeout_seconds.

Hai giới hạn dùng chung được: ví dụ 3 máy nhưng chỉ 1 máy chạy cùng lúc.

Hai máy dùng chung một khoá cứ đẩy nhau ra?

Đó là session_overflow = kick_oldest: mỗi lần kích hoạt mới thay phiên cũ nhất, máy kia nhận session_replaced. Đừng để phần mềm tự kích hoạt lại khi nhận mã này. Muốn máy đến sau bị từ chối thì chọn reject (máy đó nhận session_limit).

Heartbeat có tốn hạn mức ngày không?

Không. Hạn mức ngày chỉ tính activate và check hợp lệ; heartbeat được đếm riêng và chỉ giới hạn 20 lượt/phút mỗi phiên.

Có cần gọi init không?

Không bắt buộc. activate tự kiểm tra phiên bản và hash; init chỉ giúp báo "cần cập nhật" trước khi hỏi khoá.

Ngôn ngữ của tôi không có SDK?

Tự gọi bốn endpoint và làm đủ các bước ở Xác minh chữ ký — có mẫu Go, PHP, JavaScript và vector để tự kiểm tra.

Xoay khoá ký có làm bản phần mềm cũ ngừng chạy không?

Không, cho tới khi bạn ngừng khoá cũ. Trong thời gian xoay, mỗi câu trả lời có chữ ký của cả hai khoá.