06 - Mikrotik PHP API Pada System User

6-1

PENGENALAN MIKROTIK SYSTEM USER

Untuk dapat mengakses mikrotik dapat dilakukan melalui beberapa cara yaitu:

a) Console (lokal).

b) Web.

c) Telnet.

d) SSH (dengan bantuan program aplikasi Putty).

e) Winbox (program berbasis GUI untuk mengkonfigurasi Mikrotik).

Sebelum dapat melakukan konfigurasi, Anda harus melalui proses otentikasi login terlebih dahulu.

Default user dari mikrotik adalah:

User : admin

Password : kosong (blank)

Diperlukan konfigurasi pengalamatan IP pada salah satu interface dari Mikrotik, sebelum dapat

mengakses Mikrotik secara remote melalui antar muka web, telnet, SSH, atau winbox. User dapat

diotentikasi menggunakan user yang tersimpan di lokal atau di server RADIUS. Masing-masing user,

masuk sebagai anggota dari group, yang menentukan hak akses dari user tersebut. Terdapat 3 group

default bawaan dari Mikrotik yaitu:

a) Read

b) Write

c) Full

PERINTAH-PERINTAH MIKROTIK CLI DAN MIKROTIK PHP API UNTUK MANAJEMEN USER

1. Perintah Mikrotik CLI untuk menampilkan keseluruhan user adalah:

user print

6-2

Digunakan untuk menampilkan informasi seluruh user yg ada dimikrotik

Perintah Mikrotik PHP API untuk menampilkan user tertentu adalah:

/user/print

Digunakan untuk menampilkan informasi user src spesifik/tertentu, sehingga dicadangkan

perintah: /getall untuk menggantikan perintah print pada CLI /user/getall.

2. Perintah Mikrotik CLI untuk menambahkan user adalah:

user add name=lombok group=full comment=LombokAja

address=192.168.88.101 password=123456

Perintah Mikrotik PHP API untuk menambahkan user adalah:

/user/add

=name=lombok

=group=full

=comment=LombokAja

=address=192.168.88.101

=password=123456

3. Perintah Mikrotik CLI untuk menghapus user adalah:

user remove ? numbers yang akan dihapus

Perintah Mikrotik PHP API mencadangkan atribut yang digunakan untuk mengacu ke number/ID

dari record-recordnya di Mikrotik menggunak argumen .id, sehingga perintah untuk

melakukan penghapusan user adalah:

/user/remove

=.id=*6C dicontohkan menghapus yang idnya *6C

4. Perintah Mikrotik CLI untuk mengaktifkan user adalah:

user enable ?

Perintah Mikrotik API untuk mengaktifkan user adalah:

/user/enable

=.id=*6C dicontohkan menghapus yang idnya *6C

5. Perintah Mikrotik CLI untuk menonaktifkan user adalah:

6-3

user disable ?

Perintah Mikrotik PHP API untuk menonaktifkan user adalah:

/user/disable

=.id=*6C

6. Perintah Mikrotik CLI untuk mengubah user adalah:

user edit ?

value-name: name nama kolom yg akan diubah diikuti oleh argumen nama kolom yang

diubah.

Perintah Mikrotik PHP API untuk mengubah user adalah:

/user/set

=.id=*6C

=name=rony

=comment=ronyaja

=group=xxx

7. Perintah mikrotik PHP API untuk mengambil record tertentu adalah:

/user/print

=.proplist=name

=.proplist=address

=.proplist=group

=.proplist=comment

=.proplist=disabled

?.id=*9

STUDI KASUS APLIKASI MANAJEMEN USER MIKROTIK

Aplikasi manajemen user mikrotik ini terdiri dari 8 file kode program PHP antara lain:

1. File "routeros_api.class.php" yang memuat kode program Mikrotik PHP API.

2. Kode program pada file "config.php" untuk membuat koneksi ke router mikrotik adalah sebagai

berikut:

6-4

// menyisipkan file class mikrotik php api

include("routeros_api.class.php");

// membuat instance atau object dari class

$API = new routeros_api();

// mendeklarasikan variable untuk koneksi ke mikrotik

$mikrotik_hostname = "192.168.137.2";

$mikrotik_username = "admin";

$mikrotik_password = "";

// membuat & mengecek koneksi ke router mikrotik

if (!$API->connect($mikrotik_hostname, $mikrotik_username,

$mikrotik_password))

{

die("Koneksi ke Mikrotik Gagal dilakukan!");

}

?>

3. Kode program pada file "index.php" untuk menampilkan data sistem user yang terdapat di

router mikrotik adalah sebagai berikut:

Tampilan kode program ini ketika dieksekusi terlihat seperti pada gambar berikut:

6-5

4. Kode program pada file "add_user.php" untuk menambahkan data sistem user baru adalah

sebagai berikut:

Mikrotik RouterOS - Add New User

6-6

$error[] = 'The passwords you entered do not

match. Please try again!';

}

if (empty($_POST['rbstatus']))

{

$error[] = 'Status is required!';

}

if (count($error) > 0)

{

echo "";

foreach ($error as $data)

{

echo "$data";

}

echo "";

}

else

{

echo "Name : ".

$_POST['txtname'] ."";

echo "Group : ".

$_POST['lstgroup'] ."";

echo "Allowed Address : ".

$_POST['txtallowed_address'] ."";

echo "Comment : ".

$_POST['txtcomment'] ."";

echo "Password : ".

$_POST['txtpassword'] ."";

echo "Status : ".

$_POST['rbstatus'] ."";

// mengambil nilai isian dari form untuk

pembuatan user

$name = $_POST['txtname'];

$group = $_POST['lstgroup'];

$address = $_POST['txtallowed_address'];

$comment = $_POST['txtcomment'];

$password = $_POST['txtpassword'];

$status = $_POST['txtstatus'];

// mengatur nilai argumen disabled berdasarkan

isian status

if ($status == 'Enable')

6-7

{

$status = 'false';

}

else

{

$status = 'true';

}

// menyisipkan file config.php

include("config.php");

// mengeksekusi perintah Mikrotik CLI

$API->write("/user/add", false);

$API->write("=name=$name", false);

$API->write("=group=$group", false);

$API->write("=address=$address", false);

$API->write("=comment=$comment", false);

$API->write("=password=$password", false);

$API->write("=disabled=$status");

// membaca hasil eksekusi perintah tersebut

$API->read();

echo "Data user berhasil ditambahkan!";

// memutuskan koneksi dari router mikrotik

$API->disconnect();

}

}

?>

Mikrotik RouterOS - New

User

Note: * Fields must be filled

Name*

:

6-9

:

Status*

:

>

Enable

>

Disable

Tampil Data User


6-10

5. Kode program pada file "update_user.php" untuk mengubah data sistem user tertentu adalah

sebagai berikut:

Mikrotik RouterOS - Update User

6-11

if (empty($_POST['lstgroup']))

{

$error[] = 'Group is required!';

}

if (empty($_POST['txtcomment']))

{

$error[] = 'Comment is required!';

}

if (empty($_POST['txtpassword']))

{

$error[] = 'Password is required!';

}

if (empty($_POST['txtretype_password']))

{

$error[] = 'Retype Password is required!';

}

if ($_POST['txtpassword'] !=

$_POST['txtretype_password'])

{

$error[] = 'The passwords you entered do not

match. Please try again!';

}

if (empty($_POST['rbstatus']))

{

$error[] = 'Status is required!';

}

if (count($error) > 0)

{

echo "";

foreach ($error as $data)

{

echo "$data";

}

echo "";

}

else

{

echo "Name : ".

$_POST['txtname'] ."";

6-12

echo "Group : ".

$_POST['lstgroup'] ."";

echo "Allowed Address : ".

$_POST['txtallowed_address'] ."";

echo "Comment : ".

$_POST['txtcomment'] ."";

echo "Password : ".

$_POST['txtpassword'] ."";

echo "Status : ".

$_POST['rbstatus'] ."";

// mengambil nilai isian dari form untuk

pembuatan user

$id = $_POST['id'];

$name = $_POST['txtname'];

$group = $_POST['lstgroup'];

$address = $_POST['txtallowed_address'];

$comment = $_POST['txtcomment'];

$password = $_POST['txtpassword'];

$status = $_POST['rbstatus'];

// mengatur nilai argumen disabled berdasarkan

isian status

if ($status == 'enable')

{

$status = 'false';

}

else

{

$status = 'true';

}


$API->write("/user/set", false);

$API->write("=.id=$id", false);

$API->write("=name=$name", false);

$API->write("=group=$group", false);

$API->write("=address=$address", false);

$API->write("=comment=$comment", false);

$API->write("=password=$password", false);

$API->write("=disabled=$status");


$API->read();

6-13

echo "Data user berhasil diubah!";


$API->disconnect();

}

}

else

{

// mengambil data user dari router mikrotik

$id = $_GET['id'];


$API->write("/user/print", false);

$API->write("=.proplist=.id", false);

$API->write("=.proplist=name", false);

$API->write("=.proplist=group", false);

$API->write("=.proplist=address", false);

$API->write("=.proplist=comment", false);

$API->write("=.proplist=password", false);

$API->write("=.proplist=disabled", false);

$API->write("?.id=$id");

// membaca hasil dari eksekusi perintah diatas

$users = $API->read();

// menampung isian masing-masing argumen user pada

variable tertentu

foreach ($users as $data)

{

$name = $data['name'];

$group = $data['group'];

$address = $data['address'];

$comment = $data['comment'];

$status = $data['disabled'];

if ($status == 'true')

{

$status = 'disable';

}

else

{

$status = 'enable';

}

6-14

}


$API->disconnect();

?>

Mikrotik RouterOS - Update

User

Note: * Fields must be filled

Name*

:

6-17

$id = $_GET['id'];


$API->write("/user/remove", false);

$API->write("=.id=$id");


$API->read();

echo "User tersebut berhasil dihapus!";

echo "Tampil Data User";

?>


7. Kode program pada file "disable_user.php" untuk menonaktifkan sistem user tertentu adalah

sebagai berikut:


6-18

8. Kode program pada file "enable_user.php" untuk mengaktifkan sistem user tertentu adalah

sebagai berikut:


Documents

06 - Mikrotik PHP API Pada System User