nsauditor-ai 0.1.71 → 0.1.72
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.md +64 -43
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -17,29 +17,17 @@ NSAuditor AI is the open-source core of a privacy-first security intelligence pl
|
|
|
17
17
|
|
|
18
18
|
## What's New
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
**Latest: CE 0.1.72 + Enterprise 0.11.0** (May 2026)
|
|
21
21
|
|
|
22
|
-
- **
|
|
22
|
+
- 🆕 **PCI DSS v4.0.1** (PCI SSC, June 2024 errata) is now the fourth supported compliance framework in Enterprise — alongside SOC 2, HIPAA, and NIST CSF 2.0. Sub-requirement-level mapping (auditor-canonical for QSA Report on Compliance workflow): 20 covered + 8 partial + 39 OOS across 67 of ~250 sub-requirements (MVP-67). Generate evidence for any combination from a single scan: `--compliance soc2,hipaa,nist-csf,pci-dss` (Enterprise only).
|
|
23
|
+
- 💳 **Defined-vs-Customized Approach discipline per PCI DSS v4.0.1 Appendix E** — 15 Defined-only sub-requirements enforced at schema layer. **Cardholder Data Environment (CDE) scope operator-attested** via CDE Data Flow Diagram per Req 1.2.4 + Req 12.5.1. **Card-brand AOC enforcement priority view** (Visa CISP / Mastercard SDP / Amex DSOP / Discover DISC).
|
|
24
|
+
- ⚡ **NIST Cybersecurity Framework 2.0** (added in EE 0.10.0) — 13 covered + 10 partial + 83 OOS Subcategories across 106 of CSF 2.0's 107 Subcategories.
|
|
25
|
+
- 🏥 **HIPAA Security Rule §164.312** (added in EE 0.9.0) — Zero BAA required; your ePHI never leaves your infrastructure.
|
|
26
|
+
- ☁️ **24 cloud plugins** across AWS, Azure, GCP — fully integrated SOC 2 / HIPAA / NIST CSF 2.0 / PCI DSS v4.0.1 evidence pipeline (Enterprise).
|
|
27
|
+
- 🔬 **Per-Framework Adversarial-Audit Skill Pairing** (NEW institutional pattern) — Enterprise now ships with 8 authored Claude Code skills (Phase-4 Compliance/GRC chain 5-of-5 COMPLETE for shipped frameworks). PCI DSS cycle pairs with NEW `audit-pci-dss-qsa-perspective` skill; same pattern applied retroactively to NIST CSF + forward to ISO 27001 (EE 0.12.0) + CIS Controls v8 (EE 0.13.0).
|
|
23
28
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
- **CE 0.1.68** — paired with **EE 0.8.0** (May 2026). **24 enterprise plugins** across AWS / Azure / GCP, mapped to 10 fully-covered + 4 partial AICPA TSC controls. **MINOR VERSION MILESTONE — EE-RT.23 Move B**: EE plugin 1022 Azure scanner refactored to per-dim source attribution. Each of the 4 helpers now emits findings with its own source: `azure-nsg-auditor` / `azure-rbac-auditor` / `azure-storage-auditor` / `azure-keyvault-auditor`. Closes long-standing blocker (EE 0.6.9 R1-MEDIUM-1) for routing Azure storage findings into Appendix A "Cloud Bucket Exposure Attestation" without commingling NSG / RBAC / Key Vault. **Engine `details.category` projection contract** added (`normalizeFindings` + violation surface; additive, backward-compat). **Key Vault soc2.json gap closure — 13 new mappings** (CC6.1 + CC6.3 + C1.1 + A1.2): pre-0.8.0 Key Vault dim emitted 10 distinct `details.category` values but had ZERO soc2 routing — latent silent false-clean class closed. **Appendix A multi-cloud expansion**: 3 sources (AWS S3 + GCS + Azure Storage); `computeBucketStats` dedup key now provider-qualified (closes cross-cloud bucket-name collision). **7 same-session reviewer folds** (2 R-HIGH + 3 R-MEDIUM + 2 R-LOW; 0 R-CRITICAL). **+23 new tests / +6 new suites**. **EE regression: 5805/5805 across 907 suites; 68-session 100% green streak preserved.** **Plugin count UNCHANGED at 24**; coverage matrix UNCHANGED at 10/4/33 (pure substrate-evidence depth uplift on already-covered controls — but KV gap closure was a silent false-clean class). ⚠️ **Customer migration**: suppressions targeting `match.source: 'azure-cloud-scanner'` silently no-op post-0.8.0 — must be split into per-dim entries (see EE CHANGELOG for migration snippet).
|
|
27
|
-
|
|
28
|
-
- **CE 0.1.67** — paired with **EE 0.7.3** (May 2026). **Critical hotfix** closing 2 production bugs surfaced by EE 0.7.2 dogfood scan: cross-version `google-auth-library` fragmentation broke SA impersonation chains (R-CRITICAL — 100% false-clean impact on free-trial/gmail GCP customers + business GCP customers with no-long-lived-SA-keys policy); `GOOGLE_CLOUD_PROJECT_ID` env-var alias silently skipped (R-MEDIUM). +14 new tests across 2 new suites. EE regression 5782/5782 across 900 suites; 67-session 100% green streak preserved.
|
|
29
|
-
|
|
30
|
-
- **CE 0.1.66** — paired with **EE 0.7.2** (May 2026). **Move B pure-test functional patch** closing the 5 test-coverage gaps deferred at 0.7.1's reviewer pass; +50 new tests across 6 new suites. Bundled staged peerDep `nsauditor-ai` bump (`^0.1.40` → `^0.1.65`). EE regression 5768/5768 across 898 suites.
|
|
31
|
-
|
|
32
|
-
- **CE 0.1.65** — paired with **EE 0.7.1** (May 2026). **EE-RT.22 v2 plugin 1025 R2 expansion** — extended GCP IAM Project-Level Auditor from 3 dims to **7 dims**: + custom-role permission audit (CC6.1) + SA key custody (CC6.1 + C1.1) + SA impersonation graph BFS (CC6.1; mirrors plugin 1030 shadow-admin BFS adapted to GCP) + Organization Policy constraint enumeration (CC6.6 + C1.1). NEW `utils/gcp_auth.mjs` honors `GOOGLE_IMPERSONATE_SERVICE_ACCOUNT` env var. **17 same-session reviewer folds applied — NEW HIGH-WATER MARK** vs 0.7.0's 12. **+22 new soc2.json mappings**. NEW SDK deps: `googleapis` + `@google-cloud/org-policy` in optionalDependencies.
|
|
33
|
-
|
|
34
|
-
- **CE 0.1.64** — paired with **EE 0.7.0** (May 2026). **MINOR-VERSION MILESTONE** opening the v0.7.x cross-cloud-parity line with **NEW plugin 1025 GCP IAM Project-Level Auditor (EE-RT.22 v1)**; 3 audit dimensions (project-scope public-member bindings + sensitive-role inventory + IAM Conditions classifier). Plugin count 23 → 24. 12 same-session reviewer folds (clean pass). 11 new soc2.json mappings.
|
|
35
|
-
|
|
36
|
-
For prior releases, see [CHANGELOG.md](./CHANGELOG.md).
|
|
37
|
-
|
|
38
|
-
### Try Enterprise
|
|
39
|
-
|
|
40
|
-
→ **[See a sample scan walk-through](https://www.nsauditor.com/ai/docs/sample-scan/)** — full EE 0.6.7 output against a fictional Acme Corp AWS account + home-office router. Real engine output, synthetic data, no signup required.
|
|
41
|
-
|
|
42
|
-
→ **[NSAuditor AI Enterprise Edition](https://www.nsauditor.com/ai/enterprise/)** — 24 cloud plugins across AWS / Azure / GCP, signed SOC 2 + HIPAA §164.312 evidence with RFC 3161 timestamps, native Vanta connector (Drata / Secureframe planned), runs entirely inside your infrastructure (zero data exfiltration by architecture; no BAA required for HIPAA — ePHI never leaves customer infrastructure). Pricing from **$2k/yr (5 seats)** to **$10k+/yr (unlimited + custom SLA)**.
|
|
29
|
+
→ Full release history: **[CHANGELOG.md](./CHANGELOG.md)**
|
|
30
|
+
→ See a sample EE scan output: **[walk-through with synthetic Acme Corp AWS account](https://www.nsauditor.com/ai/docs/sample-scan/)** (no signup required)
|
|
43
31
|
|
|
44
32
|
---
|
|
45
33
|
|
|
@@ -61,36 +49,67 @@ Scan → Verify → Prioritize → Track → Act
|
|
|
61
49
|
|
|
62
50
|
## Editions
|
|
63
51
|
|
|
64
|
-
NSAuditor AI is available in three editions:
|
|
52
|
+
NSAuditor AI is available in three editions: Community (free, MIT-licensed, no restrictions), Pro ($49/mo), and Enterprise ($2k+/yr).
|
|
53
|
+
|
|
54
|
+
### Why upgrade to Enterprise?
|
|
55
|
+
|
|
56
|
+
If you're heading into a **SOC 2, HIPAA, NIST CSF 2.0, or PCI DSS audit** — or need to satisfy customer security questionnaires citing those frameworks — Enterprise turns scan output into **auditor-ready evidence packs** that pass institutional scrutiny:
|
|
57
|
+
|
|
58
|
+
- ☁️ **24 cloud plugins** across AWS / Azure / GCP — find the configuration risks an auditor will flag, before they do (CloudTrail integrity, KMS custody, S3 Object Lock, IAM shadow-admin paths, GCP IAM impersonation chains, Azure RBAC sprawl, and more)
|
|
59
|
+
- 📋 **4 compliance frameworks shipped** — generate any combination from a single scan:
|
|
60
|
+
- **SOC 2** (AICPA TSC 2017) — 10 fully-covered + 4 partial controls
|
|
61
|
+
- **HIPAA Security Rule §164.312** — 7 covered + 3 partial Technical Safeguards; **Zero BAA required** (ePHI never leaves your infrastructure)
|
|
62
|
+
- **NIST CSF 2.0 Core** (NIST CSWP 29, Feb 2024) — 13 covered + 10 partial Subcategories across 106 of CSF 2.0's 107 Subcategories; Subcategory-level mapping (auditor-canonical, not high-level Function/Category claims)
|
|
63
|
+
- **PCI DSS v4.0.1** (PCI SSC, June 2024 errata; v3.2.1 retired March 31, 2024) — **20 covered + 8 partial + 39 OOS sub-requirements across 67 of ~250 (MVP-67)**; sub-requirement-level mapping for QSA Report on Compliance workflow; Defined-vs-Customized Approach discipline per Appendix E (15 Defined-only sub-requirements enforced at schema layer); CHD Scope operator-attested via CDE Data Flow Diagram per Req 1.2.4; Card-brand AOC enforcement priority view (Visa CISP / Mastercard SDP / Amex DSOP / Discover DISC)
|
|
64
|
+
- 🔐 **Cryptographically signed evidence** — SHA-256 chain-of-custody + RFC 3161 trusted timestamps + Ed25519 suppression signing. Non-repudiation, not just integrity. Auditors can verify offline.
|
|
65
|
+
- 🏛️ **Zero Data Exfiltration architecture** — your scan data never leaves your infrastructure. Air-gapped deployment supported. AI analysis happens locally (Ollama) or via your own API keys. Important for PCI DSS CDE-isolation threat models.
|
|
66
|
+
- 🔗 **Native GRC platform integration** — push evidence directly to **Vanta** (live; Drata + Secureframe planned). Idempotent retries, per-tenant token rotation, rate-limit handling, signed-envelope round-trip integrity.
|
|
67
|
+
- 🗄️ **WORM evidence storage** — S3 Object Lock COMPLIANCE-mode for SEC Rule 17a-4(f) / FINRA 4511 retention compliance
|
|
68
|
+
- 📊 **SLA / MTTR tracking + recurring-scan attestation** — the **Type II operating-effectiveness evidence** auditors actually demand (not just point-in-time snapshots)
|
|
69
|
+
- 🎯 **8 adversarial-audit Claude Code skills** authored per the NEW Per-Framework Adversarial-Audit Skill Pairing institutional pattern — Phase-4 Compliance/GRC chain 5-of-5 COMPLETE for shipped frameworks (SOC 2 + HIPAA + NIST CSF + PCI DSS + GRC connector)
|
|
70
|
+
|
|
71
|
+
→ **[See sample EE scan output](https://www.nsauditor.com/ai/docs/sample-scan/)** — full evidence pack against synthetic Acme Corp AWS account (no signup required)
|
|
72
|
+
→ **[Buy NSAuditor AI Enterprise Edition](https://www.nsauditor.com/ai/pricing/)** — $2k / $5k / $10k+ per year for 5 / 25 / unlimited seats + custom SLA. Onboarding call included.
|
|
73
|
+
|
|
74
|
+
### Feature comparison
|
|
65
75
|
|
|
66
76
|
| | Community (Free) | Pro ($49/mo) | Enterprise ($2k+/yr) |
|
|
67
77
|
|---|:---:|:---:|:---:|
|
|
68
|
-
|
|
|
69
|
-
|
|
|
70
|
-
|
|
|
71
|
-
|
|
|
72
|
-
|
|
|
73
|
-
|
|
|
74
|
-
|
|
|
75
|
-
| Verified vulnerabilities (safe probes) | — | ✅ | ✅ |
|
|
78
|
+
| **Network scanning** | | | |
|
|
79
|
+
| 27 scanner plugins (SSH, HTTP, TLS, DNS, SMB, RPC, mDNS, etc.) | ✅ | ✅ | ✅ |
|
|
80
|
+
| AI analysis (OpenAI, Claude, Ollama — your keys) | ✅ basic | ✅ enriched | ✅ enriched |
|
|
81
|
+
| Structured findings + SARIF + CSV export | ✅ | ✅ | ✅ |
|
|
82
|
+
| CTEM watch mode | ✅ basic | ✅ advanced | ✅ advanced |
|
|
83
|
+
| **Pro features (vulnerability assessment)** | | | |
|
|
84
|
+
| CVE matching + MITRE ATT&CK mapping | — | ✅ | ✅ |
|
|
85
|
+
| Verified vulnerabilities (safe non-destructive probes) | — | ✅ | ✅ |
|
|
76
86
|
| Risk scoring + prioritization | — | ✅ | ✅ |
|
|
77
|
-
|
|
|
78
|
-
|
|
|
79
|
-
|
|
|
87
|
+
| Parallel analysis agents | — | ✅ | ✅ |
|
|
88
|
+
| **Enterprise — cloud scanning** | | | |
|
|
89
|
+
| 24 cloud plugins (AWS / Azure / GCP) | — | — | ✅ |
|
|
80
90
|
| Zero Trust assessment | — | — | ✅ |
|
|
81
|
-
|
|
|
82
|
-
|
|
|
83
|
-
|
|
|
84
|
-
|
|
|
85
|
-
|
|
|
86
|
-
|
|
|
91
|
+
| **Enterprise — compliance** | | | |
|
|
92
|
+
| SOC 2 (AICPA TSC 2017) — 10 covered + 4 partial controls | — | — | ✅ |
|
|
93
|
+
| HIPAA Security Rule §164.312 — Zero BAA required | — | — | ✅ |
|
|
94
|
+
| NIST CSF 2.0 Core — Subcategory-level mapping | — | — | ✅ |
|
|
95
|
+
| **PCI DSS v4.0.1** — Sub-requirement-level mapping for QSA RoC (NEW) | — | — | ✅ |
|
|
96
|
+
| Multi-framework `--compliance soc2,hipaa,nist-csf,pci-dss` from one scan | — | — | ✅ |
|
|
97
|
+
| **Enterprise — auditor-grade evidence** | | | |
|
|
98
|
+
| Signed evidence packs (SHA-256 + RFC 3161 timestamps) | — | — | ✅ |
|
|
99
|
+
| Ed25519 suppression signing | — | — | ✅ |
|
|
100
|
+
| Chain-of-custody manifests | — | — | ✅ |
|
|
101
|
+
| SLA / MTTR tracking + compensating controls | — | — | ✅ |
|
|
102
|
+
| Recurring-scan attestation (Type II operating-effectiveness) | — | — | ✅ |
|
|
103
|
+
| WORM evidence storage (S3 Object Lock — SEC 17a-4 / FINRA 4511) | — | — | ✅ |
|
|
104
|
+
| **Enterprise — integration + deployment** | | | |
|
|
105
|
+
| GRC platform connector (Vanta live; Drata + Secureframe planned) | — | — | ✅ |
|
|
87
106
|
| Tabletop simulation + SIEM correlation | — | — | ✅ |
|
|
88
107
|
| Docker per-scan isolation | — | — | ✅ |
|
|
89
108
|
| Air-gapped deployment | — | — | ✅ |
|
|
90
109
|
|
|
91
|
-
**This repository is the Community Edition** — fully functional, MIT-licensed, no restrictions. Pro and Enterprise features
|
|
110
|
+
**This repository is the Community Edition** — fully functional, MIT-licensed, no restrictions, no telemetry. Pro and Enterprise features ship via the [`@nsasoft/nsauditor-ai-ee`](https://www.nsauditor.com/ai/pricing) package and install alongside the CE binary once licensed.
|
|
92
111
|
|
|
93
|
-
→ [Get Pro or Enterprise](https://www.nsauditor.com/ai/pricing/)
|
|
112
|
+
→ **[Get Pro or Enterprise →](https://www.nsauditor.com/ai/pricing/)**
|
|
94
113
|
|
|
95
114
|
---
|
|
96
115
|
|
|
@@ -238,7 +257,9 @@ Results land in `./out/<host>_<timestamp>/`:
|
|
|
238
257
|
| 1190 | AWS SES Email Integrity | Enterprise | 6 dimensions: DKIM enablement + CNAME DNS resolution + key-fingerprint pin, DMARC TXT parsing + alignment classifier, custom MailFrom alignment, config-set TLS enforcement, sending-auth policy wildcards, dedicated IP pool, suppression list (count-only — ZDE invariant: never reads addresses). **CC6.1 / CC6.6 / C1.1 / CC7.1 / Privacy** |
|
|
239
258
|
| 1200 | AWS Inspector2 / GuardDuty Enablement | Enterprise | 4 dimensions across all opted-in regions (17+ incl. GovCloud / ISO): GuardDuty Detector + protection features (S3 / EKS / EBS-malware / RDS-login / Lambda / RuntimeMonitoring), Inspector2 enablement, scan-target coverage. Plus alerting-destination dim (EventBridge or SecurityHub) and per-target liveness probes for Lambda / SNS / SQS / IAM / API destination / CloudWatch Logs. **CC7.1 / CC7.2** |
|
|
240
259
|
| — | SOC 2 Compliance Engine | Enterprise | AICPA TSC 2017 mapping (10 covered + 4 partial controls), chain-of-custody, RFC 3161 timestamps, suppression workflow with Ed25519 signing. |
|
|
241
|
-
| — | **HIPAA Compliance Engine (
|
|
260
|
+
| — | **HIPAA Compliance Engine (EE 0.9.0)** | Enterprise | HIPAA Security Rule §164.312 Technical Safeguards mapping (7 covered + 3 partial + 45 OOS within §164.312 + entire §164.308 + entire §164.310). HHS Required/Addressable discipline per control. Same institutional-grade evidence infrastructure as SOC 2 (chain-of-custody, RFC 3161 timestamps, Ed25519 suppression signing). Use `--compliance hipaa` or `--compliance soc2,hipaa` for dual-framework reports from a single scan. **Zero BAA required** — Zero Data Exfiltration architecture means ePHI never leaves customer infrastructure. |
|
|
261
|
+
| — | **NIST CSF 2.0 Compliance Engine (EE 0.10.0)** | Enterprise | NIST Cybersecurity Framework 2.0 Core mapping at the auditor-canonical Subcategory level — 13 covered + 10 partial + 83 OOS across 106 of CSF 2.0's 107 Subcategories. Govern function OOS-by-design (GV.SC-04 partial as substrate exception); Respond function OOS-entirely; Implementation Tiers 1-4 OOS as organizational-maturity claims. NIST SP 800-53 Rev. 5 + CIS Critical Security Controls v8 cross-references baked into `informativeReferences`. Use `--compliance nist-csf` or `--compliance soc2,hipaa,nist-csf` for triple-framework reports from a single scan. |
|
|
262
|
+
| — | **PCI DSS v4.0.1 Compliance Engine (NEW EE 0.11.0)** | Enterprise | PCI DSS v4.0.1 (PCI SSC, June 2024 errata; supersedes v4.0 March 2022; v3.2.1 retired March 31, 2024) mapping at the auditor-canonical sub-requirement level for QSA Report on Compliance workflow — **20 covered + 8 partial + 39 OOS across 67 of ~250 sub-requirements (MVP-67 density)**. Req 12 Information Security Program OOS-by-design entirely. Req 5 anti-malware + Req 9 physical OOS-entirely. **Defined-vs-Customized Approach discipline per Appendix E** — 15 Defined-only sub-requirements enforced at schema layer. **Cardholder Data Environment (CDE) scope operator-attested** via CDE Data Flow Diagram per Req 1.2.4 + Req 12.5.1. **Card-brand AOC enforcement priority view** (Visa CISP / Mastercard SDP / Amex DSOP / Discover DISC). **4 load-bearing schema enrichments** per control: `controlType` + `approachEligibility` + `cloudProviderAttestation` (AWS / Azure / GCP currently-named AOCs) + `cdeScope`. CAO MVP-deferred to EE 0.11.1. Use `--compliance pci-dss` or `--compliance soc2,hipaa,nist-csf,pci-dss` for quad-framework reports from a single scan. |
|
|
242
263
|
| — | SLA & MTTR Tracking | Enterprise | Per-severity SLA targets, compensating-control flow, finding lifecycle, Type II rolling-quarter cadence. |
|
|
243
264
|
| — | Recurring-Scan Attestation | Enterprise | Multi-scan chronological matrix, cadence gap detection, scope-drift surface (CC8.1). |
|
|
244
265
|
| — | GRC Platform Connector | Enterprise | Native API push to Vanta / Drata / Secureframe with retry/backoff, idempotency, rate-limit handling, per-tenant token rotation. |
|
|
@@ -551,7 +572,7 @@ nsauditor-ai --version (or -v, or `version`)
|
|
|
551
572
|
| `--interval <min>` | Rescan interval in minutes (requires `--watch`) | `60` |
|
|
552
573
|
| `--webhook-url <url>` | Webhook URL for delta alerts | — |
|
|
553
574
|
| `--alert-severity <sev>` | Minimum severity for webhook alerts | `high` |
|
|
554
|
-
| `--compliance <fw>` | Compliance framework to map findings into. Accepts CSV for multi-framework runs (e.g. `soc2`, `hipaa`, `soc2,hipaa`). **Enterprise license required.** Supported frameworks as of EE 0.
|
|
575
|
+
| `--compliance <fw>` | Compliance framework to map findings into. Accepts CSV for multi-framework runs (e.g. `soc2`, `hipaa`, `nist-csf`, `pci-dss`, or any combination like `soc2,hipaa,nist-csf,pci-dss`). **Enterprise license required.** Supported frameworks as of EE 0.11.0: `soc2` (AICPA TSC 2017) + `hipaa` (HIPAA Security Rule §164.312 Technical Safeguards) + `nist-csf` (NIST Cybersecurity Framework 2.0 Core, CSWP 29 Feb 2024) + `pci-dss` (PCI DSS v4.0.1, PCI SSC June 2024 errata). See `@nsasoft/nsauditor-ai-ee` README for per-framework coverage details. | — |
|
|
555
576
|
| `--compliance-scope <path>` | Optional JSON file describing the assessment scope (passed to the compliance engine for cover-page attestation) | — |
|
|
556
577
|
| `--help`, `-h` | Print usage block (subcommands, flags, env vars, examples) and exit 0 | — |
|
|
557
578
|
| `--version`, `-v` | Print `nsauditor-ai <version>` and exit 0 | — |
|