Sambungan ke Mikrotik

Billingvro mengatur Mikrotik lewat layanan API RouterOS yang berjalan di jalur VPN antara router dan Billingvro. Halaman ini berisi persiapan router, izin user yang dibutuhkan, solusi saat koneksi gagal, dan daftar lengkap bagian Mikrotik yang diatur Billingvro.

Persiapan

1. Versi RouterOS

Cek versi di Winbox: System → Resources → Version.

2. Layanan API

Layanan api (port 8728) cukup dalam keadaan aktif di IP → Services. Kamu tidak perlu mengisi Available From sendiri — saat router ditambahkan, Billingvro otomatis membatasi layanan API supaya hanya bisa dibuka dari jalur VPN Billingvro, bukan dari internet.

Pakai port 8728. Billingvro tidak memakai API-SSL (8729).

3. Buat user khusus

Jangan pakai admin bawaan. System → Users → +:

Kalau memakai group khusus, ini izin yang dibutuhkan tiap fitur:

Untuk semua fitur, isi group dengan:

api, read, write, policy, sensitive, test, ssh, ftp

Atur di Billingvro

Router pertama disambungkan di Wizard Penyiapan. Untuk router berikutnya, ikuti Sambungkan Mikrotik: buat peer di Router → tab VPN, tempel konfigurasinya, lalu Tambah Router.

Solusi saat koneksi gagal

"Router tidak dapat dijangkau" atau "Gagal menghubungi router"

Pesan lengkapnya diakhiri Pastikan VPN sudah terhubung dan router menyala. Cek:

• Konfigurasi peer sudah ditempel di Terminal tanpa baris merah. Kalau ragu, tempel ulang — aman diulang.
• Mikrotik punya koneksi internet.
• Jam router benar (System → Clock).
• Layanan api tidak dimatikan di IP → Services, dan port-nya 8728.
• Tidak ada aturan firewall buatan sendiri di urutan paling atas chain input yang menolak sambungan dari jalur VPN.

"Username atau password MikroTik tidak valid"

• Pastikan nama pengguna dan sandi persis sama dengan di System → Users.
• Group user punya izin api.
• Kalau kolom Allowed Address di user Mikrotik diisi, sambungan dari Billingvro bisa ditolak. Kosongkan saja — akses API sudah dibatasi ke jalur VPN oleh Billingvro.

Pesan dari Mikrotik berisi "not enough permissions"

User Mikrotik kurang izin untuk fitur yang sedang dipakai. Lengkapi group sesuai tabel izin, atau pakai group full.

Backup harian gagal

Cek tiga hal:

• Group user berisi policy, sensitive, test, ssh, ftp (atau full).
• Layanan ssh tidak dimatikan di IP → Services.
• Port ssh tidak diubah dari 22.

Koneksi sering putus

Di RouterOS 7, Billingvro memasang penjaga sambungan yang tiap 30 detik memeriksa jalur WireGuard dan memulihkannya sendiri, termasuk pindah ke jalur cadangan kalau jalur utama macet. Kalau tetap sering putus:

• Cek System → Logs di Mikrotik untuk pesan kesalahan.
• Pastikan koneksi internet Mikrotik sendiri stabil.
• Jangan hapus aturan, script, atau scheduler yang dipasang Billingvro (lihat daftar di bawah).

Banyak router dalam satu ruang kerja

Satu ruang kerja Billingvro bisa kelola lebih dari satu Mikrotik. Setiap router ditandai di daftar pelanggan/voucher, jadi mudah disaring.

Kapan butuh banyak router?

• Cabang fisik berbeda (RT 07 dan RT 08, masing-masing punya tower).
• Mikrotik utama + Mikrotik cadangan yang siap pakai.
• Pemisahan tugas: satu router khusus Hotspot, satu khusus PPPoE.

Apa yang Billingvro ubah di Mikrotik

Supaya transparan, ini daftar bagian Mikrotik yang dibaca dan diubah Billingvro, dikelompokkan per fitur. Hampir semuanya diberi nama atau keterangan yang memuat kata billingvro (mis. interface wg-billingvro), jadi mudah dikenali.

Saat router disambungkan

Dipasang oleh konfigurasi peer yang kamu tempel, lalu dilengkapi Billingvro saat router ditambahkan.

Khusus RouterOS 7 (WireGuard):

Pelanggan, voucher & paket

Isolir pelanggan menunggak

Hanya dipasang kalau kamu menyalakan mode isolir halaman tagihan di pengaturan.

Fitur lain (hanya kalau dipakai)

Billingvro tidak mengubah:

• Konfigurasi WAN, pengaturan DHCP server, bridge, dan wireless.
• User & group RouterOS.

Kamu tetap pegang kendali penuh atas semua bagian Mikrotik di luar daftar di atas.