Người dùng
Trên trang này
Tab Users liệt kê mọi người có thể (hoặc từng có thể) sử dụng ứng dụng di động để mở khóa cửa tại cơ sở này. Trang này đề cập đến việc thêm người dùng, nhập và xuất CSV, việc xác định Access Policy nào áp dụng, quyền cấp vĩnh viễn, các Access Time Windows riêng của quản trị viên/tích hợp, công tắc ngắt quyền truy cập, hoạt động trong ứng dụng, phiên đăng nhập và việc xóa người dùng.
Hình 1: Tab Users
Người dùng đến từ đâu
Mỗi hàng có một nguồn cho biết cách hàng đó được tạo:
| Nguồn | Huy hiệu | Cách các hàng xuất hiện | Ai duy trì dữ liệu |
|---|---|---|---|
| Manually added | Manual | Một quản trị viên đã nhấp vào Add user hoặc dùng Import (CSV) | Quản trị viên |
| External Integration | Integration (hoặc tên của đối tác) | Được đồng bộ tự động từ một tích hợp quản lý hội viên | Tính năng đồng bộ — các trường được đồng bộ bị ghi đè ở mỗi lượt |
| CCTV/Computer Vision | CCTV/Computer Vision | Được đồng bộ từ những người đã được nhận dạng trong mô-đun CCTV | Tính năng đồng bộ |
| Performance Hub staff | Performance Hub staff | Được đồng bộ tự động từ Performance Hub IAM cho những nhân viên có vai trò bao gồm cơ sở này | Performance Hub IAM |
Đồng bộ nhân viên Performance Hub được bật theo mặc định; đồng bộ từ tích hợp và Computer Vision tắt theo mặc định. Cấu hình các nguồn này trong Settings → Sync settings — xem Đồng bộ và tích hợp.
Mỗi hàng cần ít nhất một số điện thoại di động hoặc một địa chỉ email — đó là thông tin người dùng sử dụng để đăng nhập vào ứng dụng di động bằng mã dùng một lần.
Số liệu và bộ lọc
Hình 2: Các ô số liệu
| Ô | Hiển thị |
|---|---|
| All users | Mọi người dùng tại cơ sở này |
| Has access | Người dùng hiện có thể mở khóa ít nhất một cửa |
| No access | Người dùng hiện không thể mở khóa cửa nào |
| Not synced | Các bản ghi bị tạm giữ trong quá trình đồng bộ, ví dụ bản ghi trùng lặp |
Nhấp vào một ô để lọc danh sách. (Việc chọn một ô cũng sẽ đặt lại bộ lọc Source.)
Hình 3: Tìm kiếm, Export CSV, Import, Add user, các thẻ bộ lọc và sắp xếp
- Search — khớp với tên, số điện thoại hoặc email.
- Xuất CSV — tải xuống danh sách đã lọc hiện tại. Ví dụ: một phòng tập có thể xuất danh sách người dùng No access trước chiến dịch thu hút hội viên quay lại.
- Import và Add user — xem bên dưới.
- Các thẻ bộ lọc:
| Thẻ | Tùy chọn |
|---|---|
| Source | All sources, Manually added, External Integration, CCTV/Computer Vision, Performance Hub staff |
| Access | Any status, Has access, No access, Disabled, Without grants |
| Membership status | Any membership + các trạng thái có trong dữ liệu của bạn |
| Person type | Any type + các loại có trong dữ liệu của bạn |
| Tag | Any tag + các thẻ có trong dữ liệu của bạn |
| Invitation | Any invitation, Invited, Not invited, Send failed |
| App adoption | Any adoption, Active (đã sử dụng ứng dụng), Not yet active |
| Sync status | Any status, hoặc chỉ các bản ghi bị tạm giữ trong quá trình đồng bộ (ví dụ bản ghi trùng lặp) |
- Sort by — Name, Recently added, Recently updated, Last used, Last synced; kèm nút chuyển tăng dần/giảm dần.
- Clear filters xuất hiện bất cứ khi nào có tìm kiếm hoặc bộ lọc đang hoạt động.
Đọc một hàng người dùng
Hình 4: Các hàng người dùng với huy hiệu
| Huy hiệu | Ý nghĩa |
|---|---|
| Manual / Integration / CCTV/Computer Vision (hoặc tên đối tác) | Nguồn của hàng |
| Performance Hub staff | Hàng được đồng bộ từ Performance Hub IAM |
| Message | Người dùng có tin nhắn trong ứng dụng đang hoạt động (màu sắc theo mức độ nghiêm trọng) |
| Disabled | Access enabled đang tắt — người dùng không thể mở khóa bất cứ thứ gì; hàng bị làm mờ |
| Access granted via policy | Ít nhất một Access Policy đang bật có thể khớp với người dùng này và một cửa đã cấu hình ngay bây giờ hoặc trong một khung thời gian chính sách sắp tới |
| Access via time windows | Người dùng có Access Time Windows do quản trị viên hoặc tích hợp sở hữu; mở hàng để xem chúng đang hoạt động, sắp tới, đã hết hạn, đã lỗi thời hay chưa được ánh xạ |
| Grants | Người dùng có các quyền cấp vĩnh viễn riêng cho từng người dùng |
| Not synced – duplicate | Một bản ghi khác có cùng email hoặc số điện thoại đã giữ vị trí; bản ghi này không được đồng bộ. Xem Xử lý trùng lặp |
| Invited | Email mời đã được gửi và người dùng chưa sử dụng ứng dụng |
| Trạng thái hội viên (ví dụ Current, Expired) | Trạng thái hội viên của người dùng từ hệ thống nguồn |
Các hàng được đồng bộ cũng hiển thị External ID hoặc Computer Vision ID bên dưới tên. Các hàng nhân viên hiển thị vai trò Performance Hub của họ thay vào đó.
Danh sách lớn được tải dần: trong khi phần còn lại của danh sách đang tải, cuối danh sách hiển thị N more users loading….
Thêm người dùng thủ công
- Nhấp vào Add user.
Hình 5: Hộp thoại Add user
- Điền First name, Last name và ít nhất một trong hai trường Mobile phone hoặc Email — "At least one of mobile phone or email is required for OTP login." Số điện thoại được chuẩn hóa sang định dạng quốc tế.
- Tùy chọn đặt Person type (ví dụ: Gold, Trial, Staff), Custom tags (phân tách bằng dấu phẩy; các thẻ hiện có được liệt kê bên dưới trường) và Notes.
- Đánh dấu Send email invitation để gửi ngay email chứa liên kết tải ứng dụng cho người đó (yêu cầu địa chỉ email; hộp kiểm bị vô hiệu hóa nếu không có email).
- Nhấp vào Add user.
Nếu đã có người dùng với cùng số điện thoại/email tại cơ sở này, hộp thoại sẽ thông báo cho bạn và đề xuất Open existing user thay vì tạo bản ghi trùng lặp.
Việc thêm người dùng tự nó không cho phép họ đi qua bất kỳ cửa nào. Họ vẫn cần một Access Policy phù hợp, một quyền cấp vĩnh viễn hoặc một Access Time Window riêng của quản trị viên/tích hợp.
Nhập người dùng từ CSV
Nhấp vào Import để tạo hàng loạt người dùng từ một bảng tính. Tối đa 200 người dùng mỗi lần nhập.
Hình 6: Trình hướng dẫn nhập CSV
Bước 1 — Tải lên tệp CSV. Kéo tệp .csv vào hoặc nhấp để duyệt. Download template cung cấp cho bạn tệp mẫu có tiêu đề cột đúng.
Bước 2 — Ánh xạ trường. Mỗi cột CSV được ánh xạ tới một trường: First name, Last name, Mobile phone, Email, Person type, Tags, Notes, Access enabled, Door grants, Scope grants — hoặc Do not import. Các tên tiêu đề phổ biến (ví dụ: mobile, phone, groups) được ánh xạ tự động. Bạn phải ánh xạ ít nhất một cột số điện thoại di động hoặc email.
- Access enabled chấp nhận
true/yes/enabled/1/on/y/activevàfalse/no/disabled/0/off/n/inactive. - Door grants / Scope grants nhận tên của cửa hoặc Access Scope; các tên không khớp sẽ được đánh dấu trong bản xem trước.
Bước 3 — Xem trước và nhập. Xem lại các hàng đầu tiên, chọn có Send invitation email to imported users hay không (chỉ những người dùng có email mới được mời), sau đó nhấp vào Import. Kết quả hiển thị số lượng Imported, Skipped (already exist) và Errors.
Bảng chi tiết người dùng
Nhấp vào bất kỳ hàng nào để mở bảng của người dùng.
Hình 7: Bảng của một hội viên được đồng bộ
Hồ sơ và danh tính
Phần đầu hiển thị nguồn, trạng thái hội viên, External ID và việc người dùng có được một chính sách cho phép hay không.
- First name / Last name / Mobile phone / Email — đối với người dùng được đồng bộ, các trường này bị ghi đè ở mỗi lượt đồng bộ trừ khi hàng đã được tách rời (bên dưới).
- Person type và Membership status — được dùng trong các điều kiện Who của Access Policy.
- Synced tags (chỉ đọc, từ hệ thống nguồn) và Custom tags (do quản trị viên sở hữu, không bao giờ bị đồng bộ ghi đè). Cả hai loại đều có thể đáp ứng thẻ của chính sách.
- Notes — văn bản tự do, tối đa 2000 ký tự.
Tin nhắn trong ứng dụng
App messaging đặt một tin nhắn cá nhân hiển thị trên trang chính trong ứng dụng của người dùng này, xếp phía trên biểu ngữ toàn cơ sở khi cả hai cùng hoạt động. Khi một tin nhắn tự động được áp dụng, bảng sẽ hiển thị tin nhắn đó kèm các điều khiển để tắt tính năng tự động cho người dùng này. Xem Tin nhắn trong ứng dụng.
Track source updates (chỉ dành cho người dùng được đồng bộ)
Đối với người dùng Integration/CCTV, công tắc Track source updates kiểm soát việc đồng bộ có tiếp tục ghi đè hàng hay không:
- Bật (mặc định): tên, số điện thoại, email, loại, trạng thái, các thẻ được đồng bộ và Access Time Windows do nguồn sở hữu được làm mới sau mỗi lần đồng bộ thành công.
- Tắt (tách rời): sau khi bạn xác nhận rõ ràng, các Access Time Windows do nguồn sở hữu sẽ bị xóa và đồng bộ bỏ qua hoàn toàn hàng này. Các chỉnh sửa thủ công của bạn và các khung thời gian do quản trị viên sở hữu được giữ nguyên, và việc gỡ bỏ từ nguồn không còn ảnh hưởng đến hàng này. Hàng hiển thị huy hiệu Decoupled.
Bật lại để liên kết lại. Ảnh chụp nhanh khung thời gian hiện tại của nguồn được khôi phục ở lần đồng bộ đầy đủ thành công tiếp theo, chứ không phải từ một lần tải nguồn thất bại hoặc không đầy đủ.
Bảng của người dùng được đồng bộ cũng bao gồm liên kết đến bản ghi nguồn (bản ghi Integration hoặc người trong Computer Vision).
Đã xóa bởi tích hợp
Khi một hội viên bị xóa trong tích hợp, quyền truy cập cửa của họ sẽ bị gỡ bỏ và bảng hiển thị Removed by integration. Hàng vẫn ở trong danh sách để lịch sử được giữ lại. Xem Đồng bộ và tích hợp.
Kiểm soát Truy cập
Hình 8: Phần Access Control
Phần Access Control gom các cài đặt ủy quyền của người dùng lại với nhau: công tắc ngắt quyền truy cập, phạm vi áp dụng chính sách, quyền truy cập vĩnh viễn bổ sung và Access Time Windows của quản trị viên/tích hợp.
Access enabled (công tắc ngắt)
Công tắc Access enabled chặn hoặc khôi phục ngay lập tức mọi quyền truy cập cửa của người dùng này. Khi tắt:
- Mọi lần thử mở khóa của hội viên đều bị từ chối (lý do: quyền truy cập bị vô hiệu hóa), bất kể chính sách, quyền cấp hay Access Time Windows.
- Hàng hiển thị huy hiệu Disabled và bị làm mờ trong danh sách.
Sử dụng công tắc này để tạm ngưng quyền của một người ngay lập tức mà không cần xóa bản ghi hoặc thay đổi chính sách.
Quyền truy cập vĩnh viễn bổ sung
Quyền cấp cho phép riêng người này truy cập bổ sung cho bất cứ điều gì mà Access Policies của cơ sở cho phép. Khi một chính sách đã bao gồm người dùng, phần này hiển thị Allowed by policy và "This user's door access is set by policy — no manual grants are needed." Nhấp vào Show để mở trình chỉnh sửa quyền cấp:
| Quyền cấp | Tác dụng |
|---|---|
| Facility-wide | Mọi cửa tại cơ sở (ghi đè danh sách cửa/phạm vi khi bật) |
| Door grants | Đánh dấu từng cửa |
| Scope grants | Đánh dấu Access Scopes — người dùng được quyền vào mọi cửa trong phạm vi, kể cả những cửa được thêm vào phạm vi sau này |
Các cửa đã được một chính sách bao gồm sẽ được đánh dấu Already covered by policy hoặc Set by policy, để bạn thấy được chỗ nào không cần quyền cấp thủ công. Quyền cấp có thể có giờ hoạt động riêng, giới hạn thời điểm quyền cấp được áp dụng. Clear all gỡ bỏ mọi quyền cấp cùng lúc. Việc nhập chính sách tự động và các chỉnh sửa chính sách sau đó không thay đổi quyền cấp vĩnh viễn.
Các chỉ báo chính sách và quyền cấp mang tính bổ sung. Việc gỡ bỏ một quyền cấp thủ công dư thừa không gỡ bỏ quyền truy cập theo chính sách, và việc chỉnh sửa một chính sách không gỡ bỏ quyền cấp.
Khung thời gian Cấp quyền
Phần Access Time Windows quản lý quyền truy cập bổ sung tạm thời cho người này, với Add one-time window và Add weekly window (tối đa 50):
- Các khung thời gian tuyệt đối và hằng tuần do quản trị viên sở hữu có thể chỉnh sửa và có thể nhắm tới cơ sở, các cửa được chọn hoặc Access Scopes.
- Các khung thời gian do tích hợp sở hữu chỉ có thể xem và hiển thị nguồn, ID nguồn, múi giờ được khai báo, ánh xạ phạm vi logic, tuổi của dữ liệu nguồn và trạng thái độ mới.
- Các trạng thái đang hoạt động, sắp tới, đã hết hạn, đã lỗi thời và chưa được ánh xạ được hiển thị riêng biệt. Khung thời gian đã lỗi thời hoặc chưa được ánh xạ không cấp quyền truy cập, nhưng Access Policies và quyền cấp vĩnh viễn vẫn là các đường dự phòng.
- Các thời điểm chính xác sử dụng ranh giới
[from, to). Khung thời gian hằng tuần sử dụng múi giờ IANA được hiển thị và các quy tắc giờ mùa hè của múi giờ đó.
Bảng có ghi chú: "Time windows add access. They do not restrict existing rules or grants." Xem Lịch của Access Policy.
Lời mời
Cho biết email mời sử dụng ứng dụng đã được gửi hay chưa, thời điểm gửi và có bị lỗi hay không; nút hiển thị Send invitation email hoặc Resend invitation email. Lời mời chỉ được gửi qua email. Xem chi tiết đầy đủ trong Lời mời sử dụng ứng dụng.
Phiên đăng nhập và hoạt động trong ứng dụng
- App activity — Last used the app kèm dấu thời gian (hoặc "Hasn't used the app yet.") và các địa chỉ IP gần đây.
- Sessions — Sign out of app thu hồi phiên ứng dụng của người dùng: "This revokes the user's app session. They'll need to sign in again to unlock doors." Lưu ý: "Sessions are revoked immediately, but if the user is currently signed in it may take up to 15 minutes before they're fully signed out of the app." Vì phiên được xác định theo số điện thoại/email, một người dùng cùng số điện thoại/email tại cơ sở khác cũng sẽ bị đăng xuất ở đó.
Xóa người dùng
Hình 9: Vùng nguy hiểm
Delete user gỡ hàng khỏi Users. "Their access log history is kept for the audit trail." Việc xóa cũng vô hiệu hóa quyền truy cập của họ ngay lập tức. Đối với người dùng được đồng bộ, lưu ý rằng người đó có thể xuất hiện lại ở lần đồng bộ tiếp theo trừ khi bạn cũng tắt tích hợp hoặc tách rời hàng — để xóa toàn bộ người dùng của các tích hợp, hãy dùng Bulk delete synced users trong Đồng bộ và tích hợp.
Nhân viên Performance Hub
Hình 10: Bảng của một nhân viên Performance Hub
Bảng của nhân viên có biểu ngữ Synced from Performance Hub IAM. Nhân viên được thêm tự động vì vai trò Performance Hub của họ bao gồm cơ sở này, và bị gỡ bỏ khi quyền truy cập đó kết thúc. Biểu ngữ liệt kê các vai trò của họ.
- Tên, email, số điện thoại và loại người được quản lý trong Performance Hub IAM và chỉ có thể xem tại đây.
- Synced tags (chẳng hạn Performance Hub staff và Role: …) bị ghi đè ở mỗi lần đồng bộ. Bạn vẫn có thể thêm Custom tags và Notes.
- Không thể xóa nhân viên tại đây. Hãy gỡ quyền truy cập cơ sở của họ trong Performance Hub IAM, hoặc tắt Access enabled để chấm dứt quyền truy cập cửa của họ ngay lập tức.
Xem Đồng bộ nhân viên Performance Hub.