Guida Rapida

Questa traduzione precede i nuovi controlli di attivazione e distribuzione sicura. Usa la guida inglese finché questa pagina non viene aggiornata.

Cerchi un modo più semplice? Usa il nostro Installer Desktop per una distribuzione con un clic e configurazione automatica. Nessuna riga di comando richiesta!

Prerequisiti

Prima di iniziare, assicurati di avere installato quanto segue sul tuo sistema:

Docker Engine (20.10.0 o superiore)
Docker Compose (v2.0.0 o superiore)
OpenSSL (per generare i certificati SSL)

Installazione di Docker

Per macOS:

Scarica e installa Docker Desktop da Docker Hub
Segui la procedura guidata di installazione
Verifica l’installazione:

docker --version
docker compose --version

Per Linux (Ubuntu/Debian):

# Aggiorna l'indice dei pacchetti
sudo apt-get update

# Installa i prerequisiti
sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# Aggiungi la chiave GPG ufficiale di Docker
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# Configura il repository stabile
echo \
  "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Installa Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# Aggiungi il tuo utente al gruppo docker
sudo usermod -aG docker $USER

Per Windows:

Scarica e installa Docker Desktop da Docker Hub
Abilita WSL 2 seguendo la documentazione di Docker
Segui la procedura guidata di installazione
Verifica l’installazione in PowerShell:

docker --version
docker compose --version

Passaggio 1: Creare la Directory del Progetto

Crea una nuova directory per la tua distribuzione di CaseBender e accedi ad essa:

mkdir casebender-deployment
cd casebender-deployment

Passaggio 2: Configurare le Variabili d’Ambiente

Crea un file .env con il seguente contenuto:

# Autenticazione
AUTH_SECRET="B7OawnWf6+LwB/9yXbxbk4ppZ1khydqj4qc9k9g3nnE="
AUTH_SALT="B7OawnW"
AUTH_TRUST_HOST=true
NEXTAUTH_URL=https://local.casebender.com
NEXTAPP_URL=https://local.casebender.com

# Licenza (opzionale)
# CaseBender genera e conserva automaticamente una chiave segreta di licenza al
# primo avvio (memorizzata nel volume "casebender_secret") e la riutilizza a ogni
# riavvio e aggiornamento — nessuna azione richiesta. Imposta LICENSE_SECRET_KEY
# solo se vuoi gestire la chiave tu stesso: eseguirne il backup, ruotarla o
# condividerla tra le repliche. Generane una con: openssl rand -hex 32
# LICENSE_SECRET_KEY=

# Configurazione di Liveblocks (collaborazione in tempo reale)
LIVEBLOCKS_SECRET_KEY=sk_dev_HaIczPV4gPit5_gx7YRsNXLGJNzBE5wQ8z8I1H8ft3ZPZHVrfH2ryJJ586ezHYla

# Configurazione del Database (l'host è il servizio interno "db")
POSTGRES_PASSWORD=88AlwaysTimeToWin88
POSTGRES_PRISMA_URL="postgresql://superadmin:88AlwaysTimeToWin88@db:5432/casebender?schema=public"
POSTGRES_URL="postgresql://superadmin:88AlwaysTimeToWin88@db:5432/casebender?schema=public"
POSTGRES_URL_NON_POOLING="postgresql://superadmin:88AlwaysTimeToWin88@db:5432/casebender?schema=public"

# Configurazione di Redis
REDIS_URL="redis://redis:6379"
# Fallback host/porta — letto da tutti i servizi (copre anche le immagini
# meno recenti che non interpretano REDIS_URL per la coda dei job).
REDIS_HOST=redis
REDIS_PORT=6379

CaseBender viene eseguito come diversi container: l’app web (app), un gateway API REST (api), un gateway di ingestione degli avvisi (ingestion, che riceve i webhook di integrazione come quello di Microsoft Defender), un worker in background e i processori workflow e MISP. Nginx si trova davanti e instrada il traffico al servizio corretto. Sono tutti inclusi nel file Compose qui sotto.

Passaggio 3: Generare i Certificati SSL

Per lo sviluppo locale, genera certificati SSL autofirmati:

# Genera certificato e chiave SSL
openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout local-casebender.key \
  -out local-casebender.crt \
  -subj "/CN=local.casebender.com/O=CaseBender/C=US"

# Verifica il certificato
openssl x509 -in local-casebender.crt -text -noout

Passaggio 4: Configurare Nginx

Crea nginx.conf con il seguente contenuto:

events {
    worker_connections 1024;
}

http {
    # ─── Upstream ──────────────────────────────────────────────
    upstream web_app {
        server app:3000;
    }

    upstream api_service {
        server api:3005;
    }

    upstream ingestion_service {
        server ingestion:3003;
    }

    # ─── Limitazione della Frequenza ───────────────────────────
    limit_req_zone $binary_remote_addr zone=api_limit:10m rate=100r/s;
    limit_req_zone $binary_remote_addr zone=ingest_limit:10m rate=1000r/s;

    # ─── Reindirizzamento HTTP -> HTTPS ────────────────────────
    server {
        listen 80;
        server_name local.casebender.com;
        return 301 https://$server_name$request_uri;
    }

    # ─── Server HTTPS Principale ───────────────────────────────
    server {
        listen 443 ssl;
        http2 on;
        server_name local.casebender.com;

        ssl_certificate /etc/nginx/certs/local-casebender.crt;
        ssl_certificate_key /etc/nginx/certs/local-casebender.key;

        ssl_protocols TLSv1.2 TLSv1.3;
        client_max_body_size 100M;

        # ─── Intestazioni di Sicurezza ────────────────────────
        add_header X-Frame-Options "SAMEORIGIN" always;
        add_header X-Content-Type-Options "nosniff" always;
        add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

        # ─── API di Ingestione (webhook di integrazione) ──────
        location /api/v1/ingest/ {
            limit_req zone=ingest_limit burst=500 nodelay;
            proxy_pass http://ingestion_service;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }

        # Rotta di ingestione legacy
        location /api/ingest/ {
            limit_req zone=ingest_limit burst=500 nodelay;
            proxy_pass http://ingestion_service;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }

        # ─── Gateway API REST ─────────────────────────────────
        location /api/v1/ {
            limit_req zone=api_limit burst=50 nodelay;
            proxy_pass http://api_service;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }

        location /api/openapi.json {
            proxy_pass http://api_service;
            proxy_set_header Host $host;
        }

        # ─── Controllo di Salute ──────────────────────────────
        location /health {
            access_log off;
            return 200 "healthy";
            add_header Content-Type text/plain;
        }

        # ─── Applicazione Web (catch-all) ─────────────────────
        location / {
            proxy_pass http://web_app;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
            proxy_set_header X-Forwarded-Host $host;
            proxy_set_header X-Forwarded-Port $server_port;

            # Supporto WebSocket
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";

            proxy_connect_timeout 60s;
            proxy_send_timeout 60s;
            proxy_read_timeout 60s;
        }
    }
}

Passaggio 5: Creare la Configurazione di Docker Compose

Crea docker-compose.yml con il seguente contenuto:

services:
  # ─── Servizi Principali ──────────────────────────────────────
  app:
    image: casebender/casebender:latest
    platform: linux/amd64
    ports:
      - "3000:3000"
    environment:
      - AUTH_SECRET=${AUTH_SECRET}
      - AUTH_SALT=${AUTH_SALT}
      - AUTH_TRUST_HOST=true
      - NEXTAUTH_URL=${NEXTAUTH_URL:-https://local.casebender.com}
      - NEXTAPP_URL=${NEXTAPP_URL:-https://local.casebender.com}
      - LICENSE_SECRET_KEY=${LICENSE_SECRET_KEY}
      - LIVEBLOCKS_SECRET_KEY=${LIVEBLOCKS_SECRET_KEY}
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    volumes:
      # Conserva il secret e il blob della licenza autogenerati tra gli
      # aggiornamenti così `docker compose pull` non rigenera la licenza.
      - casebender_secret:/app/apps/web/app/secret
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "node -e \"require('http').get('http://localhost:3000/api/health', (r) => process.exit(r.statusCode === 200 ? 0 : 1)).on('error', () => process.exit(1))\""]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 60s

  api:
    image: casebender/api:latest
    platform: linux/amd64
    ports:
      - "3005:3005"
    environment:
      - PORT=3005
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
      - AUTH_SECRET=${AUTH_SECRET}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped

  ingestion:
    image: casebender/ingestion:latest
    platform: linux/amd64
    ports:
      - "3003:3003"
    environment:
      - PORT=3003
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped

  # ─── Servizi di Elaborazione ─────────────────────────────────
  worker:
    image: casebender/worker:latest
    platform: linux/amd64
    ports:
      - "3002:3002"
    environment:
      - PORT=3002
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped

  workflow-processor:
    image: casebender/workflow-processor:latest
    platform: linux/amd64
    ports:
      - "3001:3001"
    environment:
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
      app:
        condition: service_healthy
    restart: unless-stopped

  misp-processor:
    image: casebender/misp-processor:latest
    platform: linux/amd64
    ports:
      - "3004:3004"
    environment:
      - PORT=3004
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
      app:
        condition: service_healthy
    restart: unless-stopped

  # ─── Infrastruttura ──────────────────────────────────────────
  db:
    image: postgres:17
    environment:
      POSTGRES_USER: superadmin
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-88AlwaysTimeToWin88}
      POSTGRES_DB: casebender
    ports:
      - "5433:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U superadmin -d casebender"]
      interval: 5s
      timeout: 5s
      retries: 10
      start_period: 30s
    restart: unless-stopped

  redis:
    image: redis:7.2-alpine
    command: redis-server --protected-mode no
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 3s
      retries: 5
    restart: unless-stopped

  minio:
    image: quay.io/minio/minio
    mem_limit: 512m
    command: ["minio", "server", "/data", "--console-address", ":9090"]
    environment:
      - MINIO_ROOT_USER=minioadmin
      - MINIO_ROOT_PASSWORD=minioadmin
    ports:
      - "9090:9090"
      - "9000:9000"
    volumes:
      - "miniodata:/data"
    restart: unless-stopped

  # ─── Proxy Inverso ───────────────────────────────────────────
  nginx:
    image: nginx:alpine
    ports:
      - "443:443"
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./local-casebender.crt:/etc/nginx/certs/local-casebender.crt:ro
      - ./local-casebender.key:/etc/nginx/certs/local-casebender.key:ro
    depends_on:
      app:
        condition: service_healthy
    restart: unless-stopped

volumes:
  miniodata:
  pgdata:
  redis_data:
  casebender_secret:

Hai bisogno della ricerca enterprise (OpenSearch)? L’Installer Desktop può aggiungere per te i servizi search-sync, opensearch e opensearch-dashboards. Per la maggior parte delle valutazioni locali, la ricerca basata su PostgreSQL sopra è tutto ciò che serve.

Passaggio 6: Configurare il DNS Locale

Aggiungi la seguente voce al tuo file hosts:

Per macOS e Linux:

sudo echo "127.0.0.1 local.casebender.com" >> /etc/hosts

Per Windows:

Aggiungi la seguente riga a C:\Windows\System32\drivers\etc\hosts:

127.0.0.1 local.casebender.com

Passaggio 7: Avviare l’Applicazione

Scarica le immagini necessarie:

docker compose pull

Avvia tutti i servizi:

docker compose up -d

Monitora i log:

docker compose logs -f

Accedi all’applicazione su https://local.casebender.com

Credenziali di Accesso Predefinite

Dopo aver distribuito CaseBender, puoi accedere con le seguenti credenziali predefinite:

Utente: admin@casebender.app
Password: secret1234

Per motivi di sicurezza, consigliamo vivamente di cambiare queste credenziali predefinite subito dopo il primo accesso.

Esecuzione dietro un proxy aziendale

Se il tuo host può raggiungere internet solo attraverso un proxy HTTP aziendale (reti “solo proxy”), le chiamate in uscita di CaseBender — attivazione della licenza e integrazioni come Microsoft Defender e Splunk — devono essere instradate attraverso di esso. Aggiungi le variabili del proxy al tuo .env:

HTTP_PROXY=http://proxy.example.com:8080
HTTPS_PROXY=http://proxy.example.com:8080
# I servizi Docker interni (e qualsiasi destinazione on-prem) DEVONO bypassare il proxy:
NO_PROXY=127.0.0.1,localhost,db,redis,minio,api,ingestion,worker,workflow-processor,misp-processor,search-sync,opensearch

Poi passale a ogni servizio CaseBender aggiungendo queste righe al blocco environment: di ciascun servizio in docker-compose.yml:

      - HTTP_PROXY=${HTTP_PROXY:-}
      - HTTPS_PROXY=${HTTPS_PROXY:-}
      - NO_PROXY=${NO_PROXY:-}

NO_PROXY deve includere i nomi dei servizi Docker interni sopra elencati. Altrimenti il traffico tra container (ad es. l’app web che chiama il servizio di ingestion) viene inviato al proxy aziendale e fallisce — compromettendo l’applicazione anche se non ha nulla a che fare con internet.

Quali destinazioni passano dal proxy? Gli endpoint pubblici devono passare dal proxy e NON devono essere in NO_PROXY — ad es. Microsoft Defender (login.microsoftonline.com, graph.microsoft.com). Le destinazioni on-prem devono essere elencate in NO_PROXY per essere raggiunte direttamente — ad es. un Splunk HEC interno. Se usi Splunk Cloud, lascialo fuori così da instradarlo attraverso il proxy.

Verifica la connettività dall’interno di un container (usa node, senza curl):

docker compose exec app node -e "fetch('https://login.microsoftonline.com/',{signal:AbortSignal.timeout(5000)}).then(r=>console.log('OK',r.status)).catch(e=>console.log('FAIL',e.message))"

Quando è configurato un proxy, ogni servizio registra [proxy] Outbound fetch routed through corporate proxy (...) all’avvio.

Risoluzione dei Problemi

Problemi Comuni

Avvisi sui Certificati:
- Il browser mostrerà un avviso di sicurezza perché usiamo un certificato autofirmato
- Fai clic su “Avanzate” e procedi al sito web
- A scopo di sviluppo, questo è previsto e sicuro
Conflitti di Porta:
- Assicurati che le porte 80, 443, 3000, 3001, 3002, 3003, 3004, 3005, 5433, 6379, 9000 e 9090 non siano in uso
- Se necessario, modifica le mappature delle porte in docker-compose.yml
Connessione al Database:
- Controlla i log di PostgreSQL: docker compose logs db
- Verifica le credenziali del database in .env
- Assicurati che il database sia in esecuzione: docker compose ps db
Dipendenze dei Servizi:
- Se i servizi non si avviano, controlla le loro dipendenze:
docker compose ps docker compose logs [nome_servizio]

Controllare i Log

Visualizza i log di servizi specifici:

# Tutti i servizi
docker compose logs

# Un servizio specifico
docker compose logs [nome_servizio]

# Segui i log
docker compose logs -f [nome_servizio]

Gestione dei Servizi

# Riavvia un servizio specifico
docker compose restart [nome_servizio]

# Ferma tutti i servizi
docker compose down

# Rimuovi i volumi (eliminerà tutti i dati)
docker compose down -v

Passaggi Successivi

Ora che CaseBender è in esecuzione in locale, potresti voler:

Distribuzione in Produzione

Distribuisci CaseBender nel tuo ambiente di produzione

Configurazione

Scopri le opzioni di configurazione avanzate

Iniziare

Distribuzione

Gestione degli Avvisi

Gestione dei Casi

Gestione delle Attività

Analisi

Verifiche

Impostazioni

Prerequisiti

Installazione di Docker

Per macOS:

Per Linux (Ubuntu/Debian):

Per Windows:

Passaggio 1: Creare la Directory del Progetto

Passaggio 2: Configurare le Variabili d’Ambiente

Passaggio 3: Generare i Certificati SSL

Passaggio 4: Configurare Nginx

Passaggio 5: Creare la Configurazione di Docker Compose

Passaggio 6: Configurare il DNS Locale

Per macOS e Linux:

Per Windows:

Passaggio 7: Avviare l’Applicazione

Credenziali di Accesso Predefinite

Esecuzione dietro un proxy aziendale

Risoluzione dei Problemi

Problemi Comuni

Controllare i Log

Gestione dei Servizi

Passaggi Successivi

Distribuzione in Produzione

Configurazione

​Prerequisiti

​Installazione di Docker

​Per macOS:

​Per Linux (Ubuntu/Debian):

​Per Windows:

​Passaggio 1: Creare la Directory del Progetto

​Passaggio 2: Configurare le Variabili d’Ambiente

​Passaggio 3: Generare i Certificati SSL

​Passaggio 4: Configurare Nginx

​Passaggio 5: Creare la Configurazione di Docker Compose

​Passaggio 6: Configurare il DNS Locale

​Per macOS e Linux:

​Per Windows:

​Passaggio 7: Avviare l’Applicazione

​Credenziali di Accesso Predefinite

​Esecuzione dietro un proxy aziendale

​Risoluzione dei Problemi

​Problemi Comuni

​Controllare i Log

​Gestione dei Servizi

​Passaggi Successivi

Distribuzione in Produzione

Configurazione

Prerequisiti

Installazione di Docker

Per macOS:

Per Linux (Ubuntu/Debian):

Per Windows:

Passaggio 1: Creare la Directory del Progetto

Passaggio 2: Configurare le Variabili d’Ambiente

Passaggio 3: Generare i Certificati SSL

Passaggio 4: Configurare Nginx

Passaggio 5: Creare la Configurazione di Docker Compose

Passaggio 6: Configurare il DNS Locale

Per macOS e Linux:

Per Windows:

Passaggio 7: Avviare l’Applicazione

Credenziali di Accesso Predefinite

Esecuzione dietro un proxy aziendale

Risoluzione dei Problemi

Problemi Comuni

Controllare i Log

Gestione dei Servizi

Passaggi Successivi