Referensi
Di halaman ini
Tabel lengkap untuk Door & Gate Access: setiap status peristiwa, alasan penolakan, pengaturan, nilai default, batas, dan nilai opsi dalam satu tempat. Gunakan halaman ini untuk mencari arti persis suatu nilai; halaman panduan yang ditautkan menjelaskan cara menggunakan setiap fitur.
Status peristiwa akses
Ditampilkan di Access Logs:
| Status | Arti |
|---|---|
| Request received | Permintaan buka kunci telah diterima dan sedang dievaluasi (sementara) |
| Pending | Permintaan lolos pemeriksaan dan menunggu dikirim (sementara) |
| Unlocked | Pembukaan kunci dilaporkan berhasil |
| Confirmed unlocked | Pengontrol pintu mengonfirmasi bahwa relai telah dilepaskan |
| Admin Unlocked | Admin memicu pembukaan kunci dari Performance Hub (admin override); dicatat saat perintah dikirim |
| Denied | Permintaan ditolak — lihat alasan penolakan pada peristiwa |
| Timed out | Perintah telah dikirim tetapi pengontrol tidak mengonfirmasi tepat waktu |
| Failed | Pembukaan kunci tidak dapat diselesaikan karena terjadi kesalahan |
| Locked by staff | Staf menggunakan Lock now saat jadwal buka kunci otomatis sedang menahan pintu terbuka (peristiwa jadwal, bukan upaya buka kunci) |
| Schedule resumed | Jadwal buka kunci otomatis kembali mengambil alih (peristiwa jadwal, bukan upaya buka kunci) |
Siklus hidup peristiwa: diterima → dikirim → dikonfirmasi terbuka / ditolak / waktu habis / gagal.
Alasan penolakan
Setiap pembukaan kunci yang ditolak/gagal mencatat alasan. Tabel ini memetakan alasan tersebut ke apa yang dilihat anggota dan cara memperbaikinya:
| Alasan (seperti yang dicatat) | Pesan yang dilihat anggota | Penyebab | Solusi |
|---|---|---|---|
access_disabled | "Your access has been suspended — please contact the facility" | Sakelar Access enabled pengguna nonaktif | Aktifkan kembali di panel pengguna di Users |
no_matching_policy_or_grant | "You don't have access to this door" | Tidak ada Access Policy yang cocok dengan Who DAN Where DAN When dan tidak ada jalur pemberian akses tambahan yang mengizinkan akses | Tinjau Access Policies, atribut pengguna, target/pengecualian, jadwal, dan pemberian akses |
no_matching_policy_target | "You don't have access to this door" | Tidak ada Access Policy aktif yang menargetkan pintu ini untuk permintaan tersebut | Tambahkan pintu atau Access Scope-nya ke suatu kebijakan, atau gunakan target semua pintu |
no_matching_policy_audience | "You don't have access to this door" | Kebijakan menargetkan pintu, tetapi tidak ada yang cocok dengan jenis/status atau tag orang tersebut | Tinjau bagian Who pada kebijakan dan catatan Users |
outside_policy_schedule | "Outside allowed access hours" | Who dan Where cocok, tetapi semua jadwal kebijakan yang cocok tidak aktif atau sudah kedaluwarsa | Tinjau bagian When pada kebijakan dan zona waktu fasilitas |
outside_geofence | "Move closer — you're outside the location's geofence." | Lokasi yang dilaporkan berada di luar radius + akurasi GPS + buffer dari titik pusat geofence | Anggota mendekat; atau tinjau radius/pin geofence |
gps_too_imprecise | "Couldn't pin down your location accurately. Try again outdoors." | Akurasi GPS ponsel lebih buruk dari ambang batas Require GPS accuracy better than | Anggota mencoba lagi di luar ruangan / jauh dari gangguan; atau naikkan ambang batas |
location_unavailable | "Couldn't read your location. Make sure Location is enabled and set to Precise, then try again." | Ponsel tidak melaporkan lokasi yang dapat digunakan | Anggota mengaktifkan Location (Precise) untuk aplikasi |
geofence_misconfigured | Pembukaan kunci ditolak | Geofence diaktifkan tetapi titik pusat/pin-nya tidak ada — sistem tidak memberikan akses dalam kondisi ini | Tempatkan pin geofence di Settings → Geofencing |
device_offline | "Door is offline. Please contact the facility." | Pengontrol pintu belum melapor (tidak ada heartbeat dalam 5 menit) | Pulihkan daya/jaringan ke pengontrol — lihat Pemecahan masalah |
user_deleted | "You don't have access…" | Catatan Users telah dihapus | Buat ulang atau pulihkan pengguna |
outside_access_time_window | Pintu dinonaktifkan dengan ketersediaan berikutnya jika diketahui | Jendela waktu mendatang adalah satu-satunya jalur izin potensial bagi pengguna dan belum aktif | Periksa ketersediaan yang diberikan, zona waktu, kebaruan sumber, dan pemetaan; Access Policies dan pemberian akses tetap berlaku secara independen |
Beberapa versi aplikasi menampilkan pesan yang lebih umum "You don't have access to this door" atau "Outside allowed access hours" untuk penolakan yang spesifik terhadap kebijakan. Access Logs menyimpan alasan terperinci untuk administrator.
Kebijakan Akses
| Properti | Arti |
|---|---|
| Bentuk kebijakan | Nama unik, deskripsi opsional, penanda aktif, penerima Who, target/pengecualian Where, jadwal When |
| Kecocokan kebijakan | Who DAN Where DAN When |
| Beberapa kebijakan | ATAU; kebijakan aktif mana pun yang cocok akan mengizinkan |
| Who | Jenis orang ditambah status opsional, ATAU tag yang disinkronkan/kustom; status kosong = status apa pun |
| Where | Semua pintu fasilitas, Access Scopes, pintu individual, atau kombinasinya; pengecualian berlaku di dalam kebijakan tersebut |
| When | Anytime, atau jendela waktu Weekly/One-time yang digabungkan dengan ATAU |
| Jalur izin lainnya | Pemberian akses permanen dan jendela waktu administrator/integrasi tetap terpisah dan bersifat menambah |
| Keselamatan | Pengguna yang dihapus/dinonaktifkan/diblokir sinkronisasi, penghapusan/blokir pintu, pemeliharaan, geofence, batas laju, dan pemeriksaan pengontrol tetap berlaku |
| Konfigurasi yang sudah ada | Diimpor secara otomatis ke kebijakan bernama yang setara dengan Who, Where, dan When yang eksplisit |
Atribusi kebijakan
Access Logs mengidentifikasi kebijakan yang cocok berdasarkan nama dan dapat menampilkan penerima, target, dan jadwalnya. Kecocokan terjadwal juga dapat menyertakan waktu mulai dan selesai konkret yang aktif.
Referensi Access Time Window
| Properti | Arti |
|---|---|
| Otorisasi | Jendela waktu jadwal kebijakan adalah When dari kebijakan; jendela waktu administrator/integrasi adalah jalur izin tambahan yang terpisah |
| Batas absolut | Waktu UTC berupa detik Unix bilangan bulat, [from, to) |
| Zona waktu absolut | Metadata tampilan/audit; tidak menggeser epoch |
| Batas Weekly | Blok HH:mm lokal dengan akhir eksklusif |
| Zona waktu Weekly | Zona waktu IANA yang valid yang menentukan hari/jam lokal dan DST |
| Batas berlaku Weekly | active-from/active-until opsional dalam detik Unix; akhir eksklusif |
| Melewati tengah malam/tumpang tindih | Tidak diterima; pisahkan periode yang melewati tengah malam ke beberapa hari dan pastikan blok tidak tumpang tindih |
| Kepemilikan pengguna | Administrator dan setiap sumber integrasi terisolasi; satu sumber tidak dapat menghapus milik sumber lain |
| Cakupan integrasi | scope_key sumber yang stabil, default default, dipetakan ke target PH; yang tidak dikenal/tidak dipetakan tidak memberikan akses |
| Kebaruan sumber | Dikonfigurasi sesuai ritme setiap integrasi; perilaku untuk sumber yang usang harus ditetapkan secara eksplisit |
| Keselamatan | Tidak pernah melewati pengguna yang dinonaktifkan/dihapus/berkonflik, blockAllAccess, pemeliharaan, geofence, batas laju, atau pemeriksaan pengontrol |
Batas awal: 50 jendela waktu per kontainer kebijakan/pemberian akses/sumber; rentang absolut maksimum 90 hari; 120 karakter untuk ID/label/kunci cakupan; delapan blok mingguan per hari; entri yang baru ditulis tidak boleh sudah kedaluwarsa lebih dari satu jam.
Pengaturan, nilai default, dan rentang
Pengaturan pintu
| Pengaturan | Default | Rentang / opsi |
|---|---|---|
| Waktu tahan | 10 detik | 1–30 detik |
| Mode pemeliharaan | Normal | Normal / Force open / Force closed |
| Suara pintu terbuka | Nonaktif | Aktif / Nonaktif |
| Label lokasi pintu | — | Teks bebas, maks. 64 karakter |
| Ikon | Door | 10 opsi (di bawah) |
| Jadwal buka kunci otomatis | Nonaktif | Jam Kehadiran Staf Fasilitas atau Custom schedule, zona waktu fasilitas |
| Waktu Unlock / Lock buka kunci otomatis | At opening / At closing | At opening / At closing, atau 5, 10, 15, 30, 45, 60, 90, atau 120 menit sebelum atau sesudahnya |
| Buka kunci otomatis pada hari libur nasional | Ignore holidays | Follow the facility's holiday hours / Stay locked all day / Ignore holidays |
| Otorisasi akses (per pintu) | Access Policies | Mencantumkan kebijakan yang cocok dan mengizinkan blockAllAccess |
| Geofence (per pintu) | Inherit from facility | Inherit from facility / Override for this door / Disable geofence for this door |
| Ambang batas daring | — | Pengontrol dianggap daring jika ada heartbeat dalam 5 menit terakhir |
Ikon pintu
| Ikon | Penggunaan |
|---|---|
| Door | Pintu tunggal standar (default) |
| Sliding door | Pintu geser / otomatis |
| Double door | Pintu ganda / pintu Prancis |
| Garage | Pintu garasi / pintu gulung |
| Boom gate | Palang gerbang / lengan penghalang |
| Pedestrian | Pintu masuk staf / pejalan kaki |
| Security | Pintu terbatas / keamanan |
| Office | Kantor / ruangan khusus staf |
| Delivery | Dok bongkar muat / area pengiriman |
| Locker | Loker / gudang |
Pengaturan geofence
| Pengaturan | Default | Rentang |
|---|---|---|
| Geofence diaktifkan | Aktif (untuk konfigurasi fasilitas baru) | Aktif / Nonaktif |
| Radius | 200 m | 50–5000 m (kelipatan 10 m; preset 50 / 200 / 500 / 1000 m) |
| Buffer akurasi | 25 m | — |
| Require GPS accuracy better than | 100 m | — |
| Rumus batas toleransi | — | radius + akurasi GPS yang dilaporkan + buffer akurasi |
Masa tenggang akses
Di Settings → Access Time Windows:
| Pengaturan | Opsi |
|---|---|
| Allow early access | Nonaktif / 5 / 10 / 15 / 30 menit |
| Allow access after end | Nonaktif / 5 / 10 / 15 / 30 menit |
Pengaturan kunci aplikasi
| Pengaturan | Default | Opsi |
|---|---|---|
| Enforce app lock for this facility | Nonaktif | Aktif / Nonaktif |
| Grace period before re-prompting | 5 menit | Always prompt / 1 min / 5 min / 15 min / 30 min / 1 hour |
| Perilaku multi-fasilitas | — | Diwajibkan jika salah satu fasilitas yang terhubung mewajibkannya; masa tenggang terpendek di antara fasilitas yang mewajibkan yang berlaku |
Kontak dukungan
| Mode | Perilaku |
|---|---|
| Smart (default) | Ditampilkan secara otomatis saat pintu luring atau informasi di antarmuka terbatas |
| Always show | Selalu ada di dasbor aplikasi |
| Never show | Tidak pernah ditampilkan |
Pesan aplikasi
| Isian | Batas / opsi |
|---|---|
| Notification type | Information / Notice / Urgent |
| Title | 120 karakter |
| Body | 2000 karakter (peringatan ringan pada 500) |
| Link URL | Hanya http(s), 2000 karakter |
| Link label | 80 karakter, default "More info" |
| Schedule | Starts at / Ends at opsional |
| Placeholder (aturan otomatis) | {firstName}, {lastName} |
| Isian pencocokan aturan otomatis | Membership status / Person type / Tag (tag mencocokkan yang disinkronkan + kustom, tidak membedakan huruf besar dan kecil) / Door visibility |
| Prioritas aturan | Aturan aktif pertama yang cocok yang berlaku (urutan daftar) |
Isian pengguna
| Isian | Batas / catatan |
|---|---|
| Nama depan / belakang | Masing-masing 80 karakter |
| Ponsel / email | Minimal satu wajib diisi (digunakan untuk masuk dengan OTP); nomor telepon dinormalisasi ke format internasional |
| Tag | 80 karakter per tag; tag yang disinkronkan ditimpa oleh sinkronisasi, tag kustom dimiliki admin |
| Catatan | 2000 karakter |
| Access enabled | Default aktif; nonaktif = semua pembukaan kunci ditolak |
| Pemberian akses | Seluruh fasilitas, daftar pintu, daftar cakupan, jam operasional opsional |
| Access Policies | Pengguna dapat dicakup oleh satu atau beberapa kebijakan bernama; daftar/akses efektif menggunakan Access granted via policy |
| Access Time Windows | Jendela waktu milik administrator yang dapat diedit ditambah jendela waktu milik sumber yang hanya dapat dibaca; terpisah dari jadwal kebijakan |
Sumber, status, dan enumerasi lainnya
| Enumerasi | Nilai |
|---|---|
| Sumber pengguna | Manually added / External Integration / CCTV-Computer Vision / Performance Hub staff |
| Ubin pengguna | All users / Has access / No access / Not synced |
| Status undangan | Not invited / Invited / Send failed |
| Penerima undangan | Only users with door access / All eligible synced users |
| Isian aturan undangan | Membership status / Person type / Tag / Sync source / Integration; operator is any of / is not any of |
| Tampilan Access Logs | Door events / No visit recorded |
| Adopsi aplikasi | Active (sudah menggunakan aplikasi) / Not yet active |
| Require identifier (sinkronisasi) | Email OR phone (default) / Email required / Phone required / Both required |
| Hasil log sinkronisasi | Added / Updated / Skipped / Disabled / Processed / Stale snapshot |
| Status jendela waktu | Active / Upcoming / Expired / Stale / Unmapped |
| Label status keanggotaan | Active, Current, Expired, On hold, Cancelled, Pending (ditambah nilai apa pun dari sistem sumber Anda) |
| Templat Access Scope | Custom, Main entrances, Staff-only, Restricted area, 24/7 access, Business hours, Vehicle access, Service entries |
| Templat pesan otomatis | No door access, Expired membership, Payment overdue, Account on hold / suspended, Welcome (new member), Trial / prospect, Document / waiver required |
Alasan sinkronisasi dilewati
| Alasan yang ditampilkan di log sinkronisasi | Arti |
|---|---|
| Integration sync is turned off for this facility | Sakelar utama sumber nonaktif |
| This integration is turned off in sync settings | Integrasi tertentu tidak diikutsertakan |
| No phone or email on the record (a phone or email is required to log in) | Catatan tidak memenuhi aturan Require identifier |
| Record is decoupled and managed manually | Track source updates nonaktif untuk pengguna ini |
| No facility on the source record | Catatan sumber tidak terhubung ke fasilitas ini |
| No matching user record | Perubahan merujuk ke orang yang tidak memiliki baris di sini |
Batas operasional
| Batas | Nilai |
|---|---|
| Impor CSV | 200 pengguna per impor |
| Undangan massal | Dikirim dalam batch berisi 50 |
| Contoh pratinjau penghapusan massal | 50 pengguna pertama ditampilkan |
| Kueri Access Logs | Hingga 500 peristiwa terbaru per jendela |
| Retensi peristiwa akses | ~13 bulan, lalu dihapus secara otomatis |
| Masa berlaku perintah buka kunci admin | 30 detik (perintah kedaluwarsa jika tidak terkirim) |
| Heartbeat pengontrol pintu | Setiap ~30 detik; luring setelah 5 menit tanpa sinyal |
| Permintaan kode masuk | 5 per jam per nomor telepon/email (batas keamanan, tidak dapat dicabut) |
| Propagasi keluar dari aplikasi | Langsung dicabut; hingga 15 menit hingga sesi aktif benar-benar berakhir |
| Menyimpan pengaturan pintu | Memuat ulang pengontrol — biasanya 10–15 detik |
| Retensi No visit recorded | ~13 bulan |
| Pemetaan Access Time Window | 50 per integrasi |
| Access Time Windows per kontainer | 50 |
| Rentang jendela waktu One-time | 90 hari |
| Blok Weekly | 8 per hari dalam seminggu |
| ID jendela waktu/sumber, label, kunci cakupan | 120 karakter |
| Access Policies per fasilitas | 100 |
| Total jendela waktu kebijakan | 500 |
| Nama/ID Access Policy | 120 karakter |
| Deskripsi Access Policy | 500 karakter |
| Konfigurasi Access Policy | 300 KiB UTF-8 |