Proyecto: {{PROJECT_NAME}} · Clase SaMD: {{SAMD_CLASS}} · Versión: vX.Y · Fecha: YYYY-MM-DD
SBOM Management Plan¶
Plan de generación, almacenamiento y revisión del Software Bill of Materials (SBOM) del producto {{PROJECT_NAME}} (SaMD {{SAMD_CLASS}}). Uso previsto del producto: {{INTENDED_USE}}. Responsable del plan: {{OWNER}}.
1. Propósito¶
Establecer el procedimiento formal para producir, almacenar, auditar y comunicar el SBOM del producto. El SBOM es evidencia regulatoria obligatoria:
- IEC 62304 §8 (gestión de software de mantenimiento) + §5.1.4 define
SOUP (Software of Unknown Provenance)y obliga a documentar cada componente de terceros individualmente. - IEC 81001-5-1 §4.1.5 exige inventario completo de componentes y trazabilidad de cambios para todo software médico.
- FDA Cybersecurity in Medical Devices Guidance (Sep 2023) §V.B requiere el SBOM en submissions premarket (510(k), De Novo, PMA).
- EU Cyber Resilience Act (CRA) lo impone como entregable de cadena de suministro de software con productos digitales en el mercado europeo.
- US Executive Order 14028 y NTIA Minimum Elements for an SBOM (2021) fijan el contenido mínimo (suppliers, componentes, versiones, relaciones).
2. Alcance¶
Cubre todo software que se ejecuta dentro del producto final:
- Backend ({{BACKEND_STACK}}): dependencias Python declaradas en
requirements.txt+ el grafo transitivo real instalado en el venv. - Frontend ({{FRONTEND_STACK}}): dependencias de runtime en
frontend/package-lock.json(se omitedevpor defecto). - Infraestructura de despliegue ({{CLOUD_STACK}}): imágenes base de contenedor y dependencias de sistema se inventarían vía el escaneo SCA (Trivy) y se referencian, no se duplican, en este SBOM de aplicación.
Fuera de alcance: tooling de desarrollo no embarcado (linters, mutation
testing) salvo que se solicite un SBOM -with-dev.
3. Formato y herramientas¶
| Capa | Herramienta | Formato | Comando |
|---|---|---|---|
| Python | cyclonedx-py environment |
CycloneDX 1.5 JSON | scripts/generate_sbom.sh --backend |
| Node | @cyclonedx/cyclonedx-npm |
CycloneDX 1.5 JSON | scripts/generate_sbom.sh --frontend |
CycloneDX 1.5 JSON es el formato canónico (legible por máquina, soportado por los principales escáneres de CVE y aceptado por FDA/CRA). El script produce además un resumen Markdown legible por humanos.
4. Procedimiento de generación¶
- Local:
bash scripts/generate_sbom.sh(requiere venv + lockfile del frontend íntegro). Salida asbom/con archivos fechados + punteros establessbom-latest-{backend,frontend}.json.
⚠️ NO generes el SBOM desde tu venv de desarrollo. El script enumera el
entorno real (cyclonedx-py environment), así que todo lo que tengas
instalado para trabajar —el generador de docs, el motor de tests, el
type-checker, el linter— entra al SBOM como si fuera dependencia del
dispositivo. Medido en este repo: 96 componentes desde el venv de
desarrollo contra 56 desde uno limpio — 40 paquetes que inflaban la
superficie declarada y habrían mandado a revisar CVEs de herramientas que el
producto no embarca. Usá un venv limpio con solo requirements.txt y
apuntá el script ahí:
python3 -m venv /tmp/venv-sbom
source /tmp/venv-sbom/bin/activate
pip install -r requirements.txt && pip install cyclonedx-bom
deactivate
VENV_DIR=/tmp/venv-sbom bash scripts/generate_sbom.sh
El workflow de CI ya lo hace bien (crea un virtualenv desde cero); la trampa
es exclusiva del camino local. cyclonedx-bom está en requirements-dev.txt
para que el procedimiento funcione en un clone nuevo.
2. CI: el workflow .github/workflows/sbom.yml regenera el SBOM ante
cualquier cambio de lockfiles (paths-filter) + cron semanal de detección de
drift. Falla si el SBOM sale vacío (guard de 0 componentes).
3. Reproducibilidad: npm ci (no npm install) y --output-reproducible
garantizan que el mismo lockfile produzca el mismo SBOM.
5. Almacenamiento y versionado por release¶
- El SBOM se versiona en Git dentro de
sbom/→ snapshot permanente y auditable (la retención larga regulatoria NO depende de artifacts de CI). - En cada release se etiqueta el SBOM con la versión del producto y se archiva junto al registro de release (IEC 62304 §5.7.4 / §8 release records).
- Los artifacts de CI son copias de conveniencia con retención de 30 días.
6. Revisión y respuesta a vulnerabilidades¶
- Cada SBOM nuevo se cruza con feeds de CVE: Trivy (imágenes + deps),
pip-audit,npm audity Dependabot. - Todo hallazgo HIGH/CRITICAL se registra en
ISO_14971_RISK_MATRIX.mdcon plazo de remediación y propietario. - El diff SBOM-vs-baseline (componentes añadidos/removidos/cambiados) se adjunta al PR que toca dependencias → trazabilidad de cambios de SOUP.
7. Roles y cadencia¶
| Actividad | Responsable | Cadencia |
|---|---|---|
| Generación automática | CI (sbom.yml) |
Por cambio de deps + semanal |
| Revisión de CVEs | {{OWNER}} / security | Semanal + ante cada release |
| Archivado por release | {{OWNER}} | Cada release |
| Auditoría del plan | {{OWNER}} / QA regulatorio | Anual o ante cambio normativo |
Navegación: Índice del DHF · Master Map