# PRD — Labs Pentest v1.0

> Produk: kumpulan playbook + skrip uji penetrasi untuk **aset sendiri
> yang sudah terotorisasi**. Etalase publiknya adalah landing statis di
> repo ini; produknya tetap playbook yang jalan di mesin lab.
> Status: proper P1 #45 (19 Nov 2026). Pemilik: Nabil Aulia Dika (dezzorigin).

## 1. Masalah

Pengujian keamanan aset sendiri selama ini jalan dari catatan lepas
(PLAYBOOK.md, MODES.md) tanpa: (a) cara pakai yang terdokumentasi per
skrip, (b) uji otomatis yang membuktikan skrip masih jalan, (c) aturan
scope yang bisa dibaca orang luar tanpa salah paham, (d) etalase yang
menjelaskan metodologi tanpa membocorkan target nyata.

## 2. Pengguna

- **Penguji (pemilik aset)** — menjalankan playbook ke lab / aset
  sendiri yang tercatat di `targets/AUTHORIZED.md`.
- **Blue team** — membaca laporan, menjalankan retest, memakai
  `scripts/blue/` untuk audit pertahanan.
- **Pembaca publik** — hanya melihat metodologi + contoh yang sudah
  disanitasi di landing dan `docs/`. Tidak ada target nyata di sini.

## 3. Ruang lingkup

### Termasuk

- 14 mode operasi (MODES.md): SENYAP, KETUK, BONGKAR, BOCOR, SILUMAN,
  DALEM, TEROWONGAN, KUNCI, CERMIN, WABAH, GELAP, RANTAI, JEJAK, MATA.
- 25 skrip Python + 4 skrip shell di `scripts/` (recon, API, OSINT,
  auth-attack, evasion, captcha, CCTV, WiFi, malware, blue-team, C2).
- Pipeline engagement: `new-engagement.sh` → serang → laporan dari
  `reports/TEMPLATE.md` → blue-team follow-up → retest → disposal.
- Label temuan: JEBOL JACKPOT (Critical), TEMBUS (High), RETAK
  (Medium), GORES (Low/Info).
- Landing statis sebagai etalase metodologi (tanpa data target nyata).

### Tidak termasuk (non-goal)

- Menyerang target di luar registry + deklarasi (lihat SCOPE.md).
- Aksi destruktif (drop/rm/enkripsi/DoS) tanpa kata kunci eksplisit.
- Menjalankan malware (triage statis saja, tanpa eksekusi).
- Menyimpan / mempublikasikan data mentah hasil uji — laporan hanya
  data MASKED (format + jumlah + hash).
- Menjadi scanner otomatis sekali-klik: tiap mode butuh operator yang
  membaca hasil dan menulis laporan di sesi yang sama.

## 4. Aturan scope (ringkas — lengkapnya di targets/SCOPE.md)

| Tier | Arti | Contoh |
|---|---|---|
| Tier 0 | Lab lokal, selalu boleh | `http://localhost:3000` (Juice Shop) |
| Tier 1 | Aset sendiri, deklarasi = otorisasi | web / layanan milik sendiri |
| Tier 1w | Jaringan & perangkat sendiri | WiFi / CCTV milik sendiri |
| Tier 1L | Permintaan lembaga, bukti izin dicatat | surat / tiket izin di `evidence/` |
| Tier 2 | Eksternal | hanya dengan izin tertulis ditempel |

## 5. Persyaratan fungsional

1. Setiap skrip punya `--help` yang menjelaskan pemakaian + contoh.
2. Setiap skrip yang butuh dependensi pihak ketiga mengimpornya secara
   malas (lazy) atau mendeklarasikannya di `requirements.txt` (pin `==`).
3. `reports/TEMPLATE.md` memaksa 10 bagian laporan, termasuk disposal
   data dan "yang belum terbukti".
4. CI: ruff (E9+F) + shellcheck + pytest smoke (7 tes, tanpa target
   nyata) + advisory-sweep OSV (HIGH/CRITICAL = gagal) + E2E landing.
5. Landing: metodologi + contoh sanitasi saja; nol nama target nyata,
   nol kredensial, nol IP/host sensitif.

## 6. Kriteria selesai (definition of done)

- README standar + docs/ lengkap + LICENSE MIT + CI hijau.
- Smoke test membuktikan: `--help` semua skrip, `js_secrets` menemukan
  kunci contoh, `jwt_probe` menandai `alg=none`, `triage` membuat JSON,
  `geetest_gap` menemukan gap sintetis, `headers_audit`/`exposure`
  jalan ke server lokal.
- Landing live di Cloudflare Pages + OG preview lengkap.
