Files
CV_Site_Nuxt/OKF_Nuxt/decisions/vulnerability-audit-policy.md
T
Noel Sabia f32ad07648
PR Check / Security scan (Snyk) (pull_request) Skipped
PR Check / ESLint (pull_request) Canceled after 28s
PR Check / Typecheck (pull_request) Canceled after 0s
PR Check / Secret scan (gitleaks) (pull_request) Canceled after 0s
PR Check / Dependency audit (pull_request) Canceled after 0s
PR Check / Dockerfile lint (droast) (pull_request) Canceled after 0s
PR Check / AI code review (opencode) (pull_request) Canceled after 0s
fix: unblock the release PR - real production image, reviewed audit ignores
The release PR (chore: release main) failed two checks, both verified
locally before pushing:

- droast: the empty production Dockerfile failed DF071 (no
  instructions). The new Dockerfile is a runnable Node server (SSR):
  multi-stage, manifests-first layers, digest-pinned node:26-slim (same
  digest as the dev container), non-root uid 1000, node-fetch
  HEALTHCHECK. Measured: docker build succeeds in-image, container
  serves HTTP 200 and reports healthy; droast reports 0 errors.
- audit: two high advisories with NO patched release anywhere
  (node-forge <=1.4.0 and braces <=3.0.3 are the newest npm versions;
  both build-time-only paths under nitropack). Recorded as
  auditConfig.ignoreGhsas in pnpm-workspace.yaml with the reason and
  removal condition - the audit output still names what it skipped.
  pnpm 11 ignores the pnpm field in package.json (caught locally via
  the WARN before pushing); settings live in pnpm-workspace.yaml.

OKF_Nuxt: recorded the production-image and audit-policy decisions,
updated log, indexes and open questions.
2026-10-18 21:14:12 +02:00

59 lines
2.4 KiB
Markdown

---
type: Decision
title: Vulnerability audit policy
description: The dependency audit blocks the pipeline, with an explicit reviewed ignore-list for advisories that have no patched release - the list lives in pnpm-workspace.yaml, because pnpm 11 no longer reads the pnpm field in package.json.
tags: [decision, security, ci, audit, pnpm]
status: draft
generated: { by: opencode-go/glm-5.3-flash, at: 2026-10-18T19:10:00Z }
verified: { by: human:noel, at: not yet }
sources:
- id: workspace
resource: pnpm-workspace.yaml
title: auditConfig.ignoreGhsas
- id: audit-job
resource: .gitea/workflows/pr-checker.yml
title: Dependency audit job
---
# Decision
`pnpm audit --prod --audit-level moderate` stays **blocking** (no
`continue-on-error`). Advisories that cannot be fixed by upgrading are not
silenced but **reviewed and recorded**: `auditConfig.ignoreGhsas` in
`pnpm-workspace.yaml`, each entry with the date and reason, removed when a
patched version ships.
Currently ignored (both verified against the advisory database and the npm
registries on 2026-10-18 - the newest published versions are the vulnerable
ones):
* `GHSA-86w9-cpqp-85rv` - node-forge <= 1.4.0, high. Path:
`nuxt > @nuxt/nitro-server > nitropack > listhen > node-forge` - listhen
generates dev certificates; build/dev-time only, not in the server bundle.
* `GHSA-vfj7-8cjw-p6xm` - braces <= 3.0.3, high. Path:
`nitropack > globby > micromatch > braces` - globbing during build, no
attacker-controlled patterns at runtime.
# Why
A red job that can never go green trains everyone to ignore red - the same
silent-failure outcome "nothing fails silently" exists to prevent. The
ignore list is the opposite of silence: the audit still names what it
skipped ("2 ignored: 2 high") and the decision lives in a reviewable file.
# The pnpm 11 lesson
The first attempt put `auditConfig` under the `pnpm` field in
`package.json`. pnpm 11 warned and **ignored it** - settings moved to
`pnpm-workspace.yaml` (same reason the config-only workspace file needed
pnpm 11 in the first place). The warning was caught locally before pushing
by running the exact CI command.
# Revisit when
* A patched version ships for either package - remove the entry.
* A new advisory appears with a real patch - fix it by upgrading; the audit
gate does the enforcement.
* Snyk is re-enabled (its SAST/DAST scope is different; see
[snyk-paused-and-secrets-policy](snyk-paused-and-secrets-policy.md)).