[Yii Framework] Membuat Level Access User dengan Rights Extension

Selama ini saya selalu membuat sendiri alur dan code untuk melakukan level akses user untuk mengontrol hak akses user pada sistem yang saya buat.. Sebanarnya pada Yii sudah ada extension yang menyediakan fitur untuk pengaturan level akses user ini agar kita dapat membuat pengaturan level akses user secara dinamis pada aplikasi yang kita bangun. Sejauh ini yang saya tahu extension yang sudah populer untuk membuat level akses user di kalangan yii adalah Rights dan SRBAC. Dan walau sudah lama saya memecahkan masalah ini dengan coding sendiri, akhirnya tadi malam timbul rasa penasaran saya untuk mencicipi penggunaan extension dalam kasus ini. Saya bandingkan antara Rights dan SRBAC akhirnya saya pilih Rights.. yah, tidak ada alasan ilmiah kenapa saya pilih Rights daripada SRBAC, hanya berdasarkan total “Like” nya dan rights ada contoh blog nya yang bisa saya coba langsung..

Sebelum lebih lanjut, bagi anda yang belum pernah mencoba membuat level akses user secara manual, saya sarankan jangan langsug menggunakan extension.. Ada baiknya pelajari terlebih dahulu dengan membuat sendiri (di blog ini ada tutor nya).. paling tidak membantu anda dalam mempelajari dan memahami terlebih dahulu tentang level akses user..

Okeh mari kita bahas penggunaan extension ini. Pertama-tama, silahkan download terlebih dahulu extension rights di : http://www.yiiframework.com/extension/rights/ Dan jangan lupa untuk mendownload dokumentasi dan contoh blog nya.. Paling tidak ini bisa sangat membantu ketika anda kesulitasn.. Setelah sudah mendownload nya, silahkan anda buat aplikasi baru anda dengan Yii Framework. Sebelum menginstal rights extension pada aplikasi anda, buatlah terlebih dahulu agar aplikasi anda dapat melakukan operasi login, logout, register yang sudah terhubung dengan database (jika anda tidak tahu caranya, saya sudah pernah posting di blog ini silahkan dicari yak.. 🙂 ). Anda sudah selesai melakukannya ? jika iya baru kita akan satukan extension rights.

Unpack rights extension yang telah anda download tadi lalu pindahkan pada aplikasi anda tepatnya pada direktori “protected/modules”. Kemudian lakukan setting pada file “protected/config/main.php” menjadi seperti berikut :

'import'=>array(
 'application.models.*',
 'application.components.*',
 'application.modules.rights.*',  // mendefinisikan rights modules ke dalam aplikasi kita
 'application.modules.rights.components.*',  // mendefinisikan rights modules components ke dalam aplikasi kita
 ),
'modules'=>array(
 'rights'=>array(
    'superuserName'=>'Admin',
    'userIdColumn'=>'id',    // mengeset nama colom yang menjadi id user
    'userNameColumn'=>'username',  mengeset nama colom yang menjadi username user
    'install'=>true, // jika anda ingin menginstall, jika sudah terinstal dihilangkan saja baris ini
    ),
),
'components'=>array(
  'user'=>array(
    'allowAutoLogin'=>true,
    'class'=>'RWebUser',
 ),
 'authManager'=>array(
    'class'=>'RDbAuthManager',
 ),
),

Sebelumnya perlu anda ketahui bahwa rights extension akan mengakses sebuah model bernama “User” untuk mengecek seorang user. Jika memang anda memberi nama model anda dengan nama lain misal “member”,”tabel_anggota”, dan lain-lain anda harus lakukan pengaturan lagi pada configurasi di atas. Bagaimana configurasi nya? silahkan baca dokumentasi yang ada dari rights extensions..

Jika sudah melakukan konfigurasi di atas, untuk menginstall rights extension di aplikasi anda silahkan mengakses url “http://localhost/namaaplikasianda/index.php?r=rights” pada browser anda.. Jika berhasil, maka pada database anda akan terdapat 4 buah tabel baru yang di generate dari Rights extension. Ingat setelah kita menginstal rights extension user yang diizinkan untuk mengakses nya adalah user yang melakukan penginstalan tadi. Misal tadi saya login dengan username “admin”, secara otomatis si “admin” ini lah yang diizinkan mengakses rights, jika user lain maka tidak bisa.. Tetapi setelah itu si “admin” dapat memberikan hak yang sama kepada user lain sesuai dengan yang dia inginkan.. Setelah sudah terinstal, silahkan masuk kembali ke url di atas.. maka anda akan melihat tampilan seperti berikut :

Okeh, pada menu tersebut terdapat 5 buah menu.. mari kita bahas satu persatu menu tersebut :

1. Assignment : ini adalah menu yang digunakan untuk memberikak hak akses kepada seorang user. Hak akses yang diberikan bisa dengan cara memberikan pangkat (level) kepada seorang user atau memberikan langsung izin seorang user mengakses sebuah “task” (controller) atau lebih detail lagi sebuah operastion (action di dalam controller). Jadi saya bisa memberikan “sabit” pangkat admin, saya juga bisa mengizinkan “sabit” mengakses controller “PegawaiController” atau saya juga menentukan apakah “sabit” boleh mengakses “actionCreate” yang ada di controller pegawai.. Menarik bukan??
2. Permissions : disini adalah tempat dimana kita menentukan suatu level boleh mengakses siapa saja. Misal kita memiliki level “momod” kita mengizinkan dia mengakses actionCreate,actionDelete, dan actionUpdate.. kita cukup mengeset nilai “assign”(mengizinkan) atau “revoke” (tidak mengizinkan) pada si level momod. Dan tentu saja ini dapat dilakukan konfigurasinya pada semua level. Note : level admin adalah super user, dia diizinkan mengakses apa saja termasuk menu rights extension.
3. Roles : tempat dimana kita dapat menentukan level-level yang ada di dalam sistem kita. Misal kita ingin dalam sistem kita ada level “momod”, “content-writer”,”sekretaris” , dan lain-lain.. disinilah tempatnya..
4. Tasks : kita dapat menentukan tasks apa saja yang ada di dalam sistem kita. Biasanya digunakan untuk memberikan hak penuh pada suatu controller di semua actionnya..
5. Operations : digunakan untuk melakukan pengesetan level akses user pada suatu action yang ada di controller.

Okeh, sudah saya paparkan.. Jika memang masih sulit dipahami ada baiknya anda langsung mencoba atau membaca kembali dokumentasi rights.. karena  saya juga masih belum terlalu dalam memahami extension ini.. 🙂

Nah, jika telah berhasil cobalah untuk memberi hak akses kepada seorang user baik berdasarkan “task”,”operastion” ,maupun “role” nya.. Jika sudah, ada satu hal lagi yang perlu anda konfigurasi.. yaitu pada file “protected/components/Controller.php” rubahlah extend classnya yang semula seperti ini :

class Controller extends CController

Menjadi seperti ini :

class Controller extends RController

Itu dimaksudkan untuk mengizinkan right extension di terapkan filter nya pada masing-masing controller yang ada di aplikasi kita.. Kemudian jangan lupa di controller kita masing-masing di set code seperti berikut :

public function filters()
 {
   return array(
     'rights',
   );
 }

Hal itu dilakukan untuk memastikan filter yang dijalankan pada controller tersebut adalah filter yang berasal dari Rights extension..

Selesai.. anda dapat mendalami penggunaan rights extension dengan melihat dokumentassi, forum, contoh blog  rights extension di internet maupun website Yii…

Selamat mencoba..

Semoga membantu… 🙂