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

# Batasi Akses Device

Fitur **Batasi Akses Device** digunakan untuk mengontrol visibilitas dan akses pengguna terhadap device tertentu dalam satu instansi.\
Dengan fitur ini, sistem dapat memastikan bahwa pengguna hanya melihat dan berinteraksi dengan device yang relevan dengan tanggung jawabnya.

<Card title="Use Case">
  Contoh: dari 10 device yang tersedia dalam satu instansi, seorang user hanya diperbolehkan melihat dan mengelola 1 device tertentu sesuai area tugasnya.
</Card>

***

## Konsep Akses Device

Sistem menggunakan pendekatan pembatasan berbasis daftar:

* **Allow List (Whitelist)** → hanya device yang dipilih yang dapat diakses
* Device yang tidak termasuk dalam daftar akan **otomatis disembunyikan**
* Akses bersifat eksplisit (harus dipilih satu per satu)

Pendekatan ini memberikan kontrol yang lebih ketat dibandingkan model akses terbuka.

***

## Behavior Sistem

Saat pembatasan akses diterapkan, sistem akan berperilaku sebagai berikut:

* Jika **tidak ada device yang dipilih** → user tidak dapat mengakses device apapun
* Filtering berlaku secara global di seluruh modul:
  * Map View
  * List Device
  * Dashboard Analytics
* Tidak mengubah role atau permission utama (hanya membatasi scope data)
* Berlaku secara real-time setelah disimpan

<Callout type="warning">
  Akses device bersifat restriktif. Pastikan minimal 1 device dipilih agar pengguna tetap dapat bekerja.
</Callout>

***

## Prasyarat

Sebelum membatasi akses device:

* Device sudah terdaftar dalam sistem
* Pengguna sudah memiliki role
* Anda memiliki akses untuk mengelola pengguna

***

## Langkah Pembatasan Akses

<Steps>
  <Step title="Access User Management Page" toc={false}>
    Buka **Instansi** → **Manajemen Pengguna**
  </Step>

  <Step title="Search User" toc={false}>
    Gunakan fitur pencarian atau filter untuk menemukan pengguna yang ingin dibatasi aksesnya
  </Step>

  <Step title="Open Action Menu" toc={false}>
    Klik ikon `...` pada pengguna
  </Step>

  <Step title="Select Device Access Restriction" toc={false}>
    Pilih opsi `Batasi Akses Alat`
  </Step>

  <Step title="Select Devices" toc={false}>
    Checklist device yang ingin diberikan akses dari daftar **Device Tersedia**
  </Step>

  <Step title="Save Access Restrictions" toc={false}>
    Klik tombol **Simpan** untuk menerapkan pembatasan

    <Frame>
      <video src="https://mintcdn.com/mertani/yrybY0Cd-4ZXOwAB/assets/dashboard-guides/access-control/limit-deviceaccess.webm?fit=max&auto=format&n=yrybY0Cd-4ZXOwAB&q=85&s=3f59201dafb6e33898dc0e90483f9626" controls autoPlay loop playsInline muted data-path="assets/dashboard-guides/access-control/limit-deviceaccess.webm" />
    </Frame>
  </Step>
</Steps>

***

## Dampak Pembatasan

Setelah akses device dibatasi:

* Pengguna hanya dapat melihat device yang dipilih
* Data dari device lain tidak akan muncul sama sekali
* Dashboard menjadi lebih fokus dan relevan
* Risiko akses data yang tidak perlu dapat dikurangi

***

## Best Practice

Untuk implementasi yang optimal:

* Selalu berikan minimal 1 device
* Gunakan pembatasan untuk user lapangan atau operator spesifik
* Kombinasikan dengan role untuk kontrol akses yang lebih kuat
* Lakukan pengecekan ulang sebelum menyimpan

***

## Note

* Pembatasan akses device tidak menggantikan sistem role
* Fitur ini hanya mengontrol **scope data**, bukan aksi
* Sangat direkomendasikan untuk organisasi dengan banyak device dan user