Logo Performance HubPerformance Hub
Mục trang: Tài liệu

Cách đưa ra quyết định truy cập

Trên trang này

Trang này giải thích mô hình đằng sau mỗi lần mở khóa: ai được phép đi qua cửa, các bước kiểm tra chạy theo thứ tự nào, và cách Access Policies, quyền cấp cùng các bước kiểm tra an toàn tương tác với nhau. Hãy đọc trang này trước tiên — mọi trang khác đều dựa trên các khái niệm này.

Các cách cho phép bổ sung

Người dùng có thể được phép đi qua cửa thông qua bất kỳ chính sách hoặc quyền cấp nào. Chỉ cần đạt một cách là đủ; một cách không bao giờ làm giảm quyền truy cập do cách khác cung cấp.

CáchMô tảNơi cấu hình
Access PoliciesNhiều chính sách có tên, chỉ mang tính cho phép. Mỗi chính sách xác định Who, Where và When.Settings → Access Policies
Quyền cấp vĩnh viễnQuyền rõ ràng cho một người: toàn cơ sở, các cửa được chọn hoặc các Access Scopes được chọn, có thể kèm giờ riêng.Users → mở một người dùng → Access Control → Additional permanent access
Access Time WindowsQuyền truy cập tạm thời do quản trị viên quản lý cho một người và các mục tiêu cơ sở/cửa/phạm vi được chọn.Users → mở một người dùng → Access Time Windows
Integration Access Time WindowsCác khoảng thời gian chỉ đọc từ nguồn cho một người được đồng bộ, được ánh xạ từ các khóa phạm vi logic của nguồn.Dữ liệu nguồn cùng các ánh xạ trong Settings → Sync settings

Một chính sách chỉ khớp khi Who VÀ Where VÀ When đều khớp. Các chính sách được kết hợp theo phép HOẶC. Trong Who, các điều kiện loại người/trạng thái và thẻ là các lựa chọn thay thế cho nhau; trong When, các khoảng thời gian Weekly và One-time là các lựa chọn thay thế cho nhau. Where có thể bao gồm tất cả các cửa của cơ sở, Access Scopes, từng cửa riêng lẻ và các mục loại trừ.

Ví dụ: một chính sách "Active members" có thể bao gồm phạm vi Front entrances vào Anytime, trong khi một chính sách "Staff" riêng biệt bao gồm tất cả các cửa của cơ sở ngoại trừ Plant room. Một nhân viên vệ sinh không khớp với chính sách nào vẫn có thể nhận quyền cấp vĩnh viễn cho phạm vi Service entries.

Quyền cấp vĩnh viễn và các khoảng thời gian do quản trị viên/tích hợp tạo luôn riêng biệt và mang tính bổ sung. Việc chỉnh sửa chính sách và nhập tự động không hấp thụ hay xóa bỏ chúng.

Nhân viên Performance Hub được đồng bộ vào Users sẽ nhận quyền truy cập cửa thông qua chính sách Performance Hub staff có thể chỉnh sửa, giống như mọi chính sách khác. Xem Đồng bộ và tích hợp.

Toàn bộ trình tự quyết định

Khi người dùng chạm vào Unlock trong ứng dụng di động, máy chủ sẽ kiểm tra các mục sau theo thứ tự. Bước kiểm tra đầu tiên không đạt sẽ từ chối lần mở khóa và ghi lại lý do trong Nhật ký truy cập.

  1. Quyền truy cập của người dùng có được bật không? Công tắc Access enabled trên hàng của người dùng trong Users là công tắc ngắt dành cho quản trị viên. Người dùng đã bị xóa, bị vô hiệu hóa hoặc bị chặn do đồng bộ không thể mở khóa bất kể chính sách hay quyền cấp. (Ví dụ: access_disabled.)
  2. Cửa có bị chặn hoặc đang bảo trì không? blockAllAccess được đặt rõ ràng sẽ từ chối mọi cách truy cập của hội viên. Chế độ bảo trì Force closed giữ cửa ở trạng thái khóa và ngừng phục vụ hội viên; Force open giữ cửa ở trạng thái mở khóa. Quản trị viên có thể mở khóa cửa từ xa; mọi lần mở khóa của quản trị viên đều được ghi lại trong Nhật ký truy cập.
  3. Có cách cho phép bổ sung nào đạt không?
    • Cách theo chính sách: bất kỳ chính sách có tên nào đang bật mà Who, Where và When đều khớp sẽ cho phép truy cập.
    • Cách theo quyền cấp vĩnh viễn: quyền cấp cho cơ sở, cửa hoặc Access Scope chứa cửa sẽ cho phép truy cập khi giờ tùy chọn của quyền cấp khớp.
    • Cách theo khoảng thời gian của người dùng: một Access Time Window do quản trị viên quản lý đang hoạt động và nhắm đến cửa này, cơ sở này hoặc một Access Scope chứa cửa.
    • Cách theo khoảng thời gian của tích hợp: một khoảng thời gian mới từ nguồn đang hoạt động và ánh xạ scope_key đã cấu hình của nó nhắm đến cửa này. Các khoảng thời gian từ nguồn đã cũ hoặc chưa được ánh xạ sẽ không cấp quyền truy cập.
    • Nếu không có cách nào đạt → bị từ chối (no_matching_policy_or_grant)
  4. Kiểm tra geofence (nếu được bật). Dựa trên vị trí mà điện thoại báo cáo:
    • Nếu điện thoại không thể cung cấp vị trí → bị từ chối (location_unavailable)
    • Nếu kết quả đo GPS kém chính xác hơn cài đặt Require GPS accuracy better than → bị từ chối (gps_too_imprecise)
    • Nếu khoảng cách từ người dùng đến tâm geofence vượt quá bán kính + độ chính xác GPS + vùng đệm độ chính xác → bị từ chối (outside_geofence)
    • Máy chủ có quyền quyết định cuối cùng — vị trí bị giả mạo trên điện thoại vẫn bị từ chối ở phía máy chủ.
  5. Bộ điều khiển cửa có đang trực tuyến không? Nếu bộ điều khiển chưa gửi tín hiệu (heartbeat trong vòng 5 phút gần nhất), lệnh mở khóa không thể được chuyển đến (device_offline). Nếu lệnh đã được gửi nhưng bộ điều khiển không xác nhận, sự kiện được ghi lại là Timed out.
  6. Mở khóa. Rơ-le nhả trong khoảng Hold time của cửa (1–30 giây, mặc định 10), sau đó tự động khóa lại. Sự kiện được ghi lại là Confirmed unlocked khi bộ điều khiển xác nhận.

Các khoảng thời gian One-time và Weekly có giới hạn dùng các mốc giới hạn là số nguyên giây Unix và ranh giới nửa mở [from, to): thời điểm bắt đầu được tính và thời điểm kết thúc thì không. Các khối Weekly dùng múi giờ IANA đã khai báo cùng các quy tắc giờ địa phương/giờ mùa hè (DST). Xem Lịch của Access Policy.

Các ứng dụng khách mới nhận được chi tiết outside_access_time_window cùng thông tin có cấu trúc về thời điểm khả dụng tiếp theo đối với cửa chỉ có khoảng thời gian trong tương lai. Trong giai đoạn triển khai tương thích, các ứng dụng khách cũ hơn tiếp tục nhận outside_access_hours làm lý do chính để cửa vẫn bị vô hiệu hóa một cách an toàn và vẫn hiển thị.

Cấu hình hiện có

Cấu hình truy cập hiện có được tự động nhập vào Access Policies. Quá trình nhập giữ nguyên những ai đã có quyền truy cập, các cửa hoặc Access Scopes mà họ có thể sử dụng, và các giờ áp dụng dưới dạng các giá trị Who, Where và When của chính sách. Quản trị viên quản lý trực tiếp các chính sách được tạo ra; không có chế độ triển khai hay quy trình chuyển đổi thủ công.

Việc kế thừa geofence vẫn độc lập với Access Policies. Các trường hợp khớp chính sách vẫn phải đi qua geofence có hiệu lực và mọi bước kiểm tra an toàn/thiết bị khác.

Đăng nhập bằng OTP làm được gì và không làm được gì

Việc đăng nhập vào ứng dụng di động (mã dùng một lần qua SMS hoặc email) chỉ là xác thực — nó chứng minh người dùng là ai. Bản thân việc đăng nhập không cấp quyền truy cập cửa. Mỗi lần mở khóa đều được cấp quyền riêng lẻ theo trình tự quyết định ở trên. Người dùng có thể đã đăng nhập vào ứng dụng nhưng vẫn thấy thông báo "You don't have access to this door."

Bảng thuật ngữ

Thuật ngữĐịnh nghĩa
Bộ điều khiển cửaThiết bị phần cứng được ghép nối với cửa/cổng để kích hoạt rơ-le khóa. Xuất hiện dưới dạng "cửa" trong mô-đun này và dưới dạng thiết bị trong Quản lý thiết bị.
CửaMột bộ điều khiển cửa được đăng ký tại cơ sở của bạn, với tên, nhãn vị trí, biểu tượng và cài đặt.
Hàng người dùngBản ghi của một người tại cơ sở này trong tab Users. Được tạo thủ công, bằng cách nhập CSV hoặc bằng đồng bộ. Lưu các thông tin nhận dạng liên hệ, loại/trạng thái/thẻ, quyền cấp và trạng thái ứng dụng.
NguồnNơi hàng người dùng được tạo ra: Manually added, External Integration, CCTV/Computer Vision hoặc Performance Hub staff.
Access PolicyMột chính sách có tên, chỉ mang tính cho phép, chứa Who, Where và When. Cả ba phải khớp; các chính sách được kết hợp theo phép HOẶC.
Điều kiện loại ngườiMột điều kiện Who của chính sách chứa một loại người và các trạng thái hội viên tùy chọn. Để trống trạng thái có nghĩa là bất kỳ trạng thái nào.
ThẻMột nhãn gắn với người dùng. Thẻ được đồng bộ đến từ tích hợp và bị ghi đè trong mỗi lần đồng bộ; thẻ tùy chỉnh do quản trị viên quản lý và không bao giờ bị ghi đè. Cả hai đều có thể đáp ứng điều kiện Who của chính sách.
Giờ hoạt động / khối thời gianCác khoảng thời gian theo ngày trong tuần (ví dụ: Mon 06:00–22:00) giới hạn thời điểm chính sách hoặc quyền cấp cho phép truy cập. Để trống = luôn được phép. Thời gian theo múi giờ của cơ sở.
Access Time WindowMột khoảng thời gian Weekly hoặc One-time được dùng trong lịch của chính sách hoặc trong một cách cấp quyền riêng do quản trị viên/tích hợp tạo.
Quyền cấp cho từng người dùngQuyền truy cập rõ ràng được cấp cho một người dùng: Facility-wide (mọi cửa), các cửa cụ thể hoặc các Access Scopes cụ thể — có thể kèm giờ hoạt động riêng.
Phạm vi truy cập (Access Scope)Một nhóm cửa có tên (ví dụ: "Main entrances", "Staff-only") được dùng làm mục tiêu của chính sách hoặc quyền cấp, và cho các cài đặt geofence ở cấp phạm vi. Trong nội bộ còn được gọi là nhóm cửa.
Mục loại trừ của chính sáchMột cửa hoặc Access Scope bị loại khỏi phần khớp Where của một chính sách. Mục loại trừ không từ chối chính sách hoặc cách cấp quyền khác.
GeofenceMột vòng tròn quanh cơ sở (tâm + bán kính). Khi được bật, người dùng phải thực sự ở bên trong vòng tròn này (có tính đến độ chính xác GPS và vùng đệm) để mở khóa.
Vùng đệm độ chính xácSố mét được cộng thêm vào bán kính geofence để chấp nhận sai số GPS thông thường. Mặc định 25 m.
Chế độ bảo trìCài đặt cho từng cửa nhằm đưa cửa ra khỏi trạng thái hoạt động bình thường: Normal, Force open (giữ mở khóa) hoặc Force closed (giữ khóa và ngừng phục vụ hội viên).
Block all accessBiện pháp chặn an toàn cho từng cửa, ghi đè các chính sách và quyền cấp cho từng người dùng tại cửa đó mà không cần dùng chế độ bảo trì. Quản trị viên vẫn có thể mở khóa.
Hold timeThời gian rơ-le được nhả sau khi mở khóa trước khi khóa lại. Phạm vi 1–30 giây, mặc định 10.
Lịch tự động mở khóaLịch cho từng cửa nhằm giữ cửa ở trạng thái mở khóa trong giờ có nhân viên tại cơ sở hoặc theo lịch tùy chỉnh. Độc lập với Access Policies.
Lock nowKhóa một cửa đang được lịch tự động mở khóa giữ mở, cho đến lần thay đổi tiếp theo của lịch. Resume schedule hoàn tác thao tác này.
Access enabledCông tắc ngắt cho từng người dùng. Tắt = người dùng không thể mở khóa bất cứ thứ gì.
Đã tách liên kếtMột người dùng được đồng bộ có công tắc Track source updates bị tắt. Các lượt đồng bộ bỏ qua hàng này, nhờ đó các chỉnh sửa của quản trị viên được giữ nguyên.
Lời mờiEmail được gửi cho người dùng kèm các liên kết tải xuống ứng dụng di động. Được theo dõi cho từng người dùng (Not invited / Invited / Send failed).
Đăng nhập bằng OTPCách đăng nhập không cần mật khẩu của ứng dụng di động: một mã dùng một lần được gửi đến điện thoại hoặc email của người dùng.
Ghi đè của quản trị viên / Mở khóa của quản trị viênMột lần mở khóa do quản trị viên kích hoạt từ Performance Hub (tab Doors → Open, hoặc Unlock door trong bảng cửa). Mọi lần mở khóa của quản trị viên đều được ghi lại trong Nhật ký truy cập theo tài khoản của quản trị viên.
Khóa ứng dụngXác thực lại trên thiết bị do cơ sở bắt buộc (Face ID / Touch ID / sinh trắc học Android / mật mã) trước khi có thể dùng ứng dụng.
Tin nhắn trong ứng dụngMột thẻ thông báo trên bảng điều khiển của ứng dụng — cho toàn cơ sở, cho từng người dùng, hoặc được đặt tự động bởi một quy tắc App Messaging.
Sự kiện truy cậpMột bản ghi trong Nhật ký truy cập: một lần thử mở khóa và kết quả của lần thử đó.