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 CI | Con Dependency-Track en su VPS | |
|---|---|---|
| Momento del análisis | En el build, y después nada | En cada build, y después de forma continua |
| Vulnerabilidad publicada tras el despliegue | Invisible hasta el próximo build | Señalada en las versiones en producción |
| Visión de conjunto | Un informe por repositorio | Todo el portafolio, búsqueda por componente |
| Licencias | Según la herramienta | Políticas de licencia explícitas |
| Dónde vive el inventario | En los registros de la CI | En 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 versionInstalar Dependency-Track con Docker Compose
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 .envEscribir 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
/apial 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.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: {}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/versionEl segundo comando responde con la versión del servidor en cuanto la API está lista.
Sustituir la contraseña de fábrica
La cuenta
adminnace con la contraseñaadmin. 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.gzPara 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.
servorbit.com/ma-es/blog/autoalojar-dependency-track-vps-sbom