Perintah Spark

Shield menyertakan enam perintah Spark. Semuanya opsional, dan tidak ada satu pun yang perlu Anda jalankan supaya Shield bekerja.

Perintah tidak muncul?

Perintah php spark shield:* ditemukan otomatis lewat pemindaian namespace PSR-4 package. Anda tidak perlu mendaftarkannya di app/Config/Commands.php, dan provider tidak diperlukan hanya untuk perintah CLI. Jika tetap tidak muncul, jalankan composer dump-autoload dan periksa cache Spark.

Ringkasan

Perintah	Untuk apa
shield:health	Memeriksa apakah semua komponen siap. Jalankan pertama kali.
shield:report	Merangkum kejadian keamanan. Baca setiap hari saat tuning.
shield:rules:list	Menampilkan rule yang aktif beserta skor dan severity.
shield:prune	Menghapus kejadian lama dan ban yang sudah kedaluwarsa.
shield:release	Melepas ban satu IP.
shield:replay	Menguji ulang korpus serangan terhadap rule saat ini.

shield:health

php spark shield:health

Memeriksa koneksi database, cache, mesin Shield, konfigurasi trusted proxy (proxyIPs), dan resolusi DNS untuk verifikasi crawler. Jalankan setiap kali Shield dipasang, dan lagi setiap kali ada masalah.

Perintah ini tidak memeriksa konfigurasi admin. Peringatan adminAuthorize hanya tersedia di endpoint admin GET /{prefix}/health.

shield:report

php spark shield:report

Mencetak ringkasan kejadian keamanan. Ini perintah yang paling sering Anda perlu saat menyetel mode.

Untuk satu host saja:

php spark shield:report --host=toko-online.test

Dari output ini Anda bisa melihat total event, jumlah BLOCK_REQUEST, dan rule yang paling sering memicu. Perintah ini tidak menghitung challenge atau pass rate challenge.

Metric Unique offenders tidak akurat

Query memakai distinct()->countAllResults() pada seluruh baris, sehingga hasilnya cenderung sama dengan total event, bukan jumlah IP unik. Gunakan query SQL sendiri jika membutuhkan angka offender yang benar.

Kalau --host tidak dipakai, semua host ikut dirangkum. Berguna saat satu server menjalankan banyak aplikasi dengan app_id berbeda.

shield:rules:list

php spark shield:rules:list

Menampilkan rule yang benar-benar dimuat aplikasi Anda. Perintah ini tidak mencetak ruleVersion; yang tampil adalah ID, category, matcher, severity, skor, immediate-ban, dan state. Tambahkan --disabled untuk ikut menampilkan rule berstatus disabled (jika ada):

php spark shield:rules:list --disabled

Perintah ini berguna untuk memastikan rule pack yang dipilih (rulesPacksInjection, rulesPacksWordpress) benar-benar dimuat.

shield:prune

php spark shield:prune

Menghapus event yang lebih lama dari retentionDays, ban berstatus released yang sudah melewati expires_at, dan semua baris berstatus expired.

Ban active yang sudah lewat waktu tidak dihapus

Perintah ini tidak mengubah ban active yang expires_at-nya sudah lewat. Ban seperti itu tetap tersimpan sampai ada proses yang mengubah statusnya.

Tidak ada scheduler bawaan di CodeIgniter, jadi host Anda yang menjalankan perintah ini secara berkala. Pastikan cron berikut ada:

* * * * * cd /path/ke/aplikasi && php spark shield:prune >> /dev/null 2>&1

Umur retensi bisa diubah per pemanggilan:

php spark shield:prune --days=7

shield:release

php spark shield:release 203.0.113.10

Melepas ban yang sedang aktif untuk satu IP. Tambahkan alasannya supaya tercatat:

php spark shield:release 203.0.113.10 --reason="pelanggan salah ketik"

Per-release tidak mereset offense

Jumlah pelanggaran tidak dihapus. Pelaku yang langsung kembali akan mendapat durasi ban yang lebih panjang. Tidak ada perintah reset offense; lihat Ban & Reputasi untuk konsekuensinya.

shield:replay

php spark shield:replay storage/shield/corpus.json

Menjalankan korpus JSON atau ekspor tabel security_events melalui DefaultRules (dan opsional wordpress), lalu melaporkan tingkat deteksinya. Perintah ini tidak memakai custom rule dari app/Config/Shield.php.

Untuk menguji dengan paket WordPress aktif selama pemutaran:

php spark shield:replay storage/shield/corpus.json --pack-wordpress

Nilai --min-rate bawaannya 0.98, artinya 98 persen entri dengan expected=block harus terdeteksi. Exit code juga menjadi 1 jika ada false positive (entri expected=allow yang justru diblokir). Ini berguna di CI:

php spark shield:replay tests/corpus.json || exit 1

Turunkan --min-rate kalau korpus Anda memang tidak lengkap:

php spark shield:replay tests/corpus.json --min-rate=0.90

Urutan pemakaian yang masuk akal

1. Setelah memasang: shield:health.
2. Mode observe selama beberapa hari: baca shield:report.
3. Sebelum naik ke enforce: shield:rules:list untuk memastikan konfigurasi Anda aktif.
4. Setiap naik versi: shield:replay dengan korpus Anda sendiri.
5. Ada keluhan pengguna terblokir: shield:release.