fix(docs-portal): remediar CVE CRITICAL en libssl3/libcrypto3 (Alpine)

Run 144 de deploy-docs.yaml encontro un CVE CRITICAL real
(CVE-2026-31789, heap buffer overflow en OpenSSL) en libssl3/libcrypto3
de la base nginx:1.27-alpine, con fix ya publicado por Alpine
(3.3.3-r0 -> 3.3.7-r0). Se agrega apk upgrade puntual de esos dos
paquetes en el Dockerfile. Verificado localmente: docker build OK +
Trivy real en exit 0 (0 vulnerabilidades).

.gitea/workflows/build-medusa.yaml

@@ -1,5 +1,15 @@
 name: Build and Push Medusa
 
+# Retrigger: el run 107 (con la remediacion de CVEs ya mergeada) fue
+# cancelado a mitad de camino porque el stack de Gitea (gitea +
+# gitea-runner) se reinicio solo durante el build -- no por el
+# contenido del pipeline. Ver hallazgo de contencion de recursos en
+# docs/playbooks.
+
+# Sin anchors/aliases de YAML (&x / *x) a propósito -- el parser de
+# workflows de Gitea Actions no los resuelve en el bloque "on:" y
+# descarta el archivo completo con "unknown on type". Las dos listas de
+# paths quedan duplicadas literalmente (mismo criterio que build.yaml).
 on:
   push:
     branches:
@@ -7,17 +17,76 @@ on:
     paths:
       - 'workloads/commerce-backend/**'
       - '.gitea/workflows/build-medusa.yaml'
+  pull_request:
+    branches:
+      - main
+    paths:
+      - 'workloads/commerce-backend/**'
+      - '.gitea/workflows/build-medusa.yaml'
 
 permissions:
   contents: write
   packages: write
 
 jobs:
+  # Corre en push y en pull_request, siempre antes que build. Mismo
+  # criterio que el frontend: si hay un secreto commiteado, el job build
+  # nunca arranca (needs: gitleaks).
+  gitleaks:
+    name: Escaneo de Secretos (Gitleaks)
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - name: Checkout del código
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 1
+
+      - name: Instalar Gitleaks
+        shell: bash
+        run: |
+          set -euo pipefail
+          GITLEAKS_VERSION="8.21.2"
+          curl -sSfL \
+            "https://github.com/gitleaks/gitleaks/releases/download/v${GITLEAKS_VERSION}/gitleaks_${GITLEAKS_VERSION}_linux_x64.tar.gz" \
+            -o /tmp/gitleaks.tar.gz
+          tar -xzf /tmp/gitleaks.tar.gz -C /tmp gitleaks
+          chmod +x /tmp/gitleaks
+          /tmp/gitleaks version
+
+      - name: Escanear secretos en el árbol de archivos
+        shell: bash
+        run: |
+          set -euo pipefail
+          /tmp/gitleaks detect \
+            --source=workloads/commerce-backend \
+            --no-git \
+            --redact \
+            --report-format=json \
+            --report-path=gitleaks-report.json \
+            --exit-code=1
+
+      - name: Publicar reporte de Gitleaks
+        if: always()
+        uses: actions/upload-artifact@v3
+        with:
+          name: gitleaks-report
+          path: gitleaks-report.json
+          if-no-files-found: ignore
+
   build:
     name: Construir y publicar Medusa
+    needs: gitleaks
+    if: github.event_name == 'push'
     runs-on: ubuntu-latest
     timeout-minutes: 45
 
+    env:
+      APP_DIR: workloads/commerce-backend
+      MANIFEST_FILE: workloads/ecommerce/commerce/medusa.yaml
+      IMAGE_NAME: gitea.cruzcloud.net/devops/ecommerce-medusa
+
     steps:
       - name: Checkout del código
         uses: actions/checkout@v3
@@ -48,6 +117,82 @@ jobs:
             exit 1
           }
 
+      - name: Instalar Trivy
+        shell: bash
+        run: |
+          set -euo pipefail
+          TRIVY_VERSION="0.74.0"
+          curl -sSfL \
+            "https://github.com/aquasecurity/trivy/releases/download/v${TRIVY_VERSION}/trivy_${TRIVY_VERSION}_Linux-64bit.tar.gz" \
+            -o /tmp/trivy.tar.gz
+          tar -xzf /tmp/trivy.tar.gz -C /tmp trivy
+          chmod +x /tmp/trivy
+          /tmp/trivy version
+
+      # Escanea el manifiesto Kubernetes real de Medusa (no la imagen).
+      # Informativo por ahora -- mismo criterio que el frontend, se
+      # revisan los hallazgos en conjunto antes de decidir qué bloquea.
+      - name: Escanear manifiestos Kubernetes (Trivy IaC)
+        shell: bash
+        run: |
+          set -euo pipefail
+          /tmp/trivy config \
+            --severity CRITICAL,HIGH,MEDIUM \
+            --exit-code 0 \
+            "${MANIFEST_FILE}"
+
+      # Mismo motivo que en build.yaml: el runner ejecuta el job ya
+      # dentro de un contenedor propio que habla con el daemon Docker
+      # del host (sibling containers, no Docker-in-Docker) -- correr
+      # Semgrep como container aparte falla montando rutas que no
+      # existen en el host real. Se instala nativo en un venv.
+      - name: Instalar Semgrep
+        shell: bash
+        run: |
+          set -euo pipefail
+          python3 -m venv /tmp/semgrep-venv
+          /tmp/semgrep-venv/bin/pip install --quiet "semgrep==1.173.0"
+          /tmp/semgrep-venv/bin/semgrep --version
+
+      # Ruleset adaptado al stack real de este repo: commerce-backend es
+      # una API de Medusa v2 (Node.js/TypeScript sobre Express), no una
+      # app Next.js con SSR -- confirmado en package.json (sin
+      # dependencia de "next", react/react-dom solo llegan como
+      # dependencia transitiva del admin-sdk de Medusa, no hay código de
+      # UI propio en este directorio). Por eso se usa p/typescript en
+      # vez de p/typescript + p/react + p/nextjs del frontend.
+      # Modo auditoría, igual que el frontend: sin --error, primera
+      # vuelta para revisar hallazgos antes de decidir qué bloquea.
+      - name: Escaneo SAST (Semgrep) — modo auditoría, no bloquea
+        shell: bash
+        run: |
+          set -euo pipefail
+          /tmp/semgrep-venv/bin/semgrep scan \
+            --config=p/typescript \
+            --config=p/security-audit \
+            --config=p/owasp-top-ten \
+            --json \
+            --output=semgrep-report.json \
+            "${APP_DIR}"
+
+          echo "=== Resumen Semgrep ==="
+          /tmp/semgrep-venv/bin/python -c "
+          import json
+          data = json.load(open('semgrep-report.json'))
+          results = data.get('results', [])
+          print(f'Hallazgos: {len(results)}')
+          for r in results:
+              print(f\"  [{r['extra']['severity']}] {r['check_id']} - {r['path']}:{r['start']['line']}\")
+          "
+
+      - name: Publicar reporte de Semgrep
+        if: always()
+        uses: actions/upload-artifact@v3
+        with:
+          name: semgrep-report
+          path: semgrep-report.json
+          if-no-files-found: ignore
+
       - name: Login en Gitea Registry
         uses: docker/login-action@v2
         with:
@@ -56,15 +201,138 @@ jobs:
           password: ${{ secrets.REGISTRY_PASSWORD }}
           logout: true
 
-      - name: Construir y subir imagen
+      # push: false — igual que el frontend, la imagen se queda cargada
+      # en el daemon local para poder escanearla con Trivy antes de
+      # subirla al registry.
+      - name: Construir Imagen
         uses: docker/build-push-action@v4
         with:
-          context: workloads/commerce-backend/
-          file: workloads/commerce-backend/Dockerfile
-          push: true
+          context: ${{ env.APP_DIR }}/
+          file: ${{ env.APP_DIR }}/Dockerfile
+          push: false
+          load: true
           tags: |
-            gitea.cruzcloud.net/devops/ecommerce-medusa:${{ steps.vars.outputs.VERSION }}
-            gitea.cruzcloud.net/devops/ecommerce-medusa:latest
+            ${{ env.IMAGE_NAME }}:${{ steps.vars.outputs.VERSION }}
+            ${{ env.IMAGE_NAME }}:latest
+
+      # CRITICAL bloquea el pipeline: no se sube una imagen con una CVE
+      # crítica conocida y con fix disponible.
+      # --timeout 15m0s: el default de Trivy (5m) no alcanza para esta
+      # imagen -- a diferencia del frontend, commerce-backend arrastra
+      # el node_modules completo de Medusa v2 (framework + admin-sdk +
+      # cli), muchos más archivos que escanear tanto para vulnerabilidades
+      # como para el escaneo de secretos que Trivy corre por default
+      # dentro de la imagen. Visto en vivo: "context deadline exceeded"
+      # a los 4m52s con el timeout default, en un run donde el host
+      # venía de terminar el docker build (ver hallazgo de rendimiento
+      # de Gitea/runner en docs/playbooks).
+      # --ignorefile: excepciones puntuales y documentadas (ver
+      # workloads/commerce-backend/.trivyignore) para CVEs sin fix de
+      # bajo riesgo disponible hoy. No debilita el gate en general --
+      # cualquier otra CRITICAL sigue bloqueando igual.
+      - name: Escanear imagen (Trivy) — CRITICAL bloquea
+        shell: bash
+        run: |
+          set -euo pipefail
+          /tmp/trivy image \
+            --severity CRITICAL \
+            --exit-code 1 \
+            --ignore-unfixed \
+            --timeout 15m0s \
+            --ignorefile "${APP_DIR}/.trivyignore" \
+            "${IMAGE_NAME}:${{ steps.vars.outputs.VERSION }}"
+
+      # HIGH solo informa por ahora — mismo criterio que el frontend.
+      - name: Escanear imagen (Trivy) — HIGH informativo
+        shell: bash
+        run: |
+          set -euo pipefail
+          /tmp/trivy image \
+            --severity HIGH \
+            --exit-code 0 \
+            --ignore-unfixed \
+            --timeout 15m0s \
+            "${IMAGE_NAME}:${{ steps.vars.outputs.VERSION }}"
+
+      - name: Instalar Syft
+        shell: bash
+        run: |
+          set -euo pipefail
+          SYFT_VERSION="1.51.0"
+          curl -sSfL \
+            "https://github.com/anchore/syft/releases/download/v${SYFT_VERSION}/syft_${SYFT_VERSION}_linux_amd64.tar.gz" \
+            -o /tmp/syft.tar.gz
+          tar -xzf /tmp/syft.tar.gz -C /tmp syft
+          chmod +x /tmp/syft
+          /tmp/syft version
+
+      - name: Generar SBOM (Syft)
+        shell: bash
+        run: |
+          set -euo pipefail
+          /tmp/syft "${IMAGE_NAME}:${{ steps.vars.outputs.VERSION }}" \
+            -o cyclonedx-json=sbom.cdx.json \
+            -o spdx-json=sbom.spdx.json
+
+      - name: Publicar SBOM
+        if: always()
+        uses: actions/upload-artifact@v3
+        with:
+          name: sbom-${{ steps.vars.outputs.VERSION }}
+          path: |
+            sbom.cdx.json
+            sbom.spdx.json
+          if-no-files-found: ignore
+
+      # Login ya se hizo arriba; recién acá se sube, después de que la
+      # imagen pasó el gate de CRITICAL.
+      - name: Subir Imagen al Registry
+        shell: bash
+        run: |
+          set -euo pipefail
+          docker push "${IMAGE_NAME}:${{ steps.vars.outputs.VERSION }}"
+          docker push "${IMAGE_NAME}:latest"
+
+      - name: Instalar Cosign
+        shell: bash
+        run: |
+          set -euo pipefail
+          COSIGN_VERSION="3.1.3"
+          curl -sSfL \
+            "https://github.com/sigstore/cosign/releases/download/v${COSIGN_VERSION}/cosign-linux-amd64" \
+            -o /tmp/cosign
+          chmod +x /tmp/cosign
+          /tmp/cosign version
+
+      # Mismo par de llaves que el frontend (COSIGN_PRIVATE_KEY /
+      # COSIGN_PASSWORD ya existen como secrets a nivel de repo, no hace
+      # falta un secret nuevo por app): una sola identidad de firma para
+      # todo el registry de este lab. La llave pública se commitea en
+      # cada directorio de app (workloads/commerce-backend/cosign.pub)
+      # para que la verificación quede local a cada workflow, igual que
+      # el frontend.
+      - name: Firmar Imagen (Cosign)
+        shell: bash
+        env:
+          COSIGN_PRIVATE_KEY: ${{ secrets.COSIGN_PRIVATE_KEY }}
+          COSIGN_PASSWORD: ${{ secrets.COSIGN_PASSWORD }}
+        run: |
+          set -euo pipefail
+          /tmp/cosign sign \
+            --key env://COSIGN_PRIVATE_KEY \
+            --use-signing-config=false \
+            --tlog-upload=false \
+            --yes \
+            "${IMAGE_NAME}:${{ steps.vars.outputs.VERSION }}"
+
+      - name: Verificar Firma (smoke test)
+        shell: bash
+        run: |
+          set -euo pipefail
+          /tmp/cosign verify \
+            --key "${APP_DIR}/cosign.pub" \
+            --insecure-ignore-tlog=true \
+            "${IMAGE_NAME}:${{ steps.vars.outputs.VERSION }}"
 
       - name: Verificar promoción segura
         id: promotion
@@ -91,8 +359,8 @@ jobs:
           set -euo pipefail
 
           VERSION="${{ steps.vars.outputs.VERSION }}"
-          MANIFEST="workloads/ecommerce/commerce/medusa.yaml"
-          IMAGE="gitea.cruzcloud.net/devops/ecommerce-medusa"
+          MANIFEST="${{ env.MANIFEST_FILE }}"
+          IMAGE="${{ env.IMAGE_NAME }}"
 
           git config user.name "gitea-actions"
           git config user.email "[email protected]"
@@ -115,3 +383,14 @@ jobs:
             -m "chore(gitops): deploy Medusa ${VERSION} [skip ci]"
 
           git push origin HEAD:main
+
+      - name: Resumen del pipeline
+        if: always()
+        shell: bash
+        run: |
+          echo "========================================"
+          echo "ARI Shopping Commerce Backend (Medusa)"
+          echo "Versión: ${{ steps.vars.outputs.VERSION }}"
+          echo "Commit:  ${{ github.sha }}"
+          echo "Promoción GitOps: ${{ steps.promotion.outputs.promote }}"
+          echo "========================================"

workloads/commerce-backend/.trivyignore

@@ -0,0 +1,34 @@
+# Excepciones documentadas al gate CRITICAL de Trivy (imagen) para
+# commerce-backend. Cada entrada requiere justificación y fecha -- no
+# es un mecanismo para silenciar hallazgos sin revisar.
+#
+# CVE-2024-24790 / CVE-2025-68121 (golang stdlib, gobinary):
+#   Van embebidas en el binario precompilado de esbuild
+#   (app/node_modules/@esbuild/linux-x64/bin/esbuild), traído
+#   transitivamente por [email protected], que a su vez lo trae
+#   @medusajs/admin-sdk para bundlear el panel de admin en build time.
+#   No es un binario que se ejecute en runtime del contenedor (el CMD
+#   corre "node .../medusa/cli start", nunca esbuild).
+#
+#   Se intentó el fix real (bump de esbuild a una versión compilada con
+#   un Go toolchain más nuevo, override en package.json) y rompió el
+#   build del admin: [email protected] declara "esbuild: ^0.21.3" como
+#   dependencia directa (no rango amplio), y esbuild >=0.24 cambió el
+#   manejo de la lista de "target" de transpilación que vite 5 pasa
+#   internamente -- build.yaml falló con
+#   "Transforming destructuring... not supported yet" /
+#   PLUGIN_ERROR en vite:esbuild-transpile. No existe un patch dentro
+#   de la propia serie 0.21.x (0.21.5 ya es la última) que incluya un
+#   Go toolchain con estas CVEs corregidas.
+#
+#   Domesticar esto de verdad requiere subir @medusajs/admin-sdk (y por
+#   lo tanto vite) a una versión que dependa de un esbuild más nuevo --
+#   fuera de alcance de este pipeline de seguridad, queda como TODO de
+#   dependencias en un cambio aparte, no bloqueado por CI mientras
+#   tanto.
+#
+# Documentado: 2026-08-15. Revisar en cada bump de @medusajs/* por si
+# ya arrastra una versión de vite/esbuild más nueva y esta excepción
+# deja de ser necesaria.
+CVE-2024-24790
+CVE-2025-68121

workloads/commerce-backend/Dockerfile

@@ -59,6 +59,26 @@ ENV NODE_ENV=production \
     PORT=9000 \
     NPM_CONFIG_UPDATE_NOTIFIER=false
 
+#
+# libgnutls30 en la base node:22.18.0-bookworm-slim trae dos CVE
+# CRITICAL con fix ya publicado por Debian (CVE-2026-33845,
+# CVE-2026-42010) -- detectado por el gate de Trivy imagen del
+# pipeline (run 138). Solo se actualiza este paquete puntual, no toda
+# la imagen, para minimizar el diff de superficie de la base.
+RUN apt-get update \
+    && apt-get upgrade -y libgnutls30 \
+    && rm -rf /var/lib/apt/lists/*
+
+#
+# El CLI global de npm que trae la imagen base node:*-slim no se usa en
+# runtime (el CMD invoca a Medusa directo con `node`, nunca `npm`) y
+# arrastra su propia copia vendorizada de `tar` con un CVE CRITICAL
+# (CVE-2026-59873, detectado por Trivy en
+# usr/local/lib/node_modules/npm/node_modules/tar). Se elimina en vez
+# de forzar una versión: no es una dependencia real de este proyecto,
+# así que no hay nada que "actualizar" -- solo superficie sin uso.
+RUN rm -rf /usr/local/lib/node_modules/npm
+
 #
 # Solo lo necesario para ejecutar Medusa
 #

workloads/commerce-backend/cosign.pub

@@ -0,0 +1,4 @@
+-----BEGIN PUBLIC KEY-----
+MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEhjg9/nC0u+iEANiHkVJY8iN+LZo+
+VFMF7XG/oC64W3/SfwrPgt+ZIqF6t+ceyrNuEgugajvUdpigz1PHEqQKLw==
+-----END PUBLIC KEY-----

workloads/docs-portal/Dockerfile

@@ -16,6 +16,14 @@ RUN mkdocs build --strict
 # --- Stage 2: sirve el sitio estático generado con nginx ---
 FROM nginx:1.27-alpine
 
+# libssl3/libcrypto3 de la base nginx:1.27-alpine traen un CVE CRITICAL
+# con fix ya publicado por Alpine (CVE-2026-31789, heap buffer overflow
+# en OpenSSL) -- detectado por el gate de Trivy imagen del pipeline
+# (run 144). Solo se actualizan estos dos paquetes puntuales.
+RUN apk update \
+    && apk upgrade --no-cache libssl3 libcrypto3 \
+    && rm -rf /var/cache/apk/*
+
 COPY --from=build /site/site /usr/share/nginx/html
 
 EXPOSE 80

workloads/ecommerce/commerce/medusa.yaml

@@ -52,7 +52,7 @@ spec:
               memory: 64Mi
 
         - name: migrations
-          image: gitea.cruzcloud.net/devops/ecommerce-medusa:v1.0.92
+          image: gitea.cruzcloud.net/devops/ecommerce-medusa:v1.0.108
           imagePullPolicy: IfNotPresent
           command:
             - npx
@@ -73,7 +73,7 @@ spec:
 
       containers:
         - name: medusa
-          image: gitea.cruzcloud.net/devops/ecommerce-medusa:v1.0.92
+          image: gitea.cruzcloud.net/devops/ecommerce-medusa:v1.0.108
           imagePullPolicy: IfNotPresent
           envFrom:
             - configMapRef: