software-supply-chain-failures

Expert guidance on detecting, assessing, and remediating Software Supply Chain Failures (OWASP A03:2025) in Python applications — the highest-exploit-score category in the 2025 OWASP Top 10. Use this skill whenever the user mentions dependency scanning, vulnerable packages, SBOMs, pip-audit, safety check, lockfile integrity, hash pinning, transitive dependencies, CI/CD pipeline security, compromised packages, supply chain attacks (SolarWinds, Log4Shell, typosquatting), or requests a security review of requirements.txt / pyproject.toml. Also trigger for any question about CWE-1104, CWE-1395, or CWE-1329.

Software Supply Chain Failures — OWASP A03:2025

Overview

A03:2025 is the #1 community-voted concern and the highest-risk category by exploit score in the entire OWASP Top 10:2025, despite having only 6 CWEs and limited test data:

MetricValue
OWASP Rank#3 (new — expands A06:2021 "Vulnerable & Outdated Components")
Average Incidence5.72%
Avg Exploit Score8.17 (highest of any category)
Avg Impact Score5.23 (highest of any category)
Key CWEsCWE-1104, CWE-1395, CWE-1329

Key CWEs:

  • CWE-1104 — Use of Unmaintained Third-Party Components
  • CWE-1395 — Dependency on Vulnerable Third-Party Component
  • CWE-1329 — Reliance on Component That is Not Updateable

What This Category Covers

Supply chain failures span the full lifecycle — from sourcing packages to building, distributing, and deploying them:

  1. Untracked / unmonitored dependencies — direct and transitive
  2. Vulnerable or unsupported components — unpatched known CVEs
  3. Absence of SBOM management — no Software Bill of Materials
  4. Unhardened CI/CD pipelines — no separation of duty, unsigned builds
  5. Untrusted or typosquatted package sources
  6. Delayed or absent patching cadence
  7. Build system compromise (e.g. SolarWinds 2019, Log4Shell 2021, npm worms)

Python-specific surface: Flask alone pulls 7+ transitive packages (Jinja2, Werkzeug, MarkupSafe, itsdangerous, click, blinker, packaging). FastAPI pulls Starlette + Pydantic + their dependencies. Every transitive package is an attack surface.


Detecting Vulnerabilities — Tool Runbook

1. pip-audit (recommended — scans against OSV + PyPI Advisory DB)

# Install
pip install pip-audit

# Scan current environment
pip-audit

# Scan a requirements file
pip-audit -r requirements.txt

# Output JSON for CI
pip-audit -r requirements.txt -f json -o audit-results.json

# Fix automatically where possible
pip-audit --fix

2. safety (scans against Safety DB / PyUp)

pip install safety

# Basic scan
safety check

# Scan requirements file
safety check -r requirements.txt

# Full JSON output
safety check --json

3. osv-scanner (Google OSV — broadest database)

# Install via Go or download binary
go install github.com/google/osv-scanner/cmd/osv-scanner@latest

# Scan a project directory
osv-scanner --lockfile=requirements.txt .

4. Trivy (containers + filesystem)

# Scan Python project
trivy fs --scanners vuln .

# Scan a Docker image
trivy image myapp:latest

CI/CD Integration: Run pip-audit + safety on every PR. Fail the build on HIGH/CRITICAL severity findings. See references/ci-cd-templates.md for GitHub Actions and GitLab CI examples.


Generating & Managing SBOMs

An SBOM (Software Bill of Materials) is now a compliance requirement (US Executive Order 14028) and an operational necessity.

Using cyclonedx-py

pip install cyclonedx-bom

# Generate CycloneDX SBOM from current environment
cyclonedx-py environment -o sbom.json --format json

# From a requirements file
cyclonedx-py requirements requirements.txt -o sbom.json --format json

# From poetry
cyclonedx-py poetry -o sbom.json

Using pip-licenses for license compliance

pip install pip-licenses
pip-licenses --format=json --output-file=licenses.json

SBOM should include:

  • Package name + version + hashes
  • License identifiers
  • Known vulnerabilities at time of generation
  • Transitive dependency tree

Hash Pinning & Lockfiles

Hash Pinning in requirements.txt

# BAD — unpinned, vulnerable to substitution attacks
flask==3.0.0

# GOOD — hash-pinned, tamper-evident
flask==3.0.0 \
    --hash=sha256:34a14a9e9ea... \
    --hash=sha256:a9b5cf1a...

Generate hash-pinned requirements:

pip install pip-tools
pip-compile --generate-hashes requirements.in -o requirements.txt

Lockfiles (preferred for applications)

ToolLockfileCommand
Poetrypoetry.lockpoetry install --no-root
uvuv.lockuv sync
pip-toolsrequirements.txt (compiled)pip-sync requirements.txt
PipenvPipfile.lockpipenv install --ignore-pipfile

Critical checks:

  • Lockfile is committed to source control
  • CI installs from lockfile, not loose requirements.txt
  • Lockfile is regenerated on a schedule (weekly minimum)
  • Dependabot / Renovate Bot is configured for automated PRs

Transitive Dependency Auditing

Visualize the full dependency tree

pip install pipdeptree
pipdeptree --json-tree > deptree.json

# Find who requires a specific package
pipdeptree --reverse --packages flask

Check for known malicious packages

# guarddog — detects malicious behavior in packages
pip install guarddog
guarddog pypi scan flask
guarddog pypi verify flask 3.0.0

Flag dangerous import patterns in source code

# Bandit catches these automatically:
import sys
sys.path.insert(0, '/untrusted/path')  # CWE-426: Untrusted Search Path
sys.path.append('/local/unverified')   # Same risk
bandit -r . -t B322,B323,B411  # sys.path manipulation checks

CI/CD Pipeline Hardening

Unhardened pipelines are a primary supply chain vector (SolarWinds attack model).

Minimum pipeline security requirements

ControlImplementation
MFA on pipeline authRequire OIDC tokens, not static secrets
Signed buildssigstore / cosign for container images
Tamper-evident logsImmutable audit logs (e.g. Rekor)
Dependency pinningPin action versions by SHA, not tag
Least-privilegeSeparate read/write tokens per stage
Staged rolloutsCanary deploy before full rollout

GitHub Actions — pin by commit SHA

# BAD — tag can be moved by attacker
- uses: actions/checkout@v4

# GOOD — immutable SHA
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683

SLSA Framework compliance levels

  • SLSA Level 1: Build process documented, basic provenance
  • SLSA Level 2: Build service generates signed provenance
  • SLSA Level 3: Hardened build platform, non-falsifiable provenance
# Generate SLSA provenance with slsa-verifier
pip install slsa-verifier
slsa-verifier verify-artifact mypackage.tar.gz \
  --provenance-path provenance.json \
  --source-uri github.com/myorg/myrepo

FastAPI & Flask — Specific Testing Targets

Dependency files to audit

FrameworkDirect depsKey transitives to monitor
Flaskflask, flask-login, flask-wtf, sqlalchemyJinja2, Werkzeug, MarkupSafe, itsdangerous
FastAPIfastapi, uvicorn, sqlalchemy, pydanticStarlette, anyio, httpx, h11

Static analysis with Bandit

pip install bandit

# Full scan with supply-chain relevant rules
bandit -r . -t B301,B302,B303,B324,B411,B412 --format json -o bandit-report.json

Key Bandit rules for supply chain:

  • B301pickle usage (deserialization risk)
  • B302marshal (similar risk)
  • B411xmlrpc imports
  • B412httpoxy detection

Check for typosquatted / suspicious packages

# Use pip-audit with strict mode
pip-audit --strict -r requirements.txt

# guarddog behavior analysis
guarddog pypi scan <package>

Remediation Priority Matrix

FindingSeverityAction
CVE with CVSS ≥ 9.0 in direct depCriticalPatch immediately, block deploy
CVE with CVSS 7.0–8.9 in direct depHighPatch within 48h
CVE in transitive dep onlyMediumPatch within 2 weeks
Unpinned dependencyMediumAdd to lockfile in next sprint
No SBOMMediumGenerate and automate in CI
Missing --hash on requirementsLowMigrate to lockfile tool
Outdated lockfile (>30 days)LowRegenerate + review changes
No automated dep update botLowEnable Dependabot/Renovate

Quick-Start Checklist

[ ] pip-audit and safety check passing in CI (no HIGH/CRITICAL)
[ ] All dependencies pinned in lockfile (poetry.lock / uv.lock)
[ ] Lockfile committed to source control and used in CI installs
[ ] SBOM generated (cyclonedx-py) and stored as CI artifact
[ ] Dependabot or Renovate Bot enabled on repository
[ ] GitHub Actions pinned by commit SHA
[ ] No sys.path.insert() / sys.path.append() on unverified paths
[ ] SLSA Level 2+ for published packages
[ ] Weekly lockfile refresh scheduled

Reference Files

  • references/ci-cd-templates.md — GitHub Actions + GitLab CI pipeline templates with pip-audit, safety, SBOM generation, and SLSA provenance steps
  • references/cwe-mapping.md — Full CWE-to-detection-tool mapping for audit reporting