# USAGE.md — Cara pakai Labs Pentest

> Baca `targets/SCOPE.md` dulu. Aturan singkatnya: **hanya target yang
> sudah terotorisasi** (Tier 0 lab lokal, Tier 1 aset sendiri, Tier 1w
> perangkat sendiri, Tier 1L permintaan lembaga dengan bukti izin).
> Semua contoh di bawah memakai lab lokal / domain contoh — ganti
> dengan targetmu sendiri yang sudah tercatat di `targets/AUTHORIZED.md`.

## 1. Pasang

```bash
git clone https://github.com/dezzorigin/labs-pentest.git
cd labs-pentest
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt   # 6 dependensi produksi, pin exact
```

Wordlist (`wordlists/`: `passwords-10k.txt`, `subdomains-5000.txt`,
`params-burp.txt`, `dir-small.txt`) **tidak ada di repo** — siapkan
sendiri dan jangan commit (sudah di `.gitignore`).

Dependensi opsional (diinstall on-demand, bukan di `requirements.txt`):

```bash
pip install faster-whisper   # captcha/audio_solver.py (transkrip audio)
pip install pefile oletools  # malware/triage.py (struktur PE + macro)
```

## 2. Mulai engagement baru

```bash
./scripts/new-engagement.sh "<nama-aset>" "<target>"
# membuat evidence/<tgl>-<nama>/ (raw/ chmod 700) + plan.md + draf laporan
```

## 3. Contoh sesi yang aman (jalan lokal, tanpa target nyata)

Semua perintah di bawah ini **aman dijalankan di mesin sendiri** dan
dipakai juga sebagai smoke test CI (`tests/test_smoke.py`).

```bash
# --help semua skrip (tidak menyentuh jaringan apa pun)
python3 scripts/recon/headers_audit.py --help
python3 scripts/recon/js_secrets.py --help
python3 scripts/recon/jwt_probe.py --help

# Tambang secret dari bundle JS contoh (kunci contoh resmi AWS — bukan kunci asli)
printf 'const k = "AKIAIOSFODNN7EXAMPLE";\nfetch("/api/v1/admin");\n' > /tmp/contoh.js
python3 scripts/recon/js_secrets.py /tmp/contoh.js
# -> menemukan aws_access_key + api_path /api/v1/admin

# Audit token JWT contoh (alg=none, dibuat lokal — bukan token asli)
python3 scripts/recon/jwt_probe.py eyJhbGciOiJub25lIiwidHlwIjoiSldUIn0.eyJzdWIiOiJ1amkiLCJleHAiOjk5OTk5OTk5OTl9.
# -> menandai alg=none sebagai kelemahan struktural

# Triase statis satu file contoh (tanpa eksekusi)
printf 'MZ....powershell....https://contoh.invalid/x\n' > /tmp/sampel.bin
python3 scripts/malware/triage.py /tmp/sampel.bin --out /tmp/triage.json

# Audit header ke server lokal sendiri
python3 -m http.server 8451 --bind 127.0.0.1 --directory /tmp &
python3 scripts/recon/headers_audit.py http://127.0.0.1:8451/
python3 scripts/recon/exposure.py http://127.0.0.1:8451/
```

## 4. Contoh per mode (target milik sendiri — ganti URL-nya)

```bash
# MODE SENYAP — recon pasif dulu
python3 scripts/recon/js_secrets.py app.bundle.js
python3 scripts/recon/headers_audit.py https://target-milik-sendiri.id/
python3 scripts/recon/exposure.py https://target-milik-sendiri.id/

# MODE JEJAK — OSINT pasif (tidak menyentuh target)
python3 scripts/osint/ct_subs.py contoh.id
python3 scripts/osint/dns_recon.py contoh.id
python3 scripts/osint/wayback_urls.py contoh.id --interesting

# MODE KETUK — fingerprint login dulu sebelum apa pun
python3 scripts/evasion/req.py GET https://target-milik-sendiri.id/login --detect

# MODE KUNCI — audit token
python3 scripts/recon/jwt_probe.py <token> --crack wordlists/passwords-10k.txt --max 500

# MODE CERMIN / TEROWONGAN — listener OOB di lab sendiri
python3 scripts/c2/listener.py --port 18888 --log evidence/<engagement>/raw/egress.jsonl

# MODE WABAH — triase sampel (TIDAK PERNAH dieksekusi)
python3 scripts/malware/triage.py sampel.bin --out triage.json

# MODE GELAP — preflight WiFi tanpa sudo (cek kesiapan hardware saja)
bash scripts/wifi/wifi_preflight.sh

# BLUE — audit pertahanan sendiri
python3 scripts/blue/tls_audit.py target-milik-sendiri.id
python3 scripts/blue/supply_audit.py ~/proyek-milik-sendiri
bash scripts/blue/lotl_audit.sh
```

## 5. Tutup engagement

1. Tulis laporan dari `reports/TEMPLATE.md` di sesi yang sama —
   temuan + reproduksi + bukti **MASKED** + remediasi + blue-team.
2. Retest setelah perbaikan.
3. Setelah retest lolos: hapus `evidence/<engagement>/raw/`, catat
   penghapusan di laporan (§7 template), tutup engagement.

## 6. Yang dilarang

- Menyerang target di luar registry + deklarasi.
- Menempel data mentah (dump/unmask) ke chat, laporan, atau repo.
- Deauth / injection ke AP atau client orang lain (WiFi: hanya AP &
  client sendiri; `eduroam` dilarang total kecuali audit pasif EAP di
  perangkat sendiri).
- Aksi destruktif tanpa kata kunci eksplisit dari pemilik aset.
