Wichtig. Scannen Sie nur Netzwerke, die Ihnen gehören oder für die Sie eine schriftliche Genehmigung haben. UltraViolet führt passive Diensterkennung durch – es nutzt keine Schwachstellen aus.

Warum UltraViolet

Einzelmandant, ein Docker Compose Stack, volle Kontrolle über Ihre Daten.

✨ Funktionen

Erkennung

• TCP-Connect-Scanner mit masscan oder zmap als Erkennungs-Engine
• UDP-Sonden auf konfigurierbaren Ports
• Eingeschränkt durch SCAN_ALLOWED_CIDRS mit Host- und Port-Limits

Tiefensonden (~100 Protokolle)

• Web: HTTP/HTTPS, HTTP/3, GraphQL, Favicon-Hash, robots.txt, security.txt, Tech-Stack
• TLS: Zertifikatsketten, JARM, JA3S/JA4S, Konfigurationsbewertung
• Mail & Verzeichnisse: SMTP, POP3/IMAP, LDAP, IPMI
• Datenbanken & Warteschlangen: MySQL, PostgreSQL, MongoDB, Redis, Kafka, MQTT, NATS, AMQP…
• ICS/SCADA: Modbus, BACnet, DNP3, IEC 104, S7Comm, ENIP, OPC UA…
• IoT & Medien: ONVIF, RTSP, Chromecast, AirPlay, UPnP…
• Vollständige Liste in der Protokolldokumentation

Anreicherung

• Reverse-DNS, GeoIP (MMDB), ASN
• Optionales Forward-DNS und CT-Log-Erkennung

CVE & Risiko

• Lokaler NVD-Spiegel mit Hintergrundsynchronisation und Fingerprint-basiertem Abgleich
• CISA KEV und FIRST EPSS

Betrieb

• RBAC (viewer / operator / admin), JWT + Refresh-Tokens
• Scan-Zeitpläne, Pause/Fortsetzen, Waisenrückgewinnung nach Worker-Neustart
• Prometheus /metrics, optionales Grafana-Profil
• Audit-Log, Ratenbegrenzung, Aufbewahrungsrichtlinien

🏗 Architektur

flowchart TB
  Browser["Browser"]
  FE["service-frontend<br/>React + nginx"]
  API["uv-api<br/>REST · WS · metrics"]
  PG[("PostgreSQL 16")]
  SCAN["uv-scanner<br/>probe pipeline"]

  Browser --> FE
  FE -->|"/api"| API
  FE -->|"/realtime"| API
  API <--> PG
  SCAN <--> PG
  API -.->|LISTEN/NOTIFY| API

Das Release-UI-Bild proxyt /api/ und /realtime an uv-api – Single Origin, kein Frontend-Neubau pro API-URL.

Backend-Entwicklungsregeln: CLAUDE.md.

🚀 Schnellstart

Anforderungen: Docker Engine ≥ 24, ~4 GB RAM, Linux amd64 für Produktionsimages.

git clone https://github.com/yakushstanislav/UltraViolet.git
cd UltraViolet/service-env

cp .env.example .env
mkdir -p secrets
openssl rand -hex 32 > secrets/postgres_password
openssl rand -hex 32 > secrets/auth_jwt_secret

cd ..
make dev

Dev-Bootstrap: admin / admin (nur wenn APP_ENV≠production).

📖 Dokumentation

Vollständiger Leitfaden – VitePress in service-documentation-frontend/docs/:

make docs-dev    # → http://localhost:5173

In der Produktion das docs-Profil aktivieren:

cd service-env && docker compose --profile docs up -d
# → http://localhost:${UV_DOCUMENTATION_PORT:-3002}

Wichtige Abschnitte: Installation · Scannen · API · Bereitstellung · Offline-Installation.

🛠 Entwicklung

Vollständiger Docker

make dev    # compose prod + dev override, hot-rebuild

Hybrid-Modus (schnellere Backend-Iteration)

make dev-db   # PostgreSQL nur auf :5432

cd service-api && make build
export LOGGER_NAME=uv-api LOGGER_DEBUG=true
export SERVER_ADDR=0.0.0.0 SERVER_PORT=8080
export METRICS_ADDR=0.0.0.0 METRICS_PORT=9090
export REALTIME_ADDR=0.0.0.0 REALTIME_PORT=8081
export POSTGRES_ADDR=localhost POSTGRES_PORT=5432
export POSTGRES_USERNAME=ultraviolet
export POSTGRES_PASSWORD="$(cat ../service-env/secrets/postgres_password)"
export POSTGRES_DATABASE=ultraviolet
export POSTGRES_SCHEMA_PATH="$(pwd)/deploy/migrations"
export AUTH_JWT_SECRET="$(cat ../service-env/secrets/auth_jwt_secret)"
./bin/uv-api

Frontend: cd service-frontend && npm run dev (Vite proxyt /api → :8080, /realtime → :8081).

GeoIP & CVE

cd service-env && make geoip-download      # IPLocate MMDB → geoip/
make -C service-env cve-catalog-dump       # CVE-Dump (erfordert laufendes Postgres)

Bauen ohne Docker

make build && make lint && make frontend-build && make docs-build

📦 Veröffentlichung & Installation

Zielplattform: linux/amd64. Auf Apple Silicon setzen Sie DOCKER_PLATFORM=linux/amd64 für Offline-Archive.

git tag v0.1.0
make release VERSION=v0.1.0
make release-promote VERSION=v0.1.0   # :latest – separater Schritt

Online: Entpacken → cp .env.example .env → ./install.sh (Pull vom Registry).

Offline: ./install.sh (docker load, kein Pull). Upgrade: .env, secrets/ und das Postgres-Volume behalten → ./upgrade.sh.

Variablen: UV_REGISTRY (Standard docker.io/ultraviolet), DRY_RUN=1 – lokaler Smoke-Build ohne Push.

# vom Build-Rechner aus
scp dist/ultraviolet-v0.1.0-offline.tar.gz user@host:~/

# auf dem Server (Docker ≥ 24, amd64)
tar xzf ultraviolet-v0.1.0-offline.tar.gz && cd ultraviolet-v0.1.0
cp .env.example .env
./install.sh

docker compose -f docker-compose.yml down
# .env + secrets/ sichern, das neue Archiv entpacken, ./upgrade.sh ausführen

✅ Produktions-Checkliste

1. Secrets in secrets/ speichern, niemals in Git.
2. CORS_ALLOWED_ORIGINS auf reale UI-Origins setzen.
3. SCAN_ALLOWED_CIDRS sowie Host/Port-Limits konfigurieren.
4. Bootstrap-Passwort und AUTH_JWT_SECRET ändern (install.sh lehnt Platzhalter ab).
5. APP_ENV=production setzen – uv-api lehnt admin/admin und Passwörter kürzer als 8 Zeichen ab.
6. TLS an einem Reverse-Proxy terminieren – Beispiel: service-env/examples/nginx-tls.conf.
7. Hinter einem Proxy: AUDIT_TRUST_PROXY_HEADERS=true setzen.
8. PostgreSQL sichern: service-env/scripts/backup.sh + Cron; upgrade.sh erstellt ebenfalls einen Dump.

# docker-compose.override.yml
services:
  service-frontend:
    ports:
      - "127.0.0.1:3000:8080"

CORS_ALLOWED_ORIGINS=https://ultraviolet.example.com
AUDIT_TRUST_PROXY_HEADERS=true

VITE_BASE_PATH=/ultraviolet/ make frontend-build
# UV_BASE_PATH=/ultraviolet/ in compose – muss VITE_BASE_PATH entsprechen

0 3 * * * cd /opt/ultraviolet/service-env && ./scripts/backup.sh && find backups -name 'uv-*.dump' -mtime +14 -delete

0 4 1 * * cd /opt/ultraviolet/service-env && ./scripts/geoip-refresh.sh >> /var/log/uv-geoip.log 2>&1

🔐 API & RBAC

Nach POST /v1/auth/login erhalten Sie ein access_token (Bearer) und ein refresh_token (/v1/auth/refresh).

GET /v1/me · GET /v1/version · GET /readyz (Health + Version + Commit).

🤝 Mitwirken

Siehe CONTRIBUTING.md. Sicherheitsmeldungen: SECURITY.md. Community-Standards: CODE_OF_CONDUCT.md.

📄 Lizenz

UltraViolet wird unter der MIT-Lizenz veröffentlicht.

_{UltraViolet – entdecken Sie, was Ihnen gehört, verstehen Sie, was sich geändert hat, behalten Sie es in Ihrem Netzwerk.}