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ạn | Mức | Phạm vi và câu trả lời khi vượt |
|---|---|---|
| Theo mạng | 60 lượt/phút | Mỗ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út | activate 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. |
| Heartbeat | 20 lượt/phút | Mỗi phiên. 429 rate_limited có ký. |
| Dò khoá | 20 lượt/phút | Lượ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ày | Theo tổ chức | Lượ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ời | 8 lượt | Lượ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 API | 100/giây | Mỗ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ầnapp_idvà khoá công khai — cả hai đều không phải bí mật. - Xác minh chữ ký, nonce và
app_idcho 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_last4trong giao diện của bạn, xem khoá đầy đủ qua…/revealkhi 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ênmax_devicesmá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_sessionsmá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ả sauheartbeat_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á.