> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opteraone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manajemen Hak Akses

> Cara membuat, mengatur, dan mengelola hak akses pengguna di CMS  OpteraOne.

Hak Akses mendefinisikan peran (role) dan izin (permission) yang dimiliki setiap pengguna dalam sistem OpteraOne. Setiap pengguna yang dibuat wajib memiliki Hak Akses yang menentukan modul dan fitur apa saja yang dapat mereka gunakan.

<Note>
  Pengaturan Hak Akses adalah **langkah pertama** dalam Setup Awal dan harus diselesaikan sebelum membuat pengguna baru. Tanpa Hak Akses yang sudah dikonfigurasi, pengguna baru tidak dapat diberikan peran yang sesuai.
</Note>

***

## Mengakses Halaman Hak Akses

<Steps>
  <Step title="Buka Menu Pengaturan">
    Dari halaman mana pun di CMS, klik menu **Pengaturan** pada navigasi utama.
  </Step>

  <Step title="Pilih Menu Hak Akses">
    Pada halaman Pengaturan, pilih sub-menu **Hak Akses**.
  </Step>
</Steps>

***

## Halaman Daftar Hak Akses

Halaman ini menampilkan semua Hak Akses yang sudah dikonfigurasi dalam sistem.

<Frame>
  <img src="https://mintcdn.com/ait-8f7a7cd9/Nu3V_eCD9H2Exyt7/images/roles.png?fit=max&auto=format&n=Nu3V_eCD9H2Exyt7&q=85&s=e61e0ab14d4683ff089fe48ce248380c" alt="Roles" width="1440" height="900" data-path="images/roles.png" />
</Frame>

Halaman Daftar Hak Akses memiliki 9 fungsi utama:

| #      | Fungsi              | Keterangan                                          |
| ------ | ------------------- | --------------------------------------------------- |
| **#1** | Pencarian nama      | Cari hak akses berdasarkan nama                     |
| **#2** | Pengurutan          | Urutkan berdasarkan: Nama, Status, Perusahaan       |
| **#3** | Jumlah baris data   | Default 10 baris — dapat diubah ke 25, 50, atau 100 |
| **#4** | Filter data         | Kombinasi pencarian menggunakan menu filter         |
| **#5** | Buat hak akses baru | Tombol untuk membuat hak akses baru                 |
| **#6** | Aksi ubah           | Mengubah hak akses yang sudah ada                   |
| **#7** | Aksi nonaktifkan    | Menonaktifkan hak akses yang aktif                  |
| **#8** | Aksi aktifkan       | Mengaktifkan kembali hak akses yang nonaktif        |
| **#9** | Detail hak akses    | Klik nama hak akses untuk melihat detailnya         |

***

## Fungsi Pencarian Hak Akses

<Steps>
  <Step title="Klik Kolom Cari">
    Klik kolom **"Cari"** yang ada di bagian atas halaman Daftar Hak Akses.
  </Step>

  <Step title="Ketik Kata Pencarian">
    Mulai ketik nama hak akses yang ingin dicari. Hasil pencarian akan ditampilkan secara real-time sesuai kata yang diketik.
  </Step>

  <Step title="Tidak Ada Hasil">
    Jika tidak ada hak akses yang cocok, halaman akan menampilkan tampilan kosong. Periksa kembali ejaan kata pencarian.
  </Step>
</Steps>

***

## Fungsi Filter Hak Akses

<Steps>
  <Step title="Klik Ikon Filter">
    Klik ikon **Filter** di bagian atas halaman Daftar Hak Akses. Panel filter akan muncul dari sisi kanan layar.

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/Nu3V_eCD9H2Exyt7/images/roles-1.png?fit=max&auto=format&n=Nu3V_eCD9H2Exyt7&q=85&s=167ff4bda8035b0bc769d340612d8d62" alt="Roles 1" width="1440" height="900" data-path="images/roles-1.png" />
    </Frame>
  </Step>

  <Step title="Pilih Kombinasi Filter">
    Anda dapat memilih kombinasi dari kriteria berikut:

    * **Nama Hak Akses** — cari berdasarkan nama spesifik
    * **Status** — Aktif atau Tidak Aktif
    * **Modul** — filter berdasarkan modul yang dapat diakses
    * **Nama Pembuat** — filter berdasarkan siapa yang membuat
    * **Tanggal Pembuatan** — filter berdasarkan rentang tanggal pembuatan
  </Step>

  <Step title="Terapkan atau Atur Ulang">
    * Klik **"Terapkan"** untuk menerapkan filter yang dipilih
    * Klik **"Atur Ulang"** untuk menghapus semua pilihan filter
    * Klik ikon **✕** di sudut kanan atas panel untuk menutup filter tanpa menerapkan perubahan
  </Step>
</Steps>

***

## Membuat Hak Akses Baru

<Steps>
  <Step title="Klik Tombol 'Buat Hak Akses'">
    Dari halaman Daftar Hak Akses, klik tombol **"Buat Hak Akses"** di bagian kanan atas halaman.
  </Step>

  <Step title="Isi Data Hak Akses">
    Lengkapi informasi berikut pada form pembuatan:

    | Field                     | Keterangan                                                   | Wajib    |
    | ------------------------- | ------------------------------------------------------------ | -------- |
    | **Nama**                  | Nama identifikasi hak akses (contoh: Dispatcher, Supervisor) | ✅ Ya     |
    | **Deskripsi**             | Penjelasan singkat tentang peran ini                         | Opsional |
    | **Hak Akses Modul**       | Centang modul-modul yang dapat diakses oleh peran ini        | ✅ Ya     |
    | **Akses Aplikasi Mobile** | Centang jika peran ini dapat menggunakan aplikasi mobile     | Opsional |

    <Tip>
      Saat mengatur **Hak Akses Modul**, setiap modul umumnya memiliki izin yang dapat dikonfigurasi secara granular — misalnya: hanya **Lihat**, atau **Lihat + Edit**, atau akses penuh termasuk **Hapus**. Sesuaikan dengan tanggung jawab peran tersebut.
    </Tip>

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/Nu3V_eCD9H2Exyt7/images/create.png?fit=max&auto=format&n=Nu3V_eCD9H2Exyt7&q=85&s=51e48056f3d60b7660f048f571ac9446" alt="Create" width="1440" height="1221" data-path="images/create.png" />
    </Frame>
  </Step>

  <Step title="Klik Simpan">
    Scroll ke bagian bawah halaman dan klik tombol **"Simpan"**.

    Konfirmasi simpan akan muncul menampilkan data yang sudah dimasukkan.

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/Nu3V_eCD9H2Exyt7/images/create-1.png?fit=max&auto=format&n=Nu3V_eCD9H2Exyt7&q=85&s=6814bee3539e9146a03e79b26392566f" alt="Create 1" width="1440" height="1203" data-path="images/create-1.png" />
    </Frame>
  </Step>

  <Step title="Konfirmasi Data">
    Periksa kembali data yang ditampilkan pada konfirmasi. Jika sudah sesuai, klik **"Simpan"** untuk menyimpan data hak akses baru.

    Hak akses baru akan langsung tersedia dan dapat digunakan saat membuat pengguna baru.
  </Step>
</Steps>

<Note>
  Jika ingin membatalkan proses pembuatan di langkah mana pun, klik tombol **"Batal"** di bagian bawah halaman. Anda akan diarahkan kembali ke halaman Daftar Hak Akses tanpa ada data yang tersimpan.
</Note>

***

## Melihat Detail Hak Akses

Klik **nama hak akses** pada tabel Daftar Hak Akses untuk membuka halaman Detail Hak Akses.

<Frame>
  <img src="https://mintcdn.com/ait-8f7a7cd9/Nu3V_eCD9H2Exyt7/images/details.png?fit=max&auto=format&n=Nu3V_eCD9H2Exyt7&q=85&s=21a1423f95ba59911cdabe1d6de66cd6" alt="Details" width="1440" height="1091" data-path="images/details.png" />
</Frame>

Pada halaman detail, Anda dapat melihat:

* Seluruh modul yang dapat diakses oleh hak akses tersebut
* Konfigurasi izin per modul secara lengkap
* Status aktif/nonaktif hak akses

Untuk mengubah data, klik tombol **"Lainnya"** → pilih **"Ubah Hak Akses"**.

***

## Mengubah Hak Akses

Perubahan Hak Akses dapat dilakukan melalui **dua cara**:

<Tabs>
  <Tab title="Via Ikon Edit di Daftar">
    Dari halaman Daftar Hak Akses, klik ikon **Edit (✏️)** pada kolom Aksi di baris hak akses yang ingin diubah.
  </Tab>

  <Tab title="Via Halaman Detail">
    Dari halaman Detail Hak Akses, klik tombol **"Lainnya"** → pilih **"Ubah Hak Akses"**.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/access-rights-edit-detail.png" alt="Menu ubah hak akses dari halaman detail" />
    </Frame>
  </Tab>
</Tabs>

Setelah mengklik salah satu opsi, Anda akan diarahkan ke halaman **Ubah Hak Akses**:

<Frame>
  <img src="https://mintcdn.com/ait-8f7a7cd9/Nu3V_eCD9H2Exyt7/images/edit.png?fit=max&auto=format&n=Nu3V_eCD9H2Exyt7&q=85&s=494e28f0ce903bc671b550ff241cdbcc" alt="Edit" width="1440" height="1144" data-path="images/edit.png" />
</Frame>

<Steps>
  <Step title="Lakukan Perubahan">
    Ubah data yang diperlukan — Nama, Deskripsi, Konfigurasi Akses, atau Hak Akses Modul.
  </Step>

  <Step title="Klik Simpan">
    Scroll ke bagian bawah halaman dan klik tombol **"Simpan"**. Konfirmasi perubahan akan ditampilkan.
  </Step>

  <Step title="Konfirmasi Perubahan">
    Periksa data yang ditampilkan. Jika sudah sesuai, klik **"Simpan"** untuk menyimpan perubahan.
  </Step>
</Steps>

<Warning>
  Perubahan pada Hak Akses yang sedang digunakan oleh pengguna akan **langsung berlaku** — pengguna yang bersangkutan akan kehilangan atau mendapatkan akses ke modul yang diubah pada sesi berikutnya.
</Warning>

***

## Menonaktifkan Hak Akses

<Steps>
  <Step title="Klik Ikon Nonaktifkan">
    Dari halaman Daftar Hak Akses, klik ikon **Nonaktifkan** pada kolom Aksi di baris hak akses yang ingin dinonaktifkan.
  </Step>

  <Step title="Konfirmasi Aksi">
    Dialog konfirmasi akan muncul. Klik **"Nonaktifkan"** untuk melanjutkan.

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/Nu3V_eCD9H2Exyt7/images/roles-2.png?fit=max&auto=format&n=Nu3V_eCD9H2Exyt7&q=85&s=544a3ce1e79ad68a3d4833eb13496a72" alt="Roles 2" width="1441" height="901" data-path="images/roles-2.png" />
    </Frame>
  </Step>

  <Step title="Status Berubah">
    Setelah dinonaktifkan, status hak akses berubah menjadi **"Tidak Aktif"**.

    <Warning>
      Semua pengguna yang menggunakan hak akses ini **tidak dapat login** dan menggunakan platform selama hak akses berstatus Tidak Aktif.
    </Warning>
  </Step>
</Steps>

***

## Mengaktifkan Kembali Hak Akses

<Steps>
  <Step title="Klik Ikon Aktifkan">
    Dari halaman Daftar Hak Akses, klik ikon **Aktifkan** pada kolom Aksi di baris hak akses yang ingin diaktifkan kembali.
  </Step>

  <Step title="Konfirmasi Aksi">
    Dialog konfirmasi akan muncul. Klik **"Aktifkan"** untuk melanjutkan.

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/Nu3V_eCD9H2Exyt7/images/roles-3.png?fit=max&auto=format&n=Nu3V_eCD9H2Exyt7&q=85&s=254431dfe18b3a320cc964bb1cbb58e3" alt="Roles 3" width="1441" height="901" data-path="images/roles-3.png" />
    </Frame>
  </Step>

  <Step title="Status Berubah">
    Setelah diaktifkan, status hak akses kembali menjadi **"Aktif"** dan semua pengguna yang menggunakan hak akses ini dapat kembali login dan menggunakan platform.
  </Step>
</Steps>

***

## Langkah Selanjutnya

<Card title="Manajemen Kategori Tugas →" icon="tags" href="/manajemen-kategori-tugas">
  Hak Akses sudah dikonfigurasi? Lanjutkan dengan membuat Kategori Tugas untuk mengelompokkan jenis-jenis pekerjaan dalam sistem.
</Card>