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

# Invite Pengguna

> Menambahkan pengguna baru ke dalam dashboard Mertani

## Overview

Fitur **Invite Pengguna** digunakan untuk menambahkan pengguna baru ke dalam sistem melalui mekanisme undangan berbasis email.\
Pendekatan ini memastikan bahwa hanya pengguna yang memiliki akses valid yang dapat bergabung ke dalam instansi.

Secara sistem, proses invite akan:

* Mengirim undangan ke email pengguna
* Mengaitkan pengguna ke instansi terkait
* Memberikan role awal sesuai konfigurasi
* Pengguna menerima invitation
* Pengguna membuat atau mendapatkan password untuk login

#### Konsep Invite

Invite berbasis email memastikan kontrol akses yang lebih aman, karena hanya pemilik email yang dapat mengaktifkan akun.

---

## Tujuan dan Use Case

Fitur ini digunakan dalam skenario berikut:

* Menambahkan anggota tim baru ke dashboard
* Memberikan akses ke stakeholder eksternal
* Onboarding user baru secara terkontrol
* Mengelola akses tanpa perlu membuat akun manual

---

## Behavior Sistem

Saat proses invite dilakukan, sistem memiliki perilaku berikut:

* Jika email **belum terdaftar** → sistem akan membuat akun baru
* Jika email **sudah terdaftar** → pengguna langsung ditambahkan ke instansi
* Role akan **langsung terpasang** saat invite dibuat
* Pengguna harus menyelesaikan proses aktivasi melalui email
* Akses ke sistem baru aktif setelah proses invite selesai

> **Note**
>
> Jika tidak ada role custom, sistem hanya menyediakan role **Admin** sebagai default.

---

## Prasyarat

Sebelum mengundang pengguna:

* Anda memiliki permission untuk mengelola pengguna
* Email pengguna valid dan aktif
* Role sudah tersedia dalam sistem

---

## Langkah Invite Pengguna

### Masuk Menu

Buka **Instansi** → **Manajemen Pengguna**

### Klik Invite

Klik tombol `Invite Pengguna` untuk membuka form undangan

### Input Email

Masukkan email pengguna yang akan diundang

### Pilih Role

Tentukan role yang akan diberikan kepada pengguna

### Simpan

Klik tombol **Simpan** untuk mengirim undangan ke email pengguna

---

## Alur Setelah Invite

Setelah undangan dikirim:

1. Pengguna menerima email undangan
2. Pengguna membuka link invitation
3. Pengguna menerima `password` melalui email
4. Pengguna dapat login ke dashboard
5. Role langsung aktif sesuai konfigurasi

---

## Dampak Sistem

Setelah pengguna berhasil di-invite:

* Pengguna langsung terhubung ke instansi
* Role menentukan akses awal pengguna
* Pengguna dapat langsung menggunakan fitur sesuai role

---

## Best Practice

Untuk memastikan proses berjalan optimal:

* Gunakan email yang valid dan aktif
* Pilih role yang sesuai sejak awal
* Hindari memberikan akses tinggi tanpa kebutuhan
* Verifikasi pengguna yang diundang

---

## Catatan Tambahan

* Invite berbasis email meningkatkan keamanan akses
* Role ditentukan sejak awal untuk menghindari kesalahan akses
* Disarankan untuk memonitor status undangan dalam sistem (jika fitur tersedia)

> Menambahkan pengguna baru ke dalam dashboard Mertani