> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docku.mertani.com/llms.txt.
> For full documentation content, see https://docku.mertani.com/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docku.mertani.com/_mcp/server.

# Assign Role

> Mengubah role pengguna dalam sistem

## Overview

Fitur **Assign Role** digunakan untuk mengubah peran (role) pengguna dalam sistem secara langsung.\
Setiap role memiliki kumpulan **permission** yang berbeda, sehingga perubahan role akan berdampak langsung pada akses dan tindakan yang dapat dilakukan oleh pengguna tersebut.

Role adalah representasi kumpulan permission yang telah dikelompokkan berdasarkan fungsi atau tanggung jawab tertentu dalam sistem.\
Dengan menggunakan role, pengelolaan akses menjadi lebih terstruktur, konsisten, dan mudah dikontrol.

***

## Tujuan dan Use Case

Assign role biasanya digunakan dalam beberapa kondisi berikut:

* Perubahan tanggung jawab pengguna (misalnya dari Operator menjadi Admin)
* Penyesuaian akses sementara untuk kebutuhan operasional
* Koreksi kesalahan pemberian role saat pembuatan akun
* Pembatasan akses untuk alasan keamanan

***

## Behavior Sistem

Sistem memiliki mekanisme yang bersifat deterministik saat proses assign role dilakukan:

* Role lama **akan langsung digantikan** oleh role baru (tidak ada multi-role)
* Semua permission akan **mengikuti role yang baru dipilih**
* Perubahan akan **langsung aktif (real-time)** tanpa perlu logout/login ulang
* Tidak ada histori perubahan role secara default (kecuali diaktifkan audit log)

Perubahan role dapat langsung mengubah akses pengguna terhadap fitur penting, termasuk akses ke data sensitif atau konfigurasi sistem.\
Pastikan perubahan dilakukan oleh pihak yang berwenang.

***

## Prasyarat

Sebelum melakukan assign role, pastikan:

* Anda memiliki permission untuk mengelola pengguna
* Role tujuan sudah tersedia di sistem
* Pengguna target sudah terdaftar dan aktif

***

## Langkah Assign Role

### Masuk Menu

Buka menu `Instansi` → `Manajemen Pengguna` untuk melihat daftar seluruh pengguna dalam sistem.

### Cari Pengguna

Gunakan fitur pencarian atau filter untuk menemukan pengguna yang ingin diubah rolenya.\
Filter dapat berupa nama, email, atau status pengguna.

### Aksi

Klik ikon `...` (action menu) pada baris pengguna yang dipilih untuk membuka opsi tindakan.

### Ubah Role

Pilih opsi `Ubah Role` dari daftar aksi yang tersedia.

### Pilih Role

Tentukan role baru yang akan diberikan kepada pengguna.\
Pastikan role yang dipilih sesuai dengan kebutuhan akses.

### Simpan

Klik tombol `Simpan` untuk menerapkan perubahan.

***

## Dampak Perubahan Role

Setelah role diubah, berikut dampak yang terjadi:

* Menu dan fitur yang tersedia akan menyesuaikan
* Akses ke data tertentu bisa bertambah atau berkurang
* Hak aksi (create, edit, delete, approve) akan berubah
* Beberapa halaman mungkin tidak lagi dapat diakses

## Best Practice

Untuk menjaga keamanan dan konsistensi sistem:

* Gunakan prinsip **least privilege** (akses seminimal mungkin)
* Hindari memberikan role dengan akses tinggi tanpa kebutuhan jelas
* Lakukan review role secara berkala
* Dokumentasikan perubahan role penting (jika tidak ada audit log)

***

## Note

* Assign role bersifat **overwrite**, bukan menambah
* Sistem tidak mendukung multi-role secara default
* Untuk kebutuhan kompleks, gunakan kombinasi role + permission granular (jika tersedia)