Pengguna
Pada halaman ini
Tab Users menyenaraikan setiap orang yang boleh (atau boleh pada masa lalu) menggunakan aplikasi mudah alih untuk membuka kunci pintu di kemudahan ini. Halaman ini merangkumi penambahan pengguna, import dan eksport CSV, atribusi Access Policy, pemberian kekal, Access Time Windows pentadbir/integrasi yang berasingan, suis pemutus akses, aktiviti aplikasi, sesi dan pemadaman.


Rajah 1: Tab Users
Dari mana pengguna datang
Setiap baris mempunyai sumber yang memberitahu anda cara ia dicipta:
| Sumber | Lencana | Cara baris muncul | Siapa yang menyelenggara data |
|---|---|---|---|
| Manually added | Manual | Pentadbir mengklik Add user atau menggunakan Import (CSV) | Pentadbir |
| External Integration | Integration (atau nama rakan kongsi) | Disegerakkan secara automatik daripada integrasi pengurusan ahli | Penyegerakan — medan yang disegerakkan ditulis ganti pada setiap pusingan |
| CCTV/Computer Vision | CCTV/Computer Vision | Disegerakkan daripada orang yang dikenal pasti dalam modul CCTV | Penyegerakan |
| Performance Hub staff | Performance Hub staff | Disegerakkan secara automatik daripada Performance Hub IAM bagi kakitangan yang peranannya merangkumi kemudahan ini | Performance Hub IAM |
Penyegerakan kakitangan Performance Hub dihidupkan secara lalai; penyegerakan integrasi dan Computer Vision dimatikan secara lalai. Konfigurasikannya di bawah Settings → Sync settings — lihat Penyegerakan & Integrasi.
Baris memerlukan sekurang-kurangnya telefon mudah alih atau alamat e-mel — itulah yang digunakan oleh orang tersebut untuk log masuk ke aplikasi mudah alih dengan kod sekali guna.
Statistik dan penapis


Rajah 2: Jubin statistik
| Jubin | Menunjukkan |
|---|---|
| All users | Setiap pengguna di kemudahan ini |
| Has access | Pengguna yang pada masa ini boleh membuka kunci sekurang-kurangnya satu pintu |
| No access | Pengguna yang pada masa ini tidak boleh membuka kunci mana-mana pintu |
| Not synced | Rekod yang ditahan oleh penyegerakan, contohnya pendua |
Klik jubin untuk menapis senarai. (Memilih jubin juga menetapkan semula penapis Source.)


Rajah 3: Carian, Eksport CSV, Import, Add user, cip penapis dan isihan
- Search — memadankan nama, telefon atau e-mel.
- Eksport CSV — memuat turun senarai yang ditapis semasa. Contohnya, gim boleh mengeksport pengguna No access sebelum kempen memenangi semula pelanggan.
- Import dan Add user — lihat di bawah.
- Cip penapis:
| Cip | Pilihan |
|---|---|
| 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 + status yang terdapat dalam data anda |
| Person type | Any type + jenis yang terdapat dalam data anda |
| Tag | Any tag + tag yang terdapat dalam data anda |
| Invitation | Any invitation, Invited, Not invited, Send failed |
| App adoption | Any adoption, Active (telah menggunakan aplikasi), Not yet active |
| Sync status | Any status, atau hanya rekod yang ditahan oleh penyegerakan (contohnya pendua) |
- Sort by — Name, Recently added, Recently updated, Last used, Last synced; dengan togol menaik/menurun.
- Clear filters muncul setiap kali carian atau penapis aktif.
Membaca baris pengguna


Rajah 4: Baris pengguna dengan lencana
| Lencana | Maksud |
|---|---|
| Manual / Integration / CCTV/Computer Vision (atau nama rakan kongsi) | Sumber baris |
| Performance Hub staff | Baris disegerakkan daripada Performance Hub IAM |
| Message | Pengguna mempunyai mesej aplikasi yang aktif (diwarnakan mengikut tahap keterukan) |
| Disabled | Access enabled dimatikan — pengguna tidak boleh membuka kunci apa-apa; baris dimalapkan |
| Access granted via policy | Sekurang-kurangnya satu Access Policy yang didayakan boleh sepadan dengan pengguna ini dan pintu yang dikonfigurasikan sekarang atau dalam tetingkap polisi akan datang |
| Access via time windows | Pengguna mempunyai Access Time Windows milik pentadbir atau integrasi; buka baris untuk melihat sama ada ia aktif, akan datang, tamat tempoh, lapuk atau tidak dipetakan |
| Grants | Pengguna mempunyai pemberian kekal bagi setiap pengguna yang berasingan |
| Not synced – duplicate | Rekod lain dengan e-mel atau telefon yang sama telah mengekalkan slot; rekod ini tidak disegerakkan. Lihat Penyelesaian pendua |
| Invited | E-mel jemputan telah dihantar dan pengguna belum menggunakan aplikasi |
| Status keahlian (cth. Current, Expired) | Status keahlian pengguna daripada sistem sumber |
Baris yang disegerakkan juga menunjukkan External ID atau Computer Vision ID di bawah nama. Baris kakitangan menunjukkan peranan Performance Hub mereka.
Senarai besar dimuatkan secara beransur-ansur: semasa senarai selebihnya dimuatkan, bahagian bawah senarai menunjukkan N more users loading….
Menambah pengguna secara manual
- Klik Add user.


Rajah 5: Dialog Add user
- Isikan First name, Last name dan sekurang-kurangnya satu daripada Mobile phone atau Email — "At least one of mobile phone or email is required for OTP login." Nombor telefon dinormalkan kepada format antarabangsa.
- Secara pilihan, tetapkan Person type (cth. Gold, Trial, Staff), Custom tags (dipisahkan dengan koma; tag sedia ada disenaraikan di bawah medan) dan Notes.
- Tandakan Send email invitation untuk terus menghantar e-mel pautan muat turun aplikasi kepada orang tersebut (memerlukan alamat e-mel; kotak semak dinyahdayakan tanpanya).
- Klik Add user.
Jika pengguna dengan telefon/e-mel yang sama sudah wujud di kemudahan ini, dialog memberitahu anda dan menawarkan Open existing user dan bukannya mencipta pendua.
Menambah pengguna tidak dengan sendirinya membenarkan mereka melalui mana-mana pintu. Mereka masih memerlukan Access Policy yang sepadan, pemberian kekal, atau Access Time Window pentadbir/integrasi yang berasingan.
Mengimport pengguna daripada CSV
Klik Import untuk mencipta pengguna secara pukal daripada hamparan. Maksimum 200 pengguna bagi setiap import.


Rajah 6: Wizard import CSV
Langkah 1 — Muat naik CSV. Seret fail .csv ke dalam atau klik untuk menyemak imbas. Download template memberikan anda fail permulaan dengan pengepala yang betul.
Langkah 2 — Petakan medan. Setiap lajur CSV dipetakan kepada medan: First name, Last name, Mobile phone, Email, Person type, Tags, Notes, Access enabled, Door grants, Scope grants — atau Do not import. Nama pengepala biasa (cth. mobile, phone, groups) dipetakan secara automatik. Anda mesti memetakan sekurang-kurangnya lajur telefon mudah alih atau e-mel.
- Access enabled menerima
true/yes/enabled/1/on/y/activedanfalse/no/disabled/0/off/n/inactive. - Door grants / Scope grants menerima nama pintu atau Access Scope; nama yang tidak sepadan ditandakan dalam pratonton.
Langkah 3 — Pratonton & import. Semak baris pertama, pilih sama ada hendak Send invitation email to imported users (hanya pengguna dengan e-mel dijemput), kemudian klik Import. Keputusan menunjukkan kiraan Imported, Skipped (already exist) dan Errors.
Panel butiran pengguna
Klik mana-mana baris untuk membuka panel pengguna.


Rajah 7: Panel bagi ahli yang disegerakkan
Profil dan identiti
Pengepala menunjukkan sumber, status keahlian, External ID dan sama ada pengguna dibenarkan oleh polisi.
- First name / Last name / Mobile phone / Email — bagi pengguna yang disegerakkan, ini ditulis ganti oleh setiap pusingan penyegerakan melainkan baris dinyahgandingkan (di bawah).
- Person type dan Membership status — digunakan oleh syarat Who Access Policy.
- Synced tags (baca sahaja, daripada sistem sumber) dan Custom tags (milik pentadbir, tidak pernah ditulis ganti oleh penyegerakan). Kedua-dua jenis boleh memenuhi tag polisi.
- Notes — teks bebas, sehingga 2000 aksara.
Mesej aplikasi
App messaging menetapkan mesej peribadi yang dipaparkan pada papan pemuka aplikasi pengguna ini, disusun di atas sepanduk seluruh kemudahan apabila kedua-duanya aktif. Apabila mesej automatik terpakai, panel menunjukkannya dengan kawalan untuk mematikan automasi bagi pengguna ini. Lihat Pemesejan Aplikasi.
Track source updates (pengguna disegerakkan sahaja)
Bagi pengguna Integration/CCTV, togol Track source updates mengawal sama ada penyegerakan terus menulis ganti baris:
- Hidup (lalai): nama, telefon, e-mel, jenis, status, tag disegerakkan dan Access Time Windows milik sumber dimuat semula pada penyegerakan yang berjaya.
- Mati (dinyahgandingkan): selepas pengesahan yang jelas, Access Time Windows milik sumber dikosongkan dan penyegerakan melangkau baris ini sepenuhnya. Suntingan manual anda dan tetingkap milik pentadbir dikekalkan, dan pengalihan keluar di sumber tidak lagi menjejaskannya. Baris menunjukkan lencana Decoupled.
Hidupkan semula togol untuk menggandingkan semula. Petikan tetingkap sumber semasa dipulihkan pada penyegerakan lengkap seterusnya yang berjaya, bukan daripada pengambilan sumber yang gagal atau separa.
Panel bagi pengguna yang disegerakkan juga termasuk pautan ke rekod sumber (rekod Integration atau orang Computer Vision).
Alih keluar melalui integrasi
Apabila seorang ahli dipadamkan dalam integrasi, akses pintunya dialih keluar dan panel menunjukkan Removed by integration. Baris kekal dalam senarai supaya sejarahnya dikekalkan. Lihat Penyegerakan & Integrasi.
Kawalan Akses


Rajah 8: Bahagian Access Control
Bahagian Access Control menghimpunkan tetapan kebenaran pengguna: suis pemutus akses, liputan polisi, akses kekal tambahan dan Access Time Windows pentadbir/integrasi.
Access enabled (suis pemutus)
Togol Access enabled serta-merta menyekat atau memulihkan semua akses pintu bagi pengguna ini. Apabila dimatikan:
- Setiap percubaan membuka kunci oleh ahli ditolak (sebab: akses dinyahdayakan), tanpa mengira polisi, pemberian atau Access Time Windows.
- Baris menunjukkan lencana Disabled dan dimalapkan dalam senarai.
Gunakan ini untuk menggantung seseorang serta-merta tanpa memadam rekod mereka atau menukar polisi.
Akses kekal tambahan
Pemberian memberikan orang tertentu ini akses sebagai tambahan kepada apa sahaja yang dibenarkan oleh Access Policies kemudahan. Apabila polisi sudah meliputi pengguna, bahagian ini menunjukkan Allowed by policy dan "This user's door access is set by policy — no manual grants are needed." Klik Show untuk membuka editor pemberian:
| Pemberian | Kesan |
|---|---|
| Facility-wide | Setiap pintu di kemudahan (mengatasi senarai pintu/skop semasa dihidupkan) |
| Door grants | Tandakan pintu individu |
| Scope grants | Tandakan Access Scopes — pengguna mendapat setiap pintu dalam skop, termasuk pintu yang ditambah ke skop kemudian |
Pintu yang sudah diliputi oleh polisi ditandakan Already covered by policy atau Set by policy, supaya anda boleh melihat di mana pemberian manual tidak diperlukan. Pemberian boleh mempunyai waktu operasinya sendiri, yang mengehadkan bila pemberian terpakai. Clear all mengalih keluar setiap pemberian sekali gus. Import polisi automatik dan suntingan polisi kemudian tidak mengubah pemberian kekal.
Penunjuk polisi dan pemberian adalah tambahan. Mengalih keluar pemberian manual yang berlebihan tidak mengalih keluar akses polisi, dan menyunting polisi tidak mengalih keluar pemberian.
Tempoh Masa Akses
Bahagian Access Time Windows mengurus akses tambahan sementara bagi orang ini, dengan Add one-time window dan Add weekly window (sehingga 50):
- Tetingkap mutlak dan mingguan milik pentadbir boleh disunting dan boleh menyasarkan kemudahan, pintu terpilih atau Access Scopes.
- Tetingkap milik integrasi adalah baca sahaja dan menunjukkan sumbernya, ID sumber, zon waktu yang diisytiharkan, pemetaan skop logik, umur sumber dan keadaan kesegaran.
- Keadaan aktif, akan datang, tamat tempoh, lapuk dan tidak dipetakan ditunjukkan secara berasingan. Tetingkap yang lapuk atau tidak dipetakan tidak memberikan akses, tetapi Access Policies dan pemberian kekal kekal tersedia sebagai laluan sandaran.
- Saat yang tepat menggunakan sempadan
[from, to). Tetingkap mingguan menggunakan zon waktu IANA yang dipaparkan dan peraturan waktu jimat siangnya.
Panel menyatakan: "Time windows add access. They do not restrict existing rules or grants." Lihat Jadual Access Policy.
Jemputan
Menunjukkan sama ada e-mel jemputan aplikasi telah dihantar, bila, dan sama ada ia gagal; butang tertulis Send invitation email atau Resend invitation email. Jemputan hanya melalui e-mel. Butiran penuh dalam Jemputan.
Sesi dan aktiviti aplikasi
- App activity — Last used the app dengan cap masa (atau "Hasn't used the app yet.") dan alamat IP terkini.
- Sessions — Sign out of app membatalkan sesi aplikasi pengguna: "This revokes the user's app session. They'll need to sign in again to unlock doors." Nota: "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." Oleh sebab sesi dikunci mengikut telefon/e-mel, orang yang menggunakan telefon/e-mel yang sama di kemudahan lain juga dilog keluar di sana.
Memadam pengguna


Rajah 9: Zon bahaya
Delete user mengalih keluar baris daripada Users. "Their access log history is kept for the audit trail." Memadam juga menyahdayakan akses mereka serta-merta. Bagi pengguna yang disegerakkan, ambil perhatian bahawa orang tersebut boleh muncul semula pada penyegerakan seterusnya melainkan anda juga menyahdayakan integrasi atau menyahgandingkan — untuk mengosongkan keseluruhan integrasi, gunakan Bulk delete synced users dalam Penyegerakan & Integrasi.
Kakitangan Performance Hub


Rajah 10: Panel bagi kakitangan Performance Hub
Panel kakitangan mempunyai sepanduk Synced from Performance Hub IAM. Kakitangan ditambah secara automatik kerana peranan Performance Hub mereka merangkumi kemudahan ini, dan dialih keluar apabila akses tersebut berakhir. Sepanduk menyenaraikan peranan mereka.
- Nama, e-mel, telefon dan jenis orang diurus dalam Performance Hub IAM dan adalah baca sahaja di sini.
- Synced tags (seperti Performance Hub staff dan Role: …) ditulis ganti pada setiap penyegerakan. Anda masih boleh menambah Custom tags dan Notes.
- Kakitangan tidak boleh dipadamkan di sini. Alih keluar akses kemudahan mereka dalam Performance Hub IAM, atau matikan Access enabled untuk menghentikan akses pintu mereka serta-merta.
Lihat Penyegerakan kakitangan Performance Hub.