View source for Mikrotik : Hotspot Lanjutan (User Profile dan Voucher)

Hotspot dasar biasanya berhenti di "bisa login dan dapat internet". Begitu hotspot dipakai untuk acara sekolah atau dijual per kode, pertanyaannya berubah: bagaimana membatasi waktu, kecepatan, dan jumlah perangkat untuk tiap orang? Di titik itu ''user profile'' dan voucher mulai bekerja.

== 🎯 Tujuan ==
Setelah membaca dan mempraktikkan artikel ini, kamu bisa:

* Membedakan '''server profile''', '''user profile''', dan '''user''' hotspot tanpa tertukar.
* Merancang paket voucher (1 jam, 1 hari, guru) memakai <code>rate-limit</code>, <code>session-timeout</code>, <code>limit-uptime</code>, dan <code>shared-users</code>.
* Membuat banyak voucher sekaligus dengan script, lalu mencetaknya ke file untuk dibagikan atau dijual.
* Membuktikan bahwa satu kode hanya bisa dipakai satu perangkat dan benar-benar mati saat waktunya habis.

== 📍 Konteks nyata ==
Bayangkan hotspot dasar sebagai pintu kelas dengan satu kunci. Semua siswa memegang salinan kunci yang sama, jadi tidak ada yang tahu siapa masuk dan kapan harus pulang.

''User profile'' itu '''jenis tiketnya''' (reguler, VIP, guru), sedangkan voucher itu '''karcis bernomor''' yang hanya berlaku untuk satu orang dan satu durasi. Karcis boleh dicetak banyak, tapi nomornya tidak boleh kembar.

🔥 '''Kasus nyata:''' Sebuah SMK mengadakan workshop tiga hari untuk 80 tamu. Panitia membuat satu akun bersama <code>tamu</code> / <code>smk2026</code> dengan <code>shared-users=80</code> supaya semua bisa masuk.

Hari kedua kode itu sudah beredar di grup WhatsApp alumni. Tiga hari setelah acara, masih ada 20 perangkat online, kuota modem habis, dan panitia tidak bisa menunjuk siapa pemakainya karena semua orang memakai nama yang sama.

Perbaikannya bukan menambah bandwidth, tapi mengganti model: satu orang satu voucher, <code>shared-users=1</code>, plus batas waktu yang tidak bisa diakali dengan logout-login.

== 🧠 Konsep singkat ==
Hotspot punya tiga lapis pengaturan. Banyak siswa gagal karena menaruh pengaturan di lapis yang salah, lalu menyimpulkan "MikroTik-nya rusak".

{| class="wikitable"
! Lapis !! Menu !! Mengatur apa !! Analogi
|-
| Server profile || <code>/ip hotspot profile</code> || Cara login, halaman login, DNS name, sertifikat, RADIUS || Jenis gedung dan pintu masuknya
|-
| User profile || <code>/ip hotspot user profile</code> || Kecepatan, batas sesi, jumlah perangkat, address list, script login || Jenis tiket dan fasilitasnya
|-
| User || <code>/ip hotspot user</code> || Nama, password, paket yang dipakai, sisa waktu, sisa kuota || Nama pemegang karcis
|}

Urutan berpikirnya selalu: '''buat jenis tiket dulu, baru cetak karcisnya'''. Kalau kamu membuat user sebelum profile-nya ada, kode itu akan menempel ke profile <code>default</code> dan semua batas yang kamu rencanakan hilang.

=== 🔹 Tiga lapis yang sering tertukar ===
<code>/ip hotspot profile</code> mengatur '''bagaimana orang login'''. Di sini ada <code>login-by</code> (default <code>http-chap,cookie</code>), <code>dns-name</code>, <code>html-directory</code>, dan <code>ssl-certificate</code>. Ini bukan tempat mengatur kecepatan.

<code>/ip hotspot user profile</code> mengatur '''apa yang didapat setelah login'''. Di sini ada <code>rate-limit</code>, <code>session-timeout</code>, <code>shared-users</code>, <code>idle-timeout</code>, dan <code>address-list</code>.

<code>/ip hotspot user</code> mengatur '''identitas dan jatah pribadi'''. Di sini ada <code>name</code>, <code>password</code>, <code>profile</code>, <code>limit-uptime</code>, serta <code>limit-bytes-in</code>/<code>out</code>/<code>total</code>.

Kalau kamu mencari "batas kuota" di menu profile, kamu tidak akan menemukannya. Kuota byte memang properti per user, bukan per profile. Ini fakta yang paling sering bikin bingung.

=== 🔹 Batas waktu: session-timeout vs limit-uptime ===
Keduanya terlihat sama, padahal berbeda cara hitung.

* <code>session-timeout</code> ada di user profile dan membatasi '''satu sesi login'''. Habis waktunya, user diputus. Kalau user login lagi, timer mulai dari nol.
* <code>limit-uptime</code> ada di user dan menghitung '''akumulasi pemakaian''' milik kode itu. Habis, kode tidak bisa dipakai lagi walau user logout berkali-kali.

Untuk voucher yang dijual, pakai <code>limit-uptime</code> sebagai pengaman utama, dan <code>session-timeout</code> sebagai pengaman tambahan supaya satu sesi tidak menggantung berhari-hari.

📊 '''Angka penting:''' <code>shared-users</code> default '''1''' (satu kode satu sesi), <code>session-timeout</code> default '''0s''' (tanpa batas), <code>http-cookie-lifetime</code> default '''3d''', <code>mac-cookie-timeout</code> default '''3d''', dan <code>addresses-per-mac</code> default '''2''' alamat IP per MAC.

== 🧩 Istilah penting ==
{| class="wikitable"
! Istilah !! Arti singkat
|-
| Voucher || Kode sekali pakai berisi username dan password, biasanya dicetak di kertas kecil.
|-
| <code>rate-limit</code> || Batas kecepatan dalam format <code>rx/tx</code>. Dibaca dari sudut router: '''rx = upload client''', '''tx = download client'''.
|-
| <code>shared-users</code> || Berapa sesi yang boleh memakai satu username pada saat bersamaan.
|-
| <code>session-timeout</code> || Batas umur satu sesi login, dihitung ulang setiap kali login.
|-
| <code>limit-uptime</code> || Batas total waktu pemakaian sebuah akun, tidak direset oleh logout.
|-
| <code>limit-bytes-total</code> || Batas total byte (unggah + unduh) untuk satu akun.
|-
| <code>address-list</code> || Daftar alamat yang otomatis diisi IP user saat login, berguna untuk Queue Tree per paket.
|-
| MAC cookie || Fitur login otomatis berdasarkan MAC address, nyaman untuk HP tapi bisa membuat voucher terasa "bocor".
|-
| Walled garden || Daftar situs yang boleh dibuka '''tanpa''' login, misalnya halaman pembayaran atau situs sekolah.
|-
| User Manager || Paket RADIUS bawaan RouterOS untuk mengelola voucher dalam jumlah besar dan banyak router.
|}

== 🔧 Praktik: Menyiapkan Paket Voucher ==
Praktik ini memakai satu router lab dengan hotspot dasar yang sudah jalan (lihat materi terkait). Alamat contoh memakai rentang dokumentasi RFC 5737: gateway hotspot <code>192.0.2.1/24</code>.

⚠️ '''Hati-hati:''' Hotspot bisa diblokir oleh <code>device-mode</code>, dan hanya berjalan baik di IPv4. Cek <code>/system/device-mode print</code> sebelum menyalahkan konfigurasi.

=== 🔹 Langkah 1: Cek pondasi hotspot ===
Pastikan server hotspot, pool, dan DHCP sudah ada. Jangan membuat profile di atas hotspot yang belum pernah diuji login.

<syntaxhighlight lang="text">
/ip hotspot print
/ip hotspot profile print
/ip hotspot user profile print
/ip hotspot user print
</syntaxhighlight>

Yang perlu dilihat: kolom <code>PROFILE</code> di server hotspot menunjuk ke server profile yang benar, dan <code>login-by</code> masih default <code>http-chap,cookie</code>. Mode <code>http-chap</code> tidak mengirim password dalam teks biasa, jadi aman untuk lab sekolah.

=== 🔹 Langkah 2: Buat tiga user profile ===
Kita buat tiga "jenis tiket": 1 jam, 1 hari, dan guru. Semua memakai <code>shared-users=1</code> kecuali guru.

<syntaxhighlight lang="text">
/ip hotspot user profile
add name="vcr-1jam" shared-users=1 session-timeout=1h \
    rate-limit="1M/2M" address-list="hs-vcr-1jam" \
    comment="voucher 1 jam - workshop"

add name="vcr-1hari" shared-users=1 session-timeout=1d \
    rate-limit="2M/5M" address-list="hs-vcr-1hari" \
    comment="voucher 1 hari - tamu"

add name="guru" shared-users=2 session-timeout=0s \
    rate-limit="5M/20M" address-list="hs-guru" \
    comment="akun guru, tanpa batas waktu"
</syntaxhighlight>

Penjelasan singkat tiap parameter:

* <code>rate-limit="2M/5M"</code> artinya upload maksimal 2 Mbps dan download maksimal 5 Mbps untuk pemakai paket itu.
* <code>session-timeout=1d</code> memutus sesi setelah 24 jam, walaupun perangkatnya masih menyala.
* <code>address-list="hs-vcr-1hari"</code> membuat IP user otomatis masuk daftar saat login, sehingga Queue Tree bisa menargetkan per paket tanpa mangle tambahan.
* <code>comment</code> dipakai agar kamu bisa menghapus semua voucher satu acara dengan satu perintah <code>find</code>.

⚠️ '''Hati-hati:''' Urutan <code>rate-limit</code> mudah terbalik. <code>2M/5M</code> berarti download 5M, bukan upload 5M. Kalau tertukar, siswa mengeluh "download lambat" padahal kamu memberi 5M untuk upload dan 2M untuk download.

=== 🔹 Langkah 3: Buat voucher otomatis dengan script ===
Membuat 20 voucher satu per satu lewat Winbox itu menyiksa. Pakai script supaya kode dibuat acak, dicek duplikatnya, lalu disimpan sebagai user hotspot.

<syntaxhighlight lang="text">
:local jumlah 20
:local prefix "vcr-"
:local dibuat 0

:while ($dibuat < $jumlah) do={
  :local kode [:tostr [:rndnum from=100000 to=999999]]
  :local nama ($prefix . $kode)
  :if ([/ip hotspot user print count-only where name=$nama] = 0) do={
    /ip hotspot user add name=$nama password=$kode \
        profile="vcr-1hari" limit-uptime=1d \
        comment="voucher workshop okt 2026"
    :set dibuat ($dibuat + 1)
  }
}
:log info ("voucher dibuat: " . $dibuat)
</syntaxhighlight>

Cara kerjanya: <code>:rndnum</code> menghasilkan angka acak, lalu <code>print count-only where name=$nama</code> memastikan kode itu belum ada. Kalau sudah ada, loop mengulang tanpa menambah hitungan, jadi jumlah akhir selalu tepat 20.

📊 '''Angka penting:''' kode 6 digit numerik hanya punya '''900.000''' kombinasi dan mudah ditebak script orang lain. Untuk voucher yang dijual ke publik, pakai 8 karakter campuran huruf dan angka, plus <code>shared-users=1</code> dan pembatasan percobaan login.

💡 '''Tips:''' jalankan script yang sama dua kali dengan <code>comment</code> berbeda untuk acara berbeda. Saat acara selesai, hapus sekaligus dengan <code>/ip hotspot user remove [find comment~"workshop okt 2026"]</code>.

=== 🔹 Langkah 4: Cetak voucher ke file ===
Setelah semua kode dibuat, ekspor daftarnya ke file teks supaya bisa dicetak dan digunting.

<syntaxhighlight lang="text">
/ip hotspot user print where profile="vcr-1hari" file="voucher-1hari"
/file print
</syntaxhighlight>

File akan muncul di menu Files dengan nama <code>voucher-1hari.txt</code>. Unduh lewat Winbox (menu Files, tombol Download) atau FTP, lalu cetak. Kolom password ikut tercetak, jadi perlakukan file ini seperti daftar uang tunai.

💡 '''Tips:''' cetak dua rangkap: satu digunting untuk dijual, satu disimpan panitia untuk mencocokkan kalau ada kode yang tidak bisa login.

=== 🔹 Langkah 5: Uji satu voucher ===
Ambil satu kode dari file, login dari HP, lalu periksa dari router.

<syntaxhighlight lang="text">
/ip hotspot active print
/ip hotspot active print detail where user~"vcr-"
/ip hotspot user print detail where name="vcr-123456"
</syntaxhighlight>

Di <code>active</code> kamu akan melihat <code>session-time-left</code>, yaitu sisa waktu sesi berjalan. Di <code>user</code> kamu bisa membaca <code>uptime</code>, <code>bytes-in</code>, dan <code>bytes-out</code> untuk memastikan trafik benar-benar tercatat.

🧪 '''Uji cepat:''' login kode yang sama dari perangkat kedua. Dengan <code>shared-users=1</code>, sesi kedua tidak boleh berjalan bersamaan. Cek <code>/ip hotspot active print count-only where user="vcr-123456"</code> — hasilnya harus '''1'''.

=== 🔹 Langkah 6: Uji batas paket ===
Jangan percaya batas yang belum diuji. Tiga uji ini cukup untuk membuktikan paket bekerja.

# '''Uji kecepatan:''' pakai <code>/tool speed-test</code> atau unduh file besar dari perangkat yang login dengan voucher 1 jam. Hasilnya harus mendekati 2 Mbps upload dan 5 Mbps download.
# '''Uji waktu:''' buat profile uji <code>vcr-uji</code> dengan <code>session-timeout=2m</code>, login, lalu tunggu. User harus terlempar dari <code>active</code> setelah ±2 menit.
# '''Uji kuota:''' buat user uji dengan <code>limit-bytes-total=20M</code>, lalu unduh file 50 MB. Setelah 20 MB terpakai, sesi harus berhenti walaupun waktunya masih sisa.

Setelah selesai, bersihkan: hapus profile <code>vcr-uji</code> dan user uji, lalu pastikan tidak ada sesi menggantung di <code>active</code>.

=== 🔹 Versi Winbox ===
* Menu '''IP → Hotspot → User Profiles''' untuk membuat paket. Isi <code>Rate Limit</code>, <code>Shared Users</code>, dan <code>Session Timeout</code>.
* Menu '''IP → Hotspot → Users''' untuk melihat kode, paket, dan sisa pemakaian.
* Menu '''IP → Hotspot → Active''' untuk memantau siapa yang sedang online. Tombol Remove di sini memutus sesi, bukan menghapus akun.
* Menu '''Files''' untuk mengunduh hasil <code>print file=</code>.

=== 🔹 Kalau acaranya besar: User Manager ===
Untuk satu router sekolah, cara di atas sudah cukup. Kalau kamu mengelola beberapa router atau butuh voucher dengan masa aktif yang dihitung rapi, RouterOS menyediakan paket '''User Manager''' sebagai server RADIUS lokal.

Fakta pentingnya: User Manager adalah paket terpisah, <code>enabled=no</code> secara default, memakai port <code>1812</code> (authentication) dan <code>1813</code> (accounting), serta jumlah sesi aktifnya dibatasi lisensi RouterOS.

<syntaxhighlight lang="text">
/user-manager user
add-batch-users number-of-users=20 username-length=6 \
    username-characters=lowercase password-length=6 \
    password-characters=lowercase,uppercase,numbers
</syntaxhighlight>

Setelah user dibuat, voucher dicetak dengan template bawaan:

<syntaxhighlight lang="text">
/user-manager user
generate-voucher voucher-template=printable_vouchers.html [find]
</syntaxhighlight>

Hasilnya bisa dibuka lewat browser di <code>/um/PRIVATE/GENERATED/vouchers/gen_printable_vouchers.html</code>. Folder <code>PRIVATE</code> hanya bisa diakses setelah <code>web-private-username</code> dan <code>web-private-password</code> diisi.

Template voucher mendukung variabel <code>$(username)</code>, <code>$(password)</code>, <code>$(userprofname)</code>, dan <code>$(userprofendtime)</code>. Untuk daftar massal, gunakan template <code>export.csv</code> atau <code>export.xml</code>.

== 🏭 Dipakai di dunia kerja ==
* '''Sekolah:*** workshop, pelatihan guru, atau ujian berbasis komputer dengan tamu. Voucher per orang membuat panitia tahu siapa masih online saat acara selesai, dan bandwidth tidak dipakai perangkat yang lupa logout.
* '''Warnet dan kios Wi-Fi:*** paket 1 jam, 3 jam, dan 1 hari dijual terpisah. <code>limit-uptime</code> melindungi pemilik dari kode yang dipakai bergiliran seharian.
* '''Kafe dan hotel:*** voucher per meja atau per kamar dengan masa aktif 1 hari. Resepsionis cukup menyerahkan kertas, tanpa membuat akun baru setiap tamu datang.
* '''Event organizer:*** 200 peserta, satu SSID, dan tiga profil berbeda untuk peserta, panitia, dan pembicara. Pembicara butuh jaminan kecepatan, peserta cukup untuk media sosial.
* '''ISP RT/RW net:*** paket bulanan dengan masa aktif dan kuota. Di sinilah User Manager lebih masuk akal karena pelanggan perlu diperpanjang otomatis.
* '''Kantor:*** akun tamu untuk vendor dengan masa aktif pendek, terpisah dari SSID karyawan yang memakai VLAN dan firewall sendiri.

== ✅ Verifikasi ==
Jalankan berurutan dan cocokkan hasilnya. Kalau satu langkah gagal, jangan lanjut mencetak voucher.

# <code>/ip hotspot user profile print detail</code> — ketiga profile ada, <code>shared-users=1</code>, dan <code>rate-limit</code> tidak kosong.
# <code>/ip hotspot user print count-only where profile="vcr-1hari"</code> — jumlahnya sama dengan <code>jumlah</code> di script (20).
# <code>/ip hotspot user print where profile="vcr-1hari"</code> — tidak ada nama kode yang kembar.
# <code>/ip hotspot active print</code> — hanya perangkat uji yang muncul, dengan <code>session-time-left</code> berjalan mundur.
# <code>/ip hotspot active print count-only where user="vcr-123456"</code> — hasil '''1''' setelah login dari dua perangkat.
# <code>/ip hotspot cookie print</code> — cookie lama ikut terhapus saat akun dihapus, jadi tidak ada login otomatis yang tertinggal.

🧪 '''Uji cepat:''' hapus satu user uji, lalu coba login dengan kode itu. Harus gagal. Kalau masih bisa masuk, kemungkinan besar perangkat memakai MAC cookie dari sesi sebelumnya.

== ⚠️ Kesalahan umum & troubleshooting ==
{| class="wikitable"
! Gejala !! Penyebab !! Perbaikan
|-
| Kode benar tapi login ditolak || Profile yang dirujuk user tidak ada, atau user menempel ke profile <code>default</code> || Cek <code>/ip hotspot user print detail</code>, lalu <code>set [find name="..."] profile="vcr-1hari"</code>
|-
| Login berhasil, internet tidak jalan || Rule NAT atau DNS hotspot belum ada, atau <code>walled-garden</code> salah || Cek <code>/ip firewall nat print</code> dan <code>/ip dns print</code>, uji ping gateway
|-
| Satu kode dipakai banyak perangkat || <code>shared-users</code> lebih dari 1 di profile || Set <code>shared-users=1</code> di user profile
|-
| Kuota tidak berhenti walau habis || Batas byte dipasang di profile, padahal properti itu milik user || Pasang <code>limit-bytes-total</code> di <code>/ip hotspot user</code>
|-
| Kode mati lalu hidup lagi setelah logout || Hanya memakai <code>session-timeout</code> || Tambahkan <code>limit-uptime</code> di user sebagai batas akumulasi
|-
| Voucher dobel || Script dijalankan dua kali tanpa cek duplikat || Pertahankan <code>print count-only where name=$nama</code> sebelum <code>add</code>
|-
| File voucher tidak muncul || Nama file bentrok atau folder penyimpanan penuh || Cek <code>/file print</code>, hapus file lama, ulangi <code>print file=</code>
|-
| Semua sesi berhenti di jam yang sama || Jam router salah setelah listrik padam || Aktifkan NTP <code>/system ntp client</code>, lalu cek <code>/system clock print</code>
|-
| HP langsung login tanpa diminta kode || MAC cookie aktif dari login sebelumnya || Hapus di <code>/ip hotspot cookie print</code> dan <code>/ip hotspot client print</code>
|-
| Halaman login error di HTTPS || <code>https-redirect=yes</code> tapi sertifikat tidak cocok dengan <code>dns-name</code> || Set <code>https-redirect=no</code> atau pasang sertifikat yang sesuai
|-
| Hotspot tidak jalan sama sekali || <code>device-mode</code> memblokir, atau ada tabel routing tambahan || Cek device-mode; hotspot hanya memakai tabel routing default sehingga PCC tidak cocok
|}

== 🔐 Catatan keamanan & etika ==
* '''Voucher adalah kredensial.*** File <code>.txt</code> hasil cetak berisi semua password. Simpan di folder terkunci, jangan pernah ditaruh di folder publik atau dikirim ke grup chat.
* '''Satu kode satu orang.*** <code>shared-users=1</code> bukan sekadar rapi, tapi membatasi penyebaran kode dan memudahkan penelusuran saat ada penyalahgunaan.
* '''Hindari <code>http-pap</code>.*** Mode itu mengirim password dalam teks biasa. Pakai <code>http-chap</code> (default) atau <code>https</code> dengan sertifikat yang valid.
* '''Hapus akun kedaluwarsa.*** Akun lama yang dibiarkan hidup adalah pintu masuk gratis. Jadwalkan pembersihan berdasarkan <code>comment</code>.
* '''Pisahkan jaringan tamu.*** Hotspot tamu sebaiknya berada di VLAN atau bridge sendiri, dengan firewall yang melarang akses ke subnet guru dan server nilai.
* '''Etika memantau.*** Menu <code>active</code> dan <code>host</code> boleh dipakai untuk operasional, bukan untuk mengintip isi trafik pribadi pengguna.

== 📌 Kesimpulan ==
''User profile'' menentukan apa yang didapat pengguna, voucher menentukan siapa yang berhak memakainya. Kalau keduanya dipisah dengan benar, satu router bisa melayani beberapa paket sekaligus tanpa saling mengganggu.

Langkah berikutnya: kerjakan praktikum pendamping artikel ini untuk menguji batas paket dan kegagalan voucher satu per satu, lalu lanjut ke materi firewall RAW untuk melihat trafik sebelum connection tracking.

== 🔗 Materi terkait ==
* [[Mikrotik : Hotspot Dasar]] — pondasi captive portal, DHCP, dan NAT yang dipakai artikel ini.
* [[Mikrotik : DHCP Server untuk LAN]] — pool alamat yang membagi IP ke client hotspot.
* [[Mikrotik : Firewall Filter Dasar]] — melindungi router dan memisahkan trafik tamu.
* [[Mikrotik : Queue Sederhana untuk Bandwidth Management]] — dasar pembatasan kecepatan sebelum memakai <code>rate-limit</code> hotspot.
* [[Mikrotik : VLAN Dasar]] — memisahkan jaringan tamu dari jaringan internal.
* [[Mikrotik : Praktikum Membuat User dan Group di RouterOS]] — kebiasaan membuat akun dan group yang rapi.
* [[Mikrotik : Bandwidth Test dan Pengukuran Throughput]] — mengukur apakah <code>rate-limit</code> benar-benar bekerja.
* [[Mikrotik : Scripting Dasar RouterOS]] — dasar <code>:while</code>, <code>:if</code>, dan <code>:rndnum</code> yang dipakai script voucher.

== 📚 Referensi ==
* MikroTik Documentation — HotSpot Captive portal: https://help.mikrotik.com/docs/spaces/ROS/pages/56459266/HotSpot+-+Captive+portal
* MikroTik Documentation — User Manager: https://help.mikrotik.com/docs/spaces/ROS/pages/2555940/User+Manager
* MikroTik CLI Reference — /ip/hotspot/user: https://manual.mikrotik.com/docs/cli-reference/ip/hotspot/user/
* MikroTik Documentation — Device-mode: https://help.mikrotik.com/docs/spaces/ROS/pages/93749258/Device-mode
* IETF RFC 7710 — Captive-Portal Identification Using DHCP or RA: https://www.rfc-editor.org/rfc/rfc7710

[[Category:TKJ]]
[[Category:Jaringan]]
[[Category:Mikrotik]]