> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docku.mertani.com/access-control/assign-role/llms.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.

#### Konsep Role

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)

> **Note**
>
> 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)

> Mengubah role pengguna dalam sistem