muaddib-scanner 2.2.3 → 2.2.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.fr.md +1 -35
- package/README.md +1 -35
- package/bin/muaddib.js +0 -9
- package/package.json +1 -1
package/README.fr.md
CHANGED
|
@@ -327,40 +327,6 @@ muaddib scan . --breakdown
|
|
|
327
327
|
|
|
328
328
|
Affiche la décomposition explicable du score : contribution de chaque finding au score final, avec les poids par règle et multiplicateurs de sévérité.
|
|
329
329
|
|
|
330
|
-
### API Threat Feed
|
|
331
|
-
|
|
332
|
-
```bash
|
|
333
|
-
muaddib feed [--limit N] [--severity LEVEL] [--since DATE]
|
|
334
|
-
muaddib serve [--port N]
|
|
335
|
-
```
|
|
336
|
-
|
|
337
|
-
Exporte les détections sous forme de flux JSON pour intégration SIEM.
|
|
338
|
-
|
|
339
|
-
- `muaddib feed` — Affiche le flux de menaces JSON sur stdout (filtrable par limit, sévérité, date)
|
|
340
|
-
- `muaddib serve` — Démarre un serveur HTTP (port 3000 par défaut) avec `GET /feed` et `GET /health`
|
|
341
|
-
|
|
342
|
-
```bash
|
|
343
|
-
muaddib serve --port 8080
|
|
344
|
-
# GET http://localhost:8080/feed?limit=50&severity=HIGH
|
|
345
|
-
# GET http://localhost:8080/health
|
|
346
|
-
```
|
|
347
|
-
|
|
348
|
-
### Logging des temps de détection
|
|
349
|
-
|
|
350
|
-
```bash
|
|
351
|
-
muaddib detections [--stats] [--json]
|
|
352
|
-
```
|
|
353
|
-
|
|
354
|
-
Historique des détections avec timestamps de première observation et métriques de lead time (délai entre la détection MUAD'DIB et l'advisory publique).
|
|
355
|
-
|
|
356
|
-
### Suivi du taux de faux positifs
|
|
357
|
-
|
|
358
|
-
```bash
|
|
359
|
-
muaddib stats [--daily] [--json]
|
|
360
|
-
```
|
|
361
|
-
|
|
362
|
-
Statistiques de scan : total scanné, clean, suspect, taux de faux positifs, nombre confirmé malveillant. Utilisez `--daily` pour le détail par jour.
|
|
363
|
-
|
|
364
330
|
### Replay ground truth
|
|
365
331
|
|
|
366
332
|
```bash
|
|
@@ -739,7 +705,7 @@ Output (CLI, JSON, HTML, SARIF, Webhook, Threat Feed)
|
|
|
739
705
|
- **ADR** (Adversarial Detection Rate) : taux de detection sur 35 samples malveillants evasifs (4 vagues red team + holdout promu)
|
|
740
706
|
- **Holdout** (pre-tuning) : taux de detection sur 10 samples jamais vus avant correction des regles (mesure de generalisation)
|
|
741
707
|
|
|
742
|
-
|
|
708
|
+
Voir [Evaluation Methodology](docs/EVALUATION_METHODOLOGY.md) pour le protocole experimental complet.
|
|
743
709
|
|
|
744
710
|
---
|
|
745
711
|
|
package/README.md
CHANGED
|
@@ -327,40 +327,6 @@ muaddib scan . --breakdown
|
|
|
327
327
|
|
|
328
328
|
Shows explainable score breakdown: how each finding contributes to the final risk score, with per-rule weights and severity multipliers.
|
|
329
329
|
|
|
330
|
-
### Threat Feed API
|
|
331
|
-
|
|
332
|
-
```bash
|
|
333
|
-
muaddib feed [--limit N] [--severity LEVEL] [--since DATE]
|
|
334
|
-
muaddib serve [--port N]
|
|
335
|
-
```
|
|
336
|
-
|
|
337
|
-
Export detections as a JSON threat feed for SIEM integration.
|
|
338
|
-
|
|
339
|
-
- `muaddib feed` — Output threat feed JSON to stdout (filterable by limit, severity, date)
|
|
340
|
-
- `muaddib serve` — Start an HTTP server (default port 3000) with `GET /feed` and `GET /health` endpoints
|
|
341
|
-
|
|
342
|
-
```bash
|
|
343
|
-
muaddib serve --port 8080
|
|
344
|
-
# GET http://localhost:8080/feed?limit=50&severity=HIGH
|
|
345
|
-
# GET http://localhost:8080/health
|
|
346
|
-
```
|
|
347
|
-
|
|
348
|
-
### Detection time logging
|
|
349
|
-
|
|
350
|
-
```bash
|
|
351
|
-
muaddib detections [--stats] [--json]
|
|
352
|
-
```
|
|
353
|
-
|
|
354
|
-
View detection history with first-seen timestamps and lead time metrics (time between MUAD'DIB detection and public advisory).
|
|
355
|
-
|
|
356
|
-
### FP rate tracking
|
|
357
|
-
|
|
358
|
-
```bash
|
|
359
|
-
muaddib stats [--daily] [--json]
|
|
360
|
-
```
|
|
361
|
-
|
|
362
|
-
View scan statistics: total scanned, clean, suspect, false positive rate, confirmed malicious count. Use `--daily` for per-day breakdown.
|
|
363
|
-
|
|
364
330
|
### Ground truth replay
|
|
365
331
|
|
|
366
332
|
```bash
|
|
@@ -742,7 +708,7 @@ Output (CLI, JSON, HTML, SARIF, Webhook, Threat Feed)
|
|
|
742
708
|
- **ADR** (Adversarial Detection Rate): detection rate on 35 evasive malicious samples across 4 red-team waves + promoted holdout
|
|
743
709
|
- **Holdout** (pre-tuning): detection rate on 10 unseen samples before any rule correction (measures generalization)
|
|
744
710
|
|
|
745
|
-
|
|
711
|
+
See [Evaluation Methodology](docs/EVALUATION_METHODOLOGY.md) for the full experimental protocol.
|
|
746
712
|
|
|
747
713
|
---
|
|
748
714
|
|
package/bin/muaddib.js
CHANGED
|
@@ -363,15 +363,6 @@ const helpText = `
|
|
|
363
363
|
muaddib scrape Scrape new IOCs
|
|
364
364
|
muaddib sandbox <pkg> [--strict] [--no-canary] Analyze in isolated Docker container
|
|
365
365
|
muaddib sandbox-report <pkg> Sandbox + detailed network report
|
|
366
|
-
muaddib feed [options] Threat feed (JSON)
|
|
367
|
-
muaddib serve [options] Start threat feed HTTP server
|
|
368
|
-
muaddib detections List recent detections
|
|
369
|
-
muaddib detections --stats Show aggregated detection stats
|
|
370
|
-
muaddib detections --json Raw JSON output
|
|
371
|
-
muaddib stats Show scan stats + FP rate
|
|
372
|
-
muaddib stats --daily Last 7 days daily breakdown
|
|
373
|
-
muaddib stats --json Raw JSON dump
|
|
374
|
-
muaddib evaluate Evaluate scanner effectiveness (TPR, FPR, ADR)
|
|
375
366
|
muaddib version Show version
|
|
376
367
|
|
|
377
368
|
Replay Options:
|