- Modul Consumable Item: model master, buku besar transaksi (stock ledger), purchase unit conversion, stock opname, dan transaction reversal - Integrasi ke Employee Management, Asset Unit, dan tiket/work order - Konfigurasi akses jaringan lokal (LAN) via 0.0.0.0:8000, ALLOWED_HOSTS, dan CSRF_TRUSTED_ORIGINS otomatis - Script pembuka firewall Windows (buka_firewall_lan.bat) dan menu interaktif run.bat - Skema migrasi 0019_consumableitem_consumabletransaction - Seeder 11 item consumable riil (seed_consumables.py) - Test suite komprehensif (41 automated tests, 100% lulus) - Pipeline CI/CD GitHub Actions (.github/workflows/ci.yml)
157 lines
6.5 KiB
Markdown
157 lines
6.5 KiB
Markdown
# 05 — Roles, Permissions & Authentication
|
|
|
|
**Tanggal Analisis:** 26 Oktober 2026
|
|
**Sumber:** `assets/views.py`, `itam_core/settings.py`, `itam_core/urls.py`, `templates/base.html`
|
|
**Status:** Terverifikasi dari source code
|
|
|
|
---
|
|
|
|
## 1. Authentication Flow
|
|
|
|
### 1.1 Login
|
|
|
|
```mermaid
|
|
flowchart TD
|
|
A["User → GET /login/"] --> B{Sudah login?}
|
|
B -->|Ya| C["Redirect → /dashboard/"]
|
|
B -->|Tidak| D["Tampilkan login.html"]
|
|
D --> E["User submit POST /login/"]
|
|
E --> F{Input berisi '@'?}
|
|
F -->|Ya| G["Lookup User by email"]
|
|
G --> H["Gunakan username yang ditemukan"]
|
|
F -->|Tidak| H
|
|
H --> I["authenticate(username, password)"]
|
|
I --> J{Valid?}
|
|
J -->|Ya| K["login(request, user)"]
|
|
K --> L{Ada next param yang aman?}
|
|
L -->|Ya| M["Redirect ke next URL"]
|
|
L -->|Tidak| N["Redirect → /dashboard/"]
|
|
J -->|Tidak| O["messages.error → tampil pesan salah"]
|
|
O --> D
|
|
```
|
|
|
|
**Fitur login:**
|
|
- Login via username ATAU email (L2452-2458 di `login_view`)
|
|
- Redirect ke URL `next` yang aman setelah login (menggunakan `url_has_allowed_host_and_scheme`)
|
|
- Jika sudah login, redirect ke dashboard
|
|
|
|
### 1.2 Logout
|
|
|
|
- Hanya via POST (`logout_view` L2473-2476)
|
|
- CSRF token diperlukan (form di base.html mengandung CSRF token)
|
|
- Redirect ke `/login/` setelah logout
|
|
|
|
### 1.3 Django Session
|
|
|
|
- Session disimpan di database Django (default `django.contrib.sessions.SessionStore`)
|
|
- `SESSION_COOKIE_SECURE = True` di production (DEBUG=False)
|
|
|
|
---
|
|
|
|
## 2. Authorization Model
|
|
|
|
### 2.1 Model Authorization yang Digunakan
|
|
|
|
| Mekanisme | Digunakan? | Detail |
|
|
|---|---|---|
|
|
| `@login_required` decorator | Ya | Hampir semua view menggunakannya |
|
|
| Django Groups | Tidak ditemukan implementasi | INSTALLED_APPS include `auth`, tapi tidak ada grup |
|
|
| Django Permissions | Tidak ditemukan | Tidak ada `has_perm()` atau `permission_required` |
|
|
| Object-level permissions | Tidak ada | Tidak ada django-guardian atau similar |
|
|
| Custom middleware | Tidak ada | Hanya middleware bawaan |
|
|
| Role-based access | Tidak ada | Satu level: authenticated = akses penuh |
|
|
|
|
### 2.2 Satu-satunya Pembatasan Akses Khusus
|
|
|
|
**Backup Database** — hanya `is_superuser` yang dapat mengakses:
|
|
|
|
```python
|
|
# assets/views.py L2538-2540
|
|
if not request.user.is_superuser:
|
|
return HttpResponseForbidden("Anda tidak memiliki akses ke halaman ini.")
|
|
```
|
|
|
|
Ini adalah **satu-satunya** pembatasan akses berbasis role yang ditemukan di seluruh aplikasi.
|
|
|
|
---
|
|
|
|
## 3. Role yang Teridentifikasi
|
|
|
|
| Role | Deskripsi | Akses | Bukti | Status |
|
|
|---|---|---|---|---|
|
|
| **Anonymous** | Belum login | Hanya: `/login/`, `/public/unit/{uuid}/`, `/qr/{uuid}/` | URL patterns | Terverifikasi |
|
|
| **Authenticated User** | User Django yang sudah login | Hampir semua fitur kecuali backup SQL | `@login_required` di views | Terverifikasi |
|
|
| **Superuser** | `is_superuser=True` | Semua fitur termasuk backup database | `backup_database_view` check L2538 | Terverifikasi |
|
|
|
|
> [!WARNING]
|
|
> **Tidak ada diferensiasi role** dalam praktiknya. Jika ada 2 user yang login, keduanya memiliki akses yang sama ke semua fitur kecuali backup. Tidak ada "read-only" user, tidak ada role "supervisor" atau "viewer".
|
|
|
|
---
|
|
|
|
## 4. Permission Matrix per Fitur
|
|
|
|
| Fitur | Anonymous | Authenticated | Superuser | Catatan |
|
|
|---|---|---|---|---|
|
|
| Login | ✅ | ↩️ Redirect | ↩️ Redirect | — |
|
|
| Logout | ❌ | ✅ | ✅ | — |
|
|
| Dashboard | ❌ | ✅ | ✅ | — |
|
|
| Daftar Aset | ❌ | ✅ | ✅ | — |
|
|
| **Tambah Aset** | **✅ PUBLIK!** | ✅ | ✅ | **BUG: tidak ada @login_required** |
|
|
| Edit Aset | ❌ | ✅ | ✅ | — |
|
|
| Hapus Aset | ❌ | ✅ | ✅ | — |
|
|
| Export Aset | ❌ | ✅ | ✅ | Anomali double decorator |
|
|
| Unit Aset | ❌ | ✅ | ✅ | — |
|
|
| Tambah Unit | ❌ | ✅ | ✅ | — |
|
|
| Edit Unit | ❌ | ✅ | ✅ | — |
|
|
| Hapus Unit | N/A | N/A | N/A | URL tidak terdaftar |
|
|
| Status Aset | ❌ | ✅ | ✅ | — |
|
|
| Distribusi | ❌ | ✅ | ✅ | — |
|
|
| Data Karyawan | ❌ | ✅ | ✅ | — |
|
|
| QR Code | ✅ | ✅ | ✅ | By design — untuk scan publik |
|
|
| Halaman Publik Unit | ✅ | ✅ | ✅ | By design — untuk scan QR |
|
|
| Backup JSON | ❌ | ✅* | ✅ | *Authenticated non-superuser bisa akses (tidak ada superuser check) |
|
|
| **Backup SQL** | ❌ | ❌ Forbidden | ✅ | Satu-satunya pembatasan khusus |
|
|
| Profil | ❌ | ✅ | ✅ | — |
|
|
| Django Admin | Varies | Staff only | ✅ | **URL dikomentari di urls.py** |
|
|
|
|
> [!CAUTION]
|
|
> **Backup JSON (dumpdata)** dapat diakses oleh semua authenticated user (bukan hanya superuser). Ini dapat mengekspos seluruh data database kepada operator biasa jika ada multi-user di masa depan.
|
|
|
|
---
|
|
|
|
## 5. Security Findings terkait Auth
|
|
|
|
| Finding | Lokasi | Severity | Detail |
|
|
|---|---|---|---|
|
|
| `asset_add` tanpa `@login_required` | `views.py` L192 | High | Siapapun bisa tambah aset |
|
|
| `unit_qr_code` tanpa `@login_required` | `views.py` L804 | Info | Disengaja — QR perlu diakses publik |
|
|
| `unit_public_detail` tanpa `@login_required` | `views.py` L847 | Info | Disengaja — halaman publik untuk QR |
|
|
| `backup_database_view` hanya check superuser untuk SQL | `views.py` L2538 | Medium | JSON backup tidak dilindungi sama ketatnya |
|
|
| Double `@login_required` di baris 84-86 | `views.py` L84-86 | Low | Kode anomali, tapi tidak merusak security |
|
|
| `login_view` tidak ada rate limiting | `views.py` L2442 | Medium | Brute-force login tidak dicegah |
|
|
| Django Admin dinonaktifkan di URL | `urls.py` L20 | Info | `path('admin/', ...)` dikomentari |
|
|
|
|
---
|
|
|
|
## 6. Password Management
|
|
|
|
| Aspek | Implementasi | Status |
|
|
|---|---|---|
|
|
| Password hashing | Django default (PBKDF2-SHA256) | ✅ Aman |
|
|
| Password validators | 4 validator aktif (similarity, length, common, numeric) | ✅ |
|
|
| Ganti password | Verifikasi password lama dulu | ✅ |
|
|
| Session update setelah ganti password | `update_session_auth_hash` dipanggil | ✅ |
|
|
| Password reset via email | Tidak ditemukan | ❌ Missing |
|
|
| Password via env | `setup_superuser.py` membaca dari env | ✅ |
|
|
|
|
---
|
|
|
|
## 7. Bagian yang Belum Dapat Diverifikasi
|
|
|
|
| Aspek | Status | Langkah Verifikasi |
|
|
|---|---|---|
|
|
| Apakah ada lebih dari satu Django user di production | Belum diketahui | Periksa database `auth_user` |
|
|
| Konfigurasi session expire time | Belum diketahui | Cek settings untuk `SESSION_COOKIE_AGE` (tidak ditemukan, default Django = 2 minggu) |
|
|
| Apakah Django Admin pernah digunakan sebelumnya | Indikasi ya (terdaftar di admin.py) | Periksa apakah ada data di `django_admin_log` |
|
|
| Mekanisme recovery jika password superuser terlupa | Belum terverifikasi | Cek apakah `setup_superuser.py` ada di deployment runbook |
|