Case Study: Phòng chỉ cho một người vào với Server Approval
Yêu cầu
Một khách hàng vận hành phòng hạn chế ra vào (ví dụ: phòng máy chủ, kho tiền hoặc phòng thí nghiệm) cần một quy tắc đơn giản nhưng nghiêm ngặt được thực thi ngay tại cửa:
Mỗi lần chỉ được phép có một người ở trong phòng. Người tiếp theo không được vào cho đến khi người đang ở trong phòng đã check-out.
Thiết bị Cams đảm nhận việc xác minh danh tính, còn Server Approval mở rộng thêm bằng cách cho phép phần mềm của chính bạn bổ sung logic “đã có ai ở bên trong chưa?” – quyết định theo thời gian thực xem một người dùng đã được xác minh có thực sự được vào hay không.
Vì sao Server Approval phù hợp
Theo mặc định (khi tắt Server Approval), thiết bị cấp quyền truy cập ngay khi xác minh người dùng tại chỗ – phần mềm của bạn chỉ biết sau đó. Cách này ổn cho việc ghi log đơn giản, nhưng không thể ngăn chặn việc ra vào.
Khi bật Server Approval, thiết bị sẽ tạm dừng sau khi xác minh tại chỗ và chờ phần mềm của bạn xác nhận lần chấm công trước khi mở cửa. Vòng trao đổi này giúp bạn đưa logic nghiệp vụ – như “đã có ai ở bên trong chưa?” – vào chính quyết định cấp quyền truy cập, thay vì chỉ ghi nhận sau khi sự việc đã xảy ra.
Luồng hoạt động
- Người dùng chấm công tại thiết bị.
- Thiết bị xác minh người đó tại chỗ, sau đó gửi một yêu cầu JSON đến callback URL mà bạn đã đăng ký.
- Phần mềm của bạn kiểm tra trạng thái người trong phòng của chính mình và phản hồi:
{"status": "done"}→ thiết bị chấp nhận lần chấm công và mở cửa.{"status": "reject"}→ thiết bị từ chối truy cập và giữ cửa đóng.
- Khi check-out, phần mềm của bạn cập nhật trạng thái người trong phòng để lần check-in tiếp theo được đánh giá chính xác.
Minh họa với hai người dùng
Người dùng X check-in. Thiết bị xác minh X, gọi callback, phần mềm của bạn thấy phòng trống và trả về done. X bước vào. Phần mềm của bạn đánh dấu phòng đang có người.
Người dùng Y cố check-in khi X vẫn còn ở bên trong. Thiết bị xác minh Y, gọi callback – giống như mọi lần chấm công khác. Phần mềm của bạn thấy phòng vẫn đang có người và trả về reject. Thiết bị từ chối Y và cửa vẫn đóng. Y sẽ không được vào cho đến khi phần mềm của bạn cho phép.
X check-out. Phần mềm của bạn ghi nhận việc check-out và xóa cờ đánh dấu phòng có người.
Y thử lại. Luồng callback vẫn như cũ, nhưng lần này phần mềm của bạn thấy phòng đã trống và trả về done. Y bước vào.
Vai trò của thiết bị không bao giờ thay đổi – nó luôn xác minh người dùng rồi hỏi phần mềm của bạn nên làm gì tiếp theo. Điều duy nhất khác biệt giữa “reject” và “done” là những gì phần mềm của bạn biết về việc hiện ai đang ở bên trong.
Lưu ý khi triển khai
- Việc kiểm tra trạng thái người trong phòng hoàn toàn thuộc trách nhiệm của bạn – thiết bị không lưu thông tin ai đang ở bên trong. Với không gian chỉ cho một người, một cờ hoặc một bản ghi cho mỗi phòng là đủ; với nhiều phòng hoặc nhiều sức chứa thì cần một bảng trạng thái nhỏ được định danh theo phòng/thiết bị.
- Hãy đảm bảo các sự kiện check-out luôn được ghi nhận đáng tin cậy, vì chỉ cần bỏ sót một lần check-out là phòng sẽ bị khóa vĩnh viễn ngay cả khi người dùng đã rời đi.
- Hãy kiểm thử đường đi của callback ở môi trường local trước khi đưa vào vận hành – xem hướng dẫn đi kèm của chúng tôi về kiểm thử callback của Cams API ở local bằng các công cụ tunneling để thiết lập ngrok/Cloudflare Tunnel/localhost.run với môi trường dev của bạn.
Cần lưu ý: kết nối và phản hồi của callback
Server Approval phụ thuộc vào một vòng trao đổi trực tiếp giữa thiết bị và máy chủ của bạn, cũng như việc máy chủ luôn phản hồi đúng. Có hai tình huống đáng để thiết kế phương án dự phòng:
Thiết bị ngoại tuyến. Thiết bị không thể gửi callback xác minh theo thời gian thực, nên phần mềm của bạn không có cơ hội phản hồi done hay reject. Thiết bị hiển thị thông báo “Disconnected” và từ chối hẳn lần chấm công – nó không chuyển sang cho phép truy cập chỉ dựa trên xác minh tại chỗ.
Callback của bạn trả về giá trị khác với {"status": "done"} hoặc {"status": "reject"}. Phản hồi không hợp lệ hoặc không mong đợi sẽ bị kẹt trong hàng đợi, và thiết bị sẽ không đẩy bất kỳ dữ liệu chấm công nào tiếp theo đến callback của bạn cho đến khi sự cố được giải quyết – do đó cửa vẫn đóng, không chỉ với người dùng đó mà với tất cả những người sau họ, cho đến khi callback của bạn phản hồi đúng trở lại.
Nói cách khác, mức bảo đảm “mỗi lần một người” chỉ vững chắc ngang với kết nối mạng của thiết bị và độ tin cậy của các phản hồi callback. Với môi trường production, hãy cân nhắc cả hai khi thiết lập – ví dụ: dùng kết nối có dây thay vì Wi-Fi hoặc đặt cảnh báo khi thiết bị ngoại tuyến kéo dài, đồng thời kiểm tra chặt chẽ để callback luôn trả về phản hồi done/reject đúng định dạng, kể cả trong các nhánh xử lý lỗi.
Kết quả
Khi bật Server Approval và dùng một cờ trạng thái người trong phòng tối giản trong phần mềm của khách hàng, yêu cầu mỗi lần chỉ một người đã được thực thi hoàn toàn bằng các khả năng sẵn có của thiết bị – không cần thêm phần cứng, và không cần thay đổi gì phía thiết bị ngoài việc bật một tùy chọn cấu hình.