Cara Keputusan Akses Bekerja

Di halaman ini

Halaman ini menjelaskan model di balik setiap pembukaan kunci: siapa yang diizinkan melewati pintu, dalam urutan apa pemeriksaan dijalankan, dan bagaimana Access Policies, pemberian akses, dan pemeriksaan keselamatan saling berinteraksi. Baca halaman ini terlebih dahulu — setiap halaman lain dibangun di atas konsep-konsep ini.

Jalur izin yang bersifat menambah

Pengguna dapat diizinkan melewati pintu melalui jalur kebijakan atau pemberian akses mana pun. Lolos dari satu jalur sudah cukup; satu jalur tidak pernah mengurangi akses yang diberikan oleh jalur lain.

Jalur	Penjelasan	Tempat mengonfigurasi
Access Policies	Beberapa kebijakan bernama yang hanya bersifat mengizinkan. Setiap kebijakan menentukan Who, Where, dan When.	Settings → Access Policies
Pemberian akses permanen	Izin eksplisit untuk satu orang: seluruh fasilitas, pintu tertentu, atau Access Scopes tertentu, secara opsional dengan jamnya sendiri.	Users → buka pengguna → Access Control → Additional permanent access
Access Time Windows	Akses sementara milik administrator untuk satu orang dan target fasilitas/pintu/cakupan tertentu.	Users → buka pengguna → Access Time Windows
Integration Access Time Windows	Jendela waktu sumber yang hanya dapat dibaca untuk orang yang disinkronkan, dipetakan dari kunci cakupan sumber logis.	Data sumber ditambah pemetaan di Settings → Sync settings

Suatu kebijakan hanya cocok jika Who DAN Where DAN When cocok. Kebijakan-kebijakan digabungkan dengan ATAU. Di dalam Who, kondisi jenis orang/status dan tag merupakan alternatif; di dalam When, jendela waktu Weekly dan One-time merupakan alternatif. Where dapat mencakup semua pintu fasilitas, Access Scopes, pintu individual, dan pengecualian.

Contoh: kebijakan "Active members" dapat mencakup cakupan Front entrances kapan saja (Anytime), sementara kebijakan "Staff" yang terpisah mencakup semua pintu fasilitas kecuali Plant room. Petugas kebersihan yang tidak cocok dengan keduanya tetap dapat menerima pemberian akses permanen ke cakupan Service entries.

Pemberian akses permanen dan jendela waktu administrator/integrasi tetap terpisah dan bersifat menambah. Pengeditan kebijakan dan impor otomatis tidak menyerap atau menghapusnya.

Staf Performance Hub yang disinkronkan ke Users mendapatkan akses pintu melalui kebijakan Performance Hub staff yang dapat diedit, sama seperti kebijakan lainnya. Lihat Sinkronisasi & Integrasi.

Urutan keputusan lengkap

Saat pengguna mengetuk Unlock di aplikasi seluler, server memeriksa hal-hal berikut secara berurutan. Pemeriksaan pertama yang gagal akan menolak pembukaan kunci dan mencatat alasannya di Access Logs.

Apakah akses pengguna diaktifkan? Sakelar Access enabled pada baris pengguna di Users adalah sakelar pemutus milik admin. Pengguna yang dihapus, dinonaktifkan, atau diblokir oleh sinkronisasi tidak dapat membuka kunci, terlepas dari kebijakan atau pemberian akses. (Contoh: access_disabled.)
Apakah pintu diblokir atau dalam pemeliharaan? blockAllAccess yang eksplisit menolak setiap jalur anggota. Mode pemeliharaan Force closed menjaga pintu tetap terkunci dan tidak beroperasi bagi anggota; Force open menjaga pintu tetap tidak terkunci. Admin dapat membuka kunci pintu dari jarak jauh; setiap pembukaan kunci oleh admin dicatat di Access Logs.
Apakah ada jalur izin tambahan yang lolos?
- Jalur kebijakan: kebijakan bernama yang aktif mana pun yang Who, Where, dan When-nya semuanya cocok akan mengizinkan akses.
- Jalur pemberian akses permanen: pemberian akses untuk fasilitas, pintu, atau Access Scope yang memuat pintu tersebut mengizinkan akses jika jam opsionalnya cocok.
- Jalur jendela waktu pengguna: Access Time Window milik administrator sedang aktif dan menargetkan pintu ini, fasilitas, atau Access Scope yang memuatnya.
- Jalur jendela waktu integrasi: jendela waktu sumber yang terbaru sedang aktif dan pemetaan scope_key yang dikonfigurasi menargetkan pintu ini. Jendela waktu sumber yang usang atau tidak dipetakan tidak memberikan akses.
- Jika tidak ada yang lolos → ditolak (no_matching_policy_or_grant)
Pemeriksaan geofence (jika diaktifkan). Menggunakan lokasi yang dilaporkan ponsel:
- Jika ponsel tidak dapat memberikan lokasi → ditolak (location_unavailable)
- Jika pembacaan GPS kurang akurat dibandingkan pengaturan Require GPS accuracy better than → ditolak (gps_too_imprecise)
- Jika jarak pengguna dari titik pusat geofence melebihi radius + akurasi GPS + buffer akurasi → ditolak (outside_geofence)
- Server yang menentukan — lokasi palsu di ponsel tetap ditolak di sisi server.
Apakah pengontrol pintu daring? Jika pengontrol belum melapor (heartbeat dalam 5 menit terakhir), perintah buka kunci tidak dapat dikirimkan (device_offline). Jika perintah terkirim tetapi pengontrol tidak mengonfirmasi, peristiwa dicatat sebagai Timed out.
Buka kunci. Relai dilepaskan selama Hold time pintu (1–30 detik, default 10), lalu terkunci kembali secara otomatis. Peristiwa dicatat sebagai Confirmed unlocked setelah pengontrol mengonfirmasi.

Jendela waktu One-time dan Weekly yang dibatasi menggunakan batas detik Unix berupa bilangan bulat dan batas setengah terbuka [from, to): waktu mulai termasuk, waktu akhir tidak. Blok Weekly menggunakan zona waktu IANA yang ditetapkan serta aturan jam lokal/DST. Lihat Jadwal Access Policy.

Klien baru menerima detail outside_access_time_window beserta informasi ketersediaan berikutnya yang terstruktur untuk pintu yang hanya memiliki jendela waktu mendatang. Selama masa peluncuran kompatibilitas, klien lama tetap menerima outside_access_hours sebagai alasan utama sehingga pintu tetap dinonaktifkan dengan aman dan tetap terlihat.

Konfigurasi yang sudah ada

Konfigurasi akses yang sudah ada diimpor ke Access Policies secara otomatis. Impor ini mempertahankan siapa yang memiliki akses, pintu atau Access Scopes yang dapat mereka gunakan, dan jam yang berlaku sebagai nilai Who, Where, dan When pada kebijakan. Administrator mengelola kebijakan yang dihasilkan secara langsung; tidak ada mode peluncuran atau alur kerja konversi manual.

Pewarisan geofence tetap independen dari Access Policies. Kecocokan kebijakan tetap melewati geofence yang berlaku dan semua pemeriksaan keselamatan/perangkat lainnya.

Masuk ke aplikasi seluler (kode sekali pakai melalui SMS atau email) hanya untuk autentikasi — membuktikan siapa pengguna tersebut. Masuk tidak memberikan akses pintu dengan sendirinya. Setiap pembukaan kunci diotorisasi satu per satu menggunakan urutan keputusan di atas. Pengguna dapat sudah masuk ke aplikasi tetapi tetap melihat "You don't have access to this door."

Glosarium

Istilah	Definisi
Pengontrol pintu	Perangkat keras yang dipasangkan ke pintu/gerbang yang menggerakkan relai kunci. Muncul sebagai "pintu" di modul ini dan sebagai perangkat di Manajemen Perangkat.
Pintu	Pengontrol pintu yang terdaftar di fasilitas Anda, dengan nama, label lokasi, ikon, dan pengaturan.
Baris pengguna	Catatan seseorang di fasilitas ini pada tab Users. Dibuat secara manual, melalui impor CSV, atau melalui sinkronisasi. Menyimpan pengenal kontak, jenis/status/tag, pemberian akses, dan status aplikasi.
Sumber	Asal baris pengguna: Manually added, External Integration, CCTV/Computer Vision, atau Performance Hub staff.
Access Policy	Kebijakan bernama yang hanya bersifat mengizinkan, berisi Who, Where, dan When. Ketiganya harus cocok; kebijakan-kebijakan digabungkan dengan ATAU.
Kondisi jenis orang	Kondisi Who pada kebijakan yang berisi jenis orang dan status keanggotaan opsional. Status kosong berarti status apa pun.
Tag	Label pada pengguna. Tag yang disinkronkan berasal dari integrasi dan ditimpa pada setiap sinkronisasi; tag kustom dimiliki admin dan tidak pernah ditimpa. Keduanya dapat memenuhi kondisi Who pada kebijakan.
Jam operasional / blok waktu	Jendela waktu per hari dalam seminggu (misalnya Sen 06:00–22:00) yang membatasi kapan kebijakan atau pemberian akses mengizinkan akses. Kosong = selalu diizinkan. Waktu menggunakan zona waktu fasilitas.
Access Time Window	Periode Weekly atau One-time yang digunakan dalam jadwal kebijakan atau dalam jalur pemberian akses administrator/integrasi yang terpisah.
Pemberian akses per pengguna	Akses eksplisit yang diberikan kepada satu pengguna: Seluruh fasilitas (setiap pintu), pintu tertentu, atau Access Scopes tertentu — secara opsional dengan jam operasionalnya sendiri.
Ruang Lingkup Akses	Kumpulan pintu bernama (misalnya "Main entrances", "Staff-only") yang digunakan sebagai target kebijakan atau pemberian akses dan untuk pengaturan geofence di tingkat cakupan. Secara internal juga disebut grup pintu.
Pengecualian kebijakan	Pintu atau Access Scope yang dihapus dari kecocokan Where pada satu kebijakan. Pengecualian tidak menolak kebijakan atau jalur pemberian akses lain.
Geofence	Lingkaran di sekitar fasilitas (titik pusat + radius). Saat diaktifkan, pengguna harus secara fisik berada di dalamnya (dengan memperhitungkan akurasi GPS dan buffer) untuk membuka kunci.
Buffer akurasi	Meter tambahan yang ditambahkan ke radius geofence untuk mengakomodasi gangguan GPS yang normal. Default 25 m.
Mode pemeliharaan	Pengaturan per pintu yang mengeluarkan pintu dari operasi normal: Normal, Force open (tetap tidak terkunci), atau Force closed (tetap terkunci dan tidak beroperasi bagi anggota).
Block all access	Blokir keselamatan per pintu yang mengesampingkan kebijakan dan pemberian akses per pengguna di pintu tersebut, tanpa menggunakan mode pemeliharaan. Pembukaan kunci oleh admin tetap tersedia.
Hold time	Lamanya relai tetap dilepaskan setelah pembukaan kunci sebelum terkunci kembali. Rentang 1–30 detik, default 10.
Jadwal buka kunci otomatis	Jadwal per pintu yang menahan pintu tetap tidak terkunci selama jam kehadiran staf fasilitas atau jadwal kustom. Independen dari Access Policies.
Lock now	Mengunci pintu yang sedang ditahan terbuka oleh jadwal buka kunci otomatis, hingga perubahan jadwal berikutnya. Resume schedule membatalkannya.
Access enabled	Sakelar pemutus per pengguna. Nonaktif = pengguna tidak dapat membuka kunci apa pun.
Decoupled	Pengguna yang disinkronkan dengan sakelar Track source updates dinonaktifkan. Proses sinkronisasi melewati baris tersebut, sehingga pengeditan admin tetap dipertahankan.
Undangan	Email yang dikirim kepada pengguna berisi tautan untuk mengunduh aplikasi seluler. Dilacak per pengguna (Not invited / Invited / Send failed).
Masuk dengan OTP	Login tanpa kata sandi di aplikasi seluler: kode sekali pakai yang dikirim ke ponsel atau email pengguna.
Admin override / Admin unlock	Pembukaan kunci yang dipicu dari Performance Hub oleh admin (tab Doors → Open, atau Unlock door di panel pintu). Setiap pembukaan kunci oleh admin dicatat di Access Logs atas nama akun admin tersebut.
Kunci aplikasi	Autentikasi ulang perangkat yang diwajibkan fasilitas (Face ID / Touch ID / biometrik Android / kode sandi) sebelum aplikasi dapat digunakan.
Pesan aplikasi	Kartu pengumuman di dasbor aplikasi — untuk seluruh fasilitas, per pengguna, atau diatur secara otomatis oleh aturan App Messaging.
Peristiwa akses	Satu catatan di Access Logs: upaya pembukaan kunci dan hasilnya.

Access Policies — Who, Where, When, dan impor otomatis
Jadwal Access Policy — Anytime, Weekly, dan One-time
Access Scopes — kumpulan pintu yang dapat digunakan ulang
Geofencing — pemeriksaan lokasi
Users — pemberian akses per pengguna dan sakelar pemutus
Referensi — setiap alasan penolakan dan nilai default dalam satu tabel
Pintu juga dapat disertakan dalam respons Duress. Lihat Tindakan respons di Duress.