Lewati ke konten utama

On-Property IP Whitelist

Setup Cepat

Batasi self-service check-in hanya ke IP tertentu. Cocok untuk membatasi check-in ke kiosk on-property saja.

Atur jaringan mana yang boleh menyelesaikan langkah check-in on-property, termasuk facial verification dan self-service check-in. IP Whitelist membantu mencegah tamu menyelesaikan check-in dari lokasi remote jika Anda hanya mengizinkan check-in berbasis kiosk.

Lokasi Pengaturan​

Settings → Check-In → IP Whitelist

Ringkasan Cepat​

PengaturanFungsinyaUse Case
IP WhitelistDaftar IP yang diizinkanBatasi check-in ke lokasi tertentu
Current IPIP Anda saat iniReferensi cepat saat menambah
CIDR BlocksRentang jaringanWhitelist banyak perangkat sekaligus

Dampak ke Tamu & Staf​

  • Tamu: Tamu dari jaringan lain tetap bisa upload dokumen pra-kedatangan, tetapi tidak dapat menyelesaikan check-in sampai tersambung ke jaringan yang di-whitelist atau memindai QR hotel.
  • Staf: Anda mengontrol kiosk dan jaringan staf mana yang dapat menyelesaikan check-in, mengurangi akses tidak sah.

Cara Kerja IP Whitelist​

Saat IP Whitelist aktif:

  • ✅ Diizinkan: Check-in dari IP yang di-whitelist
  • ❌ Diblokir: Percobaan check-in dari IP lain
Perilaku blokir

Tamu dari IP non-whitelist akan melihat error dan tidak bisa menyelesaikan self-service check-in.

Format yang Didukung​

Hanya alamat IPv4 dan CIDR range yang didukung. Nilai IPv4-mapped IPv6 diterima dan dinormalisasi.

FormatContohDeskripsi
IPv4 Address192.168.1.5Satu perangkat spesifik
CIDR Block10.0.0.0/24Satu subnet penuh (256 alamat)
CIDR /16 Block192.168.0.0/16Subnet besar (65.536 alamat)
IPv4-mapped IPv6::ffff:192.168.1.5Dinormalisasi menjadi IPv4
Hanya IPv4

Saat ini hanya IPv4 yang didukung. Dukungan IPv6 akan menyusul.

Use Case Umum​

Check-In Khusus Kiosk​

Skenario: Anda punya kiosk khusus di lobby dan tidak ingin tamu check-in dari kamar/rumah.

Setup:

  1. Cari IP kiosk (gunakan fitur Current IP)
  2. Tambahkan IP kiosk ke whitelist
  3. Aktifkan whitelist

✓ Kini hanya tamu di kiosk yang bisa check-in

Beberapa Lokasi​

Skenario: Anda punya kiosk di lobby, area parkir, dan business center.

Setup:

  1. Ambil IP dari setiap lokasi
  2. Tambahkan semua IP (atau gunakan CIDR jika satu jaringan)
  3. Uji dari tiap lokasi

Terminal Check-In Khusus Staf​

Skenario: Hanya terminal front desk yang boleh memproses check-in.

Setup:

  1. Ambil IP komputer front desk
  2. Tambahkan ke whitelist
  3. Latih staf memakai terminal yang ditetapkan

Jaringan Wi-Fi Hotel​

Skenario: Izinkan check-in dari mana saja selama tamu berada di Wi-Fi hotel.

Setup:

  1. Dapatkan rentang IP Wi-Fi (mis. 192.168.1.0/24)
  2. Tambahkan CIDR block ke whitelist
  3. Tamu di Wi-Fi hotel bisa check-in dari kamar

Setup IP Whitelist​

Langkah 1: Cari IP Anda​

  1. Buka Settings → Check-In → IP Whitelist

  2. Lihat bagian Current IP

  3. Catat IP yang ditampilkan

    ✓ Ini adalah IP yang sedang Anda gunakan untuk mengakses AVA saat ini

Fitur Current IP

Fitur "Current IP" menampilkan IP Anda saat ini, memudahkan penambahan IP yang sedang dipakai.

Langkah 2: Tambahkan IP atau CIDR​

Opsi A: Tambah IP individual

  1. Isi alamat IP pada field IP Whitelist
  2. (Opsional) Tambahkan label owner (mis. "Lobby Kiosk 1")
  3. Klik Add IP

Opsi B: Tambah CIDR block

  1. Isi CIDR range (mis. 192.168.1.0/24)
  2. (Opsional) Tambahkan label owner (mis. "Front Desk VLAN")
  3. Klik Add IP

Opsi C: Tambah current IP otomatis

  1. Klik Add my current IP
  2. Sistem mendeteksi dan menambahkan IP Anda otomatis
  3. Tambahkan label untuk referensi

Langkah 3: Aktifkan/Nonaktifkan Entri​

  • Toggle Active untuk menyalakan/mematikan enforcement per entri
  • Entri nonaktif tetap ada di daftar tapi tidak membatasi akses
  • Berguna untuk perubahan sementara tanpa menghapus entri

Langkah 4: Simpan Perubahan​

  1. Tinjau semua entri whitelist
  2. Klik Save whitelist untuk menerapkan
  3. Uji dari lokasi yang diizinkan dan lokasi yang seharusnya diblokir

Langkah 5: Uji Whitelist​

Dari lokasi whitelist:

  1. Buka check-in landing page
  2. Coba mulai check-in
  3. ✓ Harus berjalan normal

Dari lokasi non-whitelist:

  1. Gunakan perangkat/jaringan berbeda
  2. Coba akses check-in
  3. ✓ Harus diblokir dengan error

Mengelola Whitelist​

Menambah Entri​

Beberapa IP (dipisah koma):

192.168.1.10, 192.168.1.11, 192.168.1.12

IP individual + label:

  • IP: 192.168.1.100 → Label: "Reception Desk 1"
  • IP: 192.168.1.101 → Label: "Lobby Kiosk"
  • IP: 192.168.1.102 → Label: "Parking Kiosk"

CIDR block untuk jaringan:

  • 192.168.1.0/24 → Label: "Front Desk VLAN"
  • 10.0.0.0/16 → Label: "Hotel Wi-Fi Network"

Menghapus Entri​

  1. Cari entri yang ingin dihapus

  2. Klik tombol Remove

  3. Klik Save whitelist

    ✓ Akses langsung dicabut

Nonaktifkan Sementara​

Alih-alih menghapus:

  1. Toggle Active ke OFF
  2. Klik Save whitelist
  3. Entri tetap tersimpan tapi tidak membatasi akses

Cara Menemukan IP​

Untuk perangkat kiosk​

  1. Di perangkat kiosk, buka browser
  2. Cari "what is my ip"
  3. Catat public IP yang ditampilkan
  4. Tambahkan ke whitelist

Untuk komputer kantor​

Windows:

  1. Buka Command Prompt
  2. Ketik ipconfig
  3. Cari "IPv4 Address"

Mac:

  1. Buka System Preferences
  2. Masuk ke Network
  3. Catat IP yang ditampilkan

Untuk rentang jaringan (CIDR)​

Hubungi admin IT untuk mendapatkan:

  • Rentang jaringan (mis. 192.168.1.0/24)
  • Informasi subnet
  • Penetapan static IP

Konfigurasi Umum​

SkenarioIP yang di-whitelistContoh
Satu kiosk lobby1 IP192.168.1.100
Banyak kiosk (jaringan sama)1 CIDR block192.168.1.0/24
Kiosk + Front deskBeberapa IP/CIDR192.168.1.0/24, 10.0.5.0/24
Wi-Fi hotelCIDR block192.168.0.0/16
Remote pre-check-in diizinkanKosongkanTanpa whitelist (akses terbuka)

Menonaktifkan IP Whitelist​

Untuk mengizinkan check-in dari IP mana saja:

  1. Hapus semua IP dari daftar (atau nonaktifkan semua entri)
  2. Klik Save whitelist

✓ Self-service check-in sekarang bisa dari mana saja

Remote Check-In

Jika Anda ingin tamu bisa pre-check-in dari rumah, biarkan whitelist kosong atau nonaktif.

Praktik Terbaik​

Kapan sebaiknya menggunakan IP Whitelist​

✅ Gunakan jika:

  • Anda memiliki lokasi kiosk tetap
  • Anda ingin mencegah remote check-in
  • Kepatuhan mewajibkan check-in on-premise
  • Anda memiliki static IP atau rentang jaringan yang jelas

❌ Hindari jika:

  • Tamu perlu pre-check-in dari jarak jauh
  • IP sering berubah
  • Kiosk memakai hotspot mobile
  • Anda butuh fleksibilitas maksimal

Best practice keamanan​

  • Gunakan static IP untuk kiosk dan front desk
  • Whitelist jaringan Wi-Fi hotel dan kiosk sebelum enforcement diaktifkan
  • Tinjau daftar per kuartal untuk menghapus perangkat/subnet lama
  • Gunakan CIDR blocks untuk memudahkan kelola banyak perangkat
  • Beri label semua entri agar mudah dikenali
  • Lakukan pengujian menyeluruh sebelum aktifkan di produksi

Arsitektur jaringan yang disarankan​

  1. VLAN khusus kiosk
  2. Static IP untuk semua terminal check-in
  3. Jaringan terpisah untuk Wi-Fi tamu (jika check-in kamar diizinkan)
  4. Aturan firewall yang melengkapi IP whitelist

Troubleshooting​

Whitelist memblokir pengguna yang seharusnya valid​

Yang terlihat: Tamu di kiosk tidak bisa check-in.

Perbaikan:

  1. Cek Current IP dari kiosk
  2. Pastikan IP tersebut ada dalam whitelist
  3. Pastikan tidak ada typo
  4. Cek entri dalam posisi Active
  5. Klik Save whitelist lagi

IP berubah terus​

Yang terlihat: IP kiosk berubah harian/mingguan.

Penyebab:

  • DHCP dinamis
  • ISP merotasi public IP

Perbaikan:

  1. Hubungi tim IT
  2. Minta static IP untuk perangkat kiosk
  3. Perbarui whitelist dengan static IP
  4. Atau gunakan CIDR block untuk rentang DHCP

Tidak bisa menambahkan IP​

Yang terlihat: Tombol simpan abu-abu atau muncul error.

Periksa:

  • Format IP valid (xxx.xxx.xxx.xxx)
  • CIDR valid (xxx.xxx.xxx.xxx/xx)
  • Tidak ada spasi sebelum/sesudah IP
  • Gunakan titik (.) antar oktet
  • Bukan 0.0.0.0 atau 255.255.255.255

Current IP tidak muncul​

Yang terlihat: Field "Current IP" kosong.

Perbaikan:

  1. Refresh halaman
  2. Cek browser console untuk error
  3. Nonaktifkan VPN/proxy browser
  4. Coba browser lain

CIDR block tidak berfungsi​

Yang terlihat: Perangkat dalam rentang tetap diblokir.

Periksa:

  • Notasi CIDR benar (mis. /24 bukan /255.255.255.0)
  • Rentang mencakup perangkat yang diuji
  • Entri dalam posisi Active
  • Perubahan sudah disimpan

Kombinasi dengan Lapisan Keamanan Lain​

IP Whitelist berjalan bersama:

  • Device fingerprinting
  • Session timeout
  • User authentication
  • Facial verification (IP whitelist mengontrol lokasi verifikasi dapat dilakukan)
  • Document authenticity checks

Pengaturan Terkait​

Perlu Bantuan?​

Hubungi success@vouch-technologies.com jika:

  • ❌ Tidak bisa menemukan IP kiosk
  • ❌ IP tetap berubah meskipun sudah meminta static IP
  • ❌ Whitelist salah memblokir pengguna
  • ❌ Butuh bantuan setup CIDR block
  • ❌ Ada pertanyaan arsitektur jaringan

Informasi yang sebaiknya disertakan:

  • Daftar IP/CIDR yang sedang dicoba
  • Setup jaringan (WiFi, ethernet, mobile)
  • Screenshot error yang dilihat tamu
  • Diagram jaringan (jika ada)