Autoalojamiento

Dependency-Track en un VPS: SBOM y dependencias vulnerables

Una aplicación moderna incluye cientos de bibliotecas que nadie ha elegido una a una. El día en que una vulnerabilidad crítica afecta a una de ellas, la única pregunta que importa es: ¿dónde la hemos desplegado? OWASP Dependency-Track la responde de forma continua. Su CI le envía el SBOM de cada build, coteja cada componente con las bases de vulnerabilidades públicas y le avisa en cuanto una versión en producción se ve afectada. Esta guía lo instala en un VPS con Docker Compose, sustituye la contraseña de fábrica, lo publica en HTTPS detrás de nginx y lo conecta a su pipeline.

Desplegar en un VPS Cloud →
7 min de lectura5 pasos
Contenido· Qué hace Dependency-Track1/11
  1. 01Qué hace Dependency-Track
  2. 02Lo que le aporta Dependency-Track
  3. 03Escáner puntual o Dependency-Track en su VPS
  4. 04Preparar el servidor
  5. 05Instalar Dependency-Track con Docker Compose
  6. 06Nunca publique una instancia con admin/admin
  7. 07Publicar Dependency-Track en HTTPS detrás de nginx
  8. 08Enviar los SBOM desde la CI
  9. 09Políticas y notificaciones
  10. 10Copia de seguridad y actualización
  11. 11Dependency-Track en un clic en ServOrbit

Qué hace Dependency-Track

Dependency-Track es un proyecto insignia de OWASP, publicado bajo licencia Apache-2.0. No lee su código: lee el inventario de lo que incluye su aplicación, el SBOM (Software Bill of Materials), en formato CycloneDX. Cada componente se identifica en él por su Package URL (pkg:npm/[email protected], pkg:maven/…), lo que permite cotejarlo sin ambigüedad con las bases de vulnerabilidades: NVD, GitHub Advisories, OSV.

La diferencia con un escáner lanzado en la CI es el tiempo. El escáner juzga el build del día; Dependency-Track conserva todas las versiones de todos sus proyectos y las reevalúa cada vez que sus bases se actualizan. Una vulnerabilidad publicada dentro de tres meses se señalará en la versión que usted despliega hoy.

Lo que le aporta Dependency-Track

  • Un portafolio — cada aplicación y cada versión, con la lista de sus componentes directos y transitivos.
  • Alertas retroactivas — una vulnerabilidad publicada después del despliegue aparece en las versiones que ya están en producción.
  • Políticas — licencias prohibidas, severidad máxima tolerada, componentes vetados, evaluadas en cada envío de SBOM.
  • La clasificación de las vulnerabilidades — severidad, puntuación EPSS de probabilidad de explotación y un seguimiento de los análisis («no afectado», «corregido»…).
  • Notificaciones — Slack, Microsoft Teams, webhook o correo electrónico, por proyecto y por gravedad.
  • Una API completa — envío de SBOM, lectura de resultados y administración, con claves de API por equipo.

Escáner puntual o Dependency-Track en su VPS

Desplace la tabla

Escáner lanzado en la CICon Dependency-Track en su VPS
Momento del análisisEn el build, y después nadaEn cada build, y después de forma continua
Vulnerabilidad publicada tras el despliegueInvisible hasta el próximo buildSeñalada en las versiones en producción
Visión de conjuntoUn informe por repositorioTodo el portafolio, búsqueda por componente
LicenciasSegún la herramientaPolíticas de licencia explícitas
Dónde vive el inventarioEn los registros de la CIEn su VPS, con su historial

Preparar el servidor

Prevea un VPS Ubuntu 24.04 con 4 GB de RAM y 2 vCPU como mínimo: el servidor de API, escrito en Java, está limitado a 2 GB, y PostgreSQL se reparte el resto con el sistema. A partir de unas decenas de proyectos analizados cada día, pase a 8 GB. Cuente con 30 GB de disco.

Instale Docker y el plugin Compose, y apunte un subdominio (por ejemplo dtrack.example.com) a la dirección IP del VPS: sus pipelines enviarán sus SBOM a esa dirección, y la interfaz web se abrirá en ella.

curl -fsSL https://get.docker.com | sh
docker compose version

Instalar Dependency-Track con Docker Compose

  1. Preparar la carpeta y el archivo .env

    El archivo contiene la contraseña de la base PostgreSQL y la de la cuenta admin.

    mkdir -p /opt/dependency-track && cd /opt/dependency-track
    cat > .env <<EOF
    DB_PASSWORD=$(openssl rand -hex 16)
    ADMIN_PASSWORD=$(openssl rand -hex 16)
    EOF
    chmod 600 .env
  2. Escribir la configuración del proxy interno

    La interfaz web llama a la API en su propia dirección. Un pequeño nginx dirige por tanto /api al servidor de API y todo lo demás a la interfaz: un solo puerto que publicar, un solo dominio, ningún ajuste CORS.

    server {
      listen 80;
      client_max_body_size 64m;
      location /api/ {
        proxy_pass http://apiserver:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 300s;
      }
      location / {
        proxy_pass http://frontend:8080;
        proxy_set_header Host $host;
      }
    }

    Guarde este bloque en /opt/dependency-track/proxy.conf.

  3. Escribir el archivo docker-compose.yml

    Cuatro servicios: PostgreSQL, el servidor de API, la interfaz y el proxy. El puerto solo se publica en el bucle local: únicamente el nginx del VPS quedará expuesto a Internet.

    services:
      db:
        image: postgres:18.7-alpine
        restart: unless-stopped
        environment:
          POSTGRES_DB: dtrack
          POSTGRES_USER: dtrack
          POSTGRES_PASSWORD: ${DB_PASSWORD}
        volumes:
          - db:/var/lib/postgresql
        healthcheck:
          test: ["CMD-SHELL", "pg_isready -q -U dtrack -d dtrack"]
          interval: 10s
          retries: 30
    
      apiserver:
        image: ghcr.io/dependencytrack/apiserver:5.2.2
        restart: unless-stopped
        depends_on:
          db:
            condition: service_healthy
        deploy:
          resources:
            limits:
              memory: 2g
        environment:
          DT_DATASOURCE_URL: jdbc:postgresql://db:5432/dtrack
          DT_DATASOURCE_USERNAME: dtrack
          DT_DATASOURCE_PASSWORD: ${DB_PASSWORD}
        volumes:
          - data:/data
    
      frontend:
        image: ghcr.io/dependencytrack/frontend:5.2.2
        restart: unless-stopped
        environment:
          API_BASE_URL: ""
    
      proxy:
        image: nginx:1.27-alpine
        restart: unless-stopped
        depends_on: [apiserver, frontend]
        ports:
          - "127.0.0.1:8127:80"
        volumes:
          - ./proxy.conf:/etc/nginx/conf.d/default.conf:ro
    
    volumes:
      db: {}
      data: {}
  4. Arrancar la pila

    El primer arranque crea el esquema de la base y, después, el servidor de API descarga las bases de vulnerabilidades en segundo plano.

    docker compose up -d
    curl -s http://127.0.0.1:8127/api/version

    El segundo comando responde con la versión del servidor en cuanto la API está lista.

  5. Sustituir la contraseña de fábrica

    La cuenta admin nace con la contraseña admin. Sustitúyala antes de cualquier publicación:

    . ./.env
    curl -fsS http://127.0.0.1:8127/api/v1/user/forceChangePassword \
      --data-urlencode username=admin --data-urlencode password=admin \
      --data-urlencode newPassword="$ADMIN_PASSWORD" \
      --data-urlencode confirmPassword="$ADMIN_PASSWORD"

Nunca publique una instancia con admin/admin

Dependency-Track obliga a cambiar la contraseña en el primer inicio de sesión, pero entre el arranque y ese inicio de sesión cualquiera puede hacerlo en su lugar y tomar el control del inventario de sus aplicaciones — es decir, de la lista de sus vulnerabilidades. Sustituya la contraseña antes de configurar nginx.

Publicar Dependency-Track en HTTPS detrás de nginx

El nginx del VPS recibe el dominio y reenvía al puerto local. Aumente el tamaño de los envíos: el SBOM de una aplicación de cierto tamaño supera rápidamente el megabyte que nginx acepta por defecto.

server {
  server_name dtrack.example.com;
  client_max_body_size 64m;
  location / {
    proxy_pass http://127.0.0.1:8127;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
  }
}

Después emita el certificado con certbot --nginx -d dtrack.example.com. Abra https://dtrack.example.com, inicie sesión con admin y su nueva contraseña, y cree las cuentas del equipo en Administration → Access Management.

Enviar los SBOM desde la CI

En Administration → Access Management → Teams, abra el equipo Automation y genere una clave de API; guárdela en los secretos de la CI. Después, el pipeline genera el SBOM y lo envía en cada build — aquí con cdxgen, que reconoce la mayoría de los ecosistemas (npm, Maven, PyPI, Composer, Go…):

# .github/workflows/sbom.yml
name: sbom
on: [push]
jobs:
  sbom:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npx --yes @cyclonedx/cdxgen -o bom.json
      - run: |
          curl -fsS -X POST https://dtrack.example.com/api/v1/bom \
            -H "X-Api-Key: ${{ secrets.DT_API_KEY }}" \
            -F autoCreate=true -F projectName=${{ github.event.repository.name }} \
            -F projectVersion=${{ github.ref_name }} -F [email protected]

El proyecto aparece en el portafolio con la versión enviada. Para una imagen de contenedor, syft <image> -o cyclonedx-json > bom.json genera el equivalente, paquetes del sistema incluidos.

Políticas y notificaciones

Una política convierte una constatación en regla. En Policy Management, cree por ejemplo una política de seguridad que señale toda vulnerabilidad de severidad *High* o superior, y una política de licencia que rechace las licencias que su contrato prohíbe. Cada envío de SBOM se evalúa, y las infracciones se muestran en el proyecto.

En Administration → Notifications, conecte después un canal — Slack, Microsoft Teams, webhook o correo electrónico — a los eventos *New Vulnerability* y *Policy Violation*, limitados a los proyectos que importan. Esta alerta es lo que da valor a la herramienta: llega el día en que se publica la vulnerabilidad, no el día del próximo build.

Copia de seguridad y actualización

Todo el estado útil vive en PostgreSQL: proyectos, SBOM, análisis y ajustes. Haga copia de la base; la carpeta /data se reconstituye (contiene sobre todo las bases de vulnerabilidades descargadas).

cd /opt/dependency-track
docker compose exec -T db pg_dump -U dtrack dtrack | gzip > dtrack-$(date +%F).sql.gz

Para actualizar, lea las notas de la versión, cambie las dos etiquetas de imagen (apiserver y frontend, siempre a la misma versión) y después ejecute docker compose pull && docker compose up -d. El servidor de API migra el esquema al arrancar. Conserve una copia de seguridad reciente antes de cada actualización de versión.

Dependency-Track en un clic en ServOrbit

En un VPS de ServOrbit, Dependency-Track se instala desde el Marketplace: imágenes oficiales, PostgreSQL y proxy interno listos, contraseña de fábrica de la cuenta admin sustituida por una contraseña generada que aparece en su área de cliente, proxy inverso nginx en HTTPS en su dominio o en el subdominio gratuito del VPS. Solo le queda crear la clave de API de la CI y enviar su primer SBOM.

Compartir este artículoservorbit.com/ma-es/blog/autoalojar-dependency-track-vps-sbom

Sus dependencias bajo vigilancia, en su VPS

Precios sin IVA, mostrados con su precio de renovación.