Khắc phục sự cố

Cách khắc phục theo từng triệu chứng cho các sự cố Door & Gate Access thường gặp nhất. Mỗi mục được trình bày theo thứ tự triệu chứng → nguyên nhân → cách giải quyết. Để biết ý nghĩa của bất kỳ trạng thái hoặc lý do từ chối nào, hãy xem Tham khảo; để biết logic quyết định bên dưới, hãy xem Cách đưa ra quyết định truy cập.

Hãy bắt đầu với Nhật ký truy cập. Hầu hết mọi báo cáo "không vào được" đều có một sự kiện bị từ chối trong Nhật ký truy cập kèm lý do chính xác. Tìm kiếm tên của hội viên, xem sự kiện bị từ chối gần đây nhất và chuyển đến phần tương ứng bên dưới.

Cửa hiển thị Ngoại tuyến

Triệu chứng: Thẻ cửa hiển thị Ngoại tuyến, hội viên thấy "Door offline", không thể gửi lệnh mở khóa.

Nguyên nhân: Bộ điều khiển cửa đã không báo cáo trong hơn 5 phút — thiết bị bị mất nguồn điện hoặc mất kết nối mạng.

Cách giải quyết:

1. Kiểm tra bộ điều khiển có nguồn điện và kết nối mạng (cáp Ethernet / Wi-Fi) — trang Khắc phục sự cố phần cứng đề cập đến các bước kiểm tra tại chỗ (đèn LED báo hiệu, bộ chia PoE, hệ thống cáp, SIM/ăng-ten trên các mẫu 4G).
2. Mở bảng của cửa → tab Overview để xem Status (lần cuối được thấy), IP address và thời gian hoạt động — nếu "lần cuối được thấy" là gần đây thì có thể mạng bị gián đoạn chứ không phải thiết bị bị hỏng.
3. Tắt rồi bật lại nguồn bộ điều khiển nếu cần.
4. Để chẩn đoán sâu hơn, hãy làm theo Open in Device Management for advanced configuration.
5. Nếu nhiều cửa cùng ngoại tuyến một lúc, hãy nghi ngờ mạng/internet của địa điểm thay vì các thiết bị.

Trong khi cửa ngoại tuyến, hội viên sẽ thấy thông tin liên hệ hỗ trợ trên trang chính của ứng dụng (ở chế độ Smart mặc định) để có thể gọi cho bạn.

Hội viên bị từ chối — "You don't have access to this door"

Triệu chứng: Sự kiện bị từ chối với lý do no_matching_policy_or_grant.

Nguyên nhân: Không có đường cấp quyền bổ sung nào cho phép họ: không có Access Policy đang bật nào khớp cả Who VÀ Where VÀ When, và không có quyền cấp vĩnh viễn hoặc khung thời gian đang hoạt động nào của quản trị viên/tích hợp áp dụng cho cửa đó.

Cách giải quyết:

1. Mở hội viên trong Users và so sánh loại người, trạng thái hội viên và các thẻ được đồng bộ/thẻ tùy chỉnh với Who của chính sách.
2. Kiểm tra rằng Where bao gồm cửa đó trực tiếp, thông qua một Access Scope hoặc thông qua tất cả các cửa của cơ sở, và không có ngoại lệ nào loại bỏ cửa đó.
3. Kiểm tra When: Anytime, hoặc ít nhất một khung thời gian Weekly/One-time đang hoạt động. Thời điểm kết thúc không được tính vào khung.
4. Hãy nhớ rằng các chính sách được kết hợp theo logic HOẶC, nhưng mỗi chính sách yêu cầu Who VÀ Where VÀ When. Khớp một phần không bao giờ cấp quyền truy cập.
5. Nếu phù hợp, hãy dùng một quyền cấp vĩnh viễn hoặc khung thời gian quản trị viên riêng; những quyền này vẫn mang tính bổ sung.

Hội viên bị từ chối — "Your access has been suspended"

Triệu chứng: Sự kiện bị từ chối với lý do access_disabled; người dùng hiển thị huy hiệu Disabled.

Nguyên nhân: Quyền truy cập của người dùng đã bị tắt. Việc này xảy ra thủ công (một quản trị viên đã tắt Access enabled) hoặc tự động (hội viên đã bị xóa trong tích hợp và bảng hiển thị Removed by integration, hoặc họ đã bị xóa mềm).

Cách giải quyết: Mở người dùng và bật lại Access enabled — hoặc, nếu họ hiển thị Removed by integration, hãy khôi phục họ trong hệ thống nguồn (hoặc tách rời hàng đó và bật quyền truy cập thủ công).

Chính sách có lịch không cho phép truy cập

Triệu chứng: Ứng dụng hiển thị thời điểm có thể truy cập trong tương lai hoặc nhật ký có outside_access_time_window; một khung thời gian từ nguồn hiển thị Stale hoặc Unmapped; hoặc quyền truy cập thay đổi vào thời điểm không mong muốn.

Cách giải quyết:

1. Xác nhận chính sách đang được bật.
2. Kiểm tra Who và Where của chính sách đó trước khi xem xét lịch When.
3. Với khung thời gian One-time, hãy so sánh lần thử với [from, to). Múi giờ hiển thị không thể làm thay đổi thời điểm đã lưu.
4. Với khung thời gian Weekly, hãy kiểm tra múi giờ IANA, ngày trong tuần/khối giờ theo giờ địa phương, các giới hạn hiệu lực tùy chọn và thời điểm chuyển đổi giờ mùa hè. Thời điểm kết thúc không được tính vào khung và các khối giờ qua đêm phải được tách ra.
5. Sử dụng policyId và policyName trong Nhật ký truy cập để xác minh chính sách nào đã được đánh giá.
6. Xác nhận rằng blockAllAccess, Force closed, việc vô hiệu hóa người dùng, geofence và trạng thái bộ điều khiển không được ưu tiên áp dụng.

Đối với khung thời gian riêng từ tích hợp, hãy xác minh thêm ánh xạ phạm vi logic, phiên bản nguồn, tuổi của dữ liệu nguồn và tình trạng gửi dữ liệu. Các khung thời gian từ nguồn không xác định, chưa được ánh xạ hoặc đã lỗi thời sẽ không cấp quyền truy cập, nhưng không loại bỏ các đường cấp quyền qua Access Policy hoặc quyền cấp vĩnh viễn.

Các ứng dụng phiên bản cũ có thể hiển thị Outside hours vì lý do tương thích là outside_access_hours; Nhật ký truy cập và các ứng dụng phiên bản mới hơn sử dụng chi tiết outside_access_time_window.

Từ chối do geofence — "Move closer" và các lý do tương tự

Triệu chứng: Các sự kiện bị từ chối với lý do outside_geofence, gps_too_imprecise hoặc location_unavailable.

Hộp thoại chi tiết của sự kiện bị từ chối hiển thị tọa độ được báo cáo, độ chính xác và khoảng cách — rất hữu ích để đánh giá liệu hội viên có thực sự ở tại địa điểm hay không.

Đã gửi lệnh mở khóa nhưng cửa không mở (Timed out / Failed)

Triệu chứng: Các sự kiện kết thúc với Timed out hoặc Failed thay vì Confirmed unlocked.

Nguyên nhân: Lệnh đã đến máy chủ nhưng bộ điều khiển không xác nhận — kết nối tại cửa không ổn định hoặc thiết bị bị lỗi.

Cách giải quyết:

1. Kiểm tra trạng thái trực tuyến và thông tin thiết bị của cửa (tab Overview). Việc hết thời gian chờ lặp lại ở một cửa cho thấy vấn đề nằm ở mạng của cửa đó.
2. Thử Unlock door với tư cách quản trị viên từ bảng điều khiển trong khi quan sát cửa.
3. Sử dụng Identify device (ba tiếng bíp) để xác nhận bạn đang ở đúng bộ điều khiển.
4. Nếu rơ-le kêu tách nhưng cửa không nhả, lỗi nằm ở mạch khóa — hãy thực hiện các bài kiểm tra bằng dây nối tắt và đồng hồ vạn năng trong Khắc phục sự cố phần cứng.
5. Chuyển lên cấp cao hơn qua công cụ chẩn đoán của Quản lý thiết bị nếu thiết bị trực tuyến nhưng không kích hoạt.

Hãy kiểm tra cả Maintenance mode — cửa ở chế độ Force closed luôn khóa đối với hội viên theo thiết kế. Block all access at this door đặt blockAllAccess một cách rõ ràng và từ chối mọi chính sách hội viên, quyền cấp vĩnh viễn và Access Time Window.

Nếu bộ điều khiển trực tuyến nhưng không còn phản hồi bình thường, Remotely reboot device (bảng của cửa → Configuration → Advanced) sẽ khởi động lại thiết bị. Cửa giữ nguyên trạng thái khóa hiện tại và ngoại tuyến trong một đến hai phút khi thiết bị khởi động.

Hội viên không thể đăng nhập vào ứng dụng

Triệu chứng: "No record found" ở bước Send code.

Nguyên nhân: Số điện thoại/email họ nhập không khớp với bất kỳ bản ghi nào trong Users.

Cách giải quyết: Tìm hàng của họ trong Users và so sánh chính xác các thông tin định danh — định dạng số khác, email cũ hoặc thiếu thông tin định danh là những nguyên nhân thường gặp. Cập nhật hàng đó (hoặc yêu cầu hội viên dùng thông tin định danh đã lưu). Hãy nhớ rằng mỗi hàng cần ít nhất một trong hai thông tin: số điện thoại hoặc email.

Triệu chứng: "Too many attempts."

Nguyên nhân: Giới hạn tần suất — 5 lần yêu cầu mã mỗi giờ cho mỗi thông tin liên hệ, cộng với giới hạn ở cấp mạng.

Cách giải quyết: Hãy chờ hết thời gian giới hạn; giới hạn theo từng thông tin liên hệ là biện pháp bảo mật và không thể gỡ bỏ.

Sự cố lời mời

Xem bảng riêng trong Lời mời sử dụng ứng dụng → Khắc phục sự cố. Tóm tắt nhanh: Send failed → kiểm tra địa chỉ và gửi lại; không được đưa vào lượt gửi hàng loạt → họ đã được mời, đã sử dụng ứng dụng, không có email hoặc không có quyền truy cập.

Người dùng được đồng bộ bị thiếu hoặc không cập nhật

Triệu chứng: Một người có trong hệ thống hội viên của bạn nhưng không có trong Users; hoặc thông tin của họ đã cũ.

Cách giải quyết:

1. Kiểm tra Settings → Sync settings — nguồn có được bật không? Tích hợp cụ thể có được bật không? Nếu thẻ hiển thị N removals held back for review, một lượt gỡ bỏ quy mô lớn đang chờ quản trị viên xem xét.
2. Mở rộng Sync activity & troubleshooting và tìm kiếm người đó — lý do bỏ qua cho bạn biết chính xác nguyên nhân (thiếu thông tin định danh, đã tách rời, tích hợp bị tắt, v.v.). Xem bảng lý do bỏ qua.
3. Kiểm tra công tắc Track source updates của người dùng — một hàng đã tách rời sẽ không bao giờ được cập nhật từ nguồn.
4. Nếu hàng hiển thị Not synced – duplicate, một bản ghi khác đang dùng chung email hoặc số điện thoại. Xem Xử lý trùng lặp.
5. Sử dụng Sync now để buộc chạy một lượt thay vì chờ lần đồng bộ đầy đủ hằng ngày.
6. Đối với Access Time Windows, hãy kiểm tra thêm tuổi của dữ liệu nguồn, kết quả phiên bản (updated/idempotent/stale/conflict) và ánh xạ scope_key. Một lần tải thất bại phải giữ nguyên ảnh chụp nhanh trước đó thay vì xóa nó.

Lịch tự động mở khóa không mở cửa

Triệu chứng: Cửa không được giữ mở trong khung thời gian đã lên lịch.

Cách giải quyết:

1. Mở tab Schedule của cửa và xác nhận Auto-unlock đang bật. Kiểm tra bản xem trước Next 14 days để biết khi nào cửa sẽ mở khóa.
2. Với Giờ có nhân viên tại cơ sở, hãy kiểm tra giờ có nhân viên và giờ nghỉ lễ của cơ sở trong Cấu hình cơ sở và hệ thống. Vào ngày lễ, On public holidays quyết định cửa sẽ theo giờ nghỉ lễ, luôn khóa hay bỏ qua ngày lễ.
3. Với Custom schedule, hãy kiểm tra ngày đó thực sự có khối giờ.
4. Kiểm tra xem nhân viên có dùng Lock now hay không: thẻ hiển thị Locked by staff until HH:MM. Resume schedule sẽ khôi phục lịch.
5. Hãy nhớ rằng các thay đổi về lịch chỉ có hiệu lực sau khi lưu, thao tác này sẽ tải lại bộ điều khiển (thường mất 10–15 giây).
6. Maintenance mode được ưu tiên — cửa ở chế độ Force closed sẽ không tự động mở.
7. Thời gian được tính theo múi giờ của cơ sở — hãy xác minh cài đặt múi giờ của cơ sở nếu các khung thời gian kích hoạt vào giờ bất thường.

Quản trị viên đã thay đổi cài đặt nhưng không có gì xảy ra

Triệu chứng: Đã chỉnh sửa chính sách/geofence/tin nhắn nhưng không có tác dụng.

Nguyên nhân: Các thay đổi trong tab Settings chỉ được áp dụng khi nhấp vào Save changes trên thanh lưu; nếu rời khỏi trang, hệ thống sẽ đề nghị hủy các thay đổi đó.

Cách giải quyết: Thực hiện lại và lưu. Các thay đổi về chính sách và geofence được áp dụng cho các lần thử ủy quyền tiếp theo; cài đặt phía ứng dụng sẽ xuất hiện khi ứng dụng của hội viên được làm mới lần tiếp theo.

Trang liên quan

• Khắc phục sự cố phần cứng — chẩn đoán nguồn điện, rơ-le và hệ thống dây khóa
• Nhật ký truy cập
• Lịch của Access Policy
• Tham khảo — mọi lý do từ chối và giá trị mặc định
• Câu hỏi thường gặp