Guide de Démarrage Rapide

Cette traduction précède les nouveaux contrôles d’activation et de déploiement sécurisé. Utilisez le guide anglais jusqu’à sa mise à jour.

Vous cherchez une méthode plus simple ? Utilisez notre Installateur de Bureau pour un déploiement en un clic avec configuration automatique. Aucune ligne de commande requise !

Prérequis

Avant de commencer, assurez-vous d’avoir installé les éléments suivants sur votre système :

Docker Engine (20.10.0 ou supérieur)
Docker Compose (v2.0.0 ou supérieur)
OpenSSL (pour générer les certificats SSL)

Installation de Docker

Pour macOS :

Téléchargez et installez Docker Desktop depuis Docker Hub
Suivez l’assistant d’installation
Vérifiez l’installation :

docker --version
docker compose --version

Pour Linux (Ubuntu/Debian) :

# Mettre à jour l'index des paquets
sudo apt-get update

# Installer les prérequis
sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# Ajouter la clé GPG officielle de Docker
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# Configurer le dépôt stable
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

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

# Ajouter votre utilisateur au groupe docker
sudo usermod -aG docker $USER

Pour Windows :

Téléchargez et installez Docker Desktop depuis Docker Hub
Activez WSL 2 en suivant la documentation de Docker
Suivez l’assistant d’installation
Vérifiez l’installation dans PowerShell :

docker --version
docker compose --version

Étape 1 : Créer le Répertoire du Projet

Créez un nouveau répertoire pour votre déploiement CaseBender et accédez-y :

mkdir casebender-deployment
cd casebender-deployment

Étape 2 : Configurer les Variables d’Environnement

Créez un fichier .env avec le contenu suivant :

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

# Licence (facultatif)
# CaseBender génère et conserve automatiquement une clé secrète de licence au
# premier démarrage (stockée dans le volume "casebender_secret") et la réutilise
# lors des redémarrages et des mises à jour — aucune action requise. Définissez
# LICENSE_SECRET_KEY uniquement si vous souhaitez gérer la clé vous-même : la
# sauvegarder, la faire tourner ou la partager entre réplicas.
# Générez-en une avec : openssl rand -hex 32
# LICENSE_SECRET_KEY=

# Configuration de Liveblocks (collaboration en temps réel)
LIVEBLOCKS_SECRET_KEY=sk_dev_HaIczPV4gPit5_gx7YRsNXLGJNzBE5wQ8z8I1H8ft3ZPZHVrfH2ryJJ586ezHYla

# Configuration de la Base de Données (l'hôte est le service interne « 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"

# Configuration de Redis
REDIS_URL="redis://redis:6379"
# Solution de repli hôte/port — lue par tous les services (couvre aussi les
# anciennes images qui n'analysent pas REDIS_URL pour la file de tâches).
REDIS_HOST=redis
REDIS_PORT=6379

CaseBender s’exécute sous forme de plusieurs conteneurs : l’application web (app), une passerelle d’API REST (api), une passerelle d’ingestion d’alertes (ingestion, qui reçoit les webhooks d’intégration comme celui de Microsoft Defender), un worker en arrière-plan et les processeurs workflow et MISP. Nginx se place en frontal et route le trafic vers le bon service. Tous sont inclus dans le fichier Compose ci-dessous.

Étape 3 : Générer les Certificats SSL

Pour le développement local, générez des certificats SSL auto-signés :

# Générer le certificat et la clé 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"

# Vérifier le certificat
openssl x509 -in local-casebender.crt -text -noout

Étape 4 : Configurer Nginx

Créez nginx.conf avec le contenu suivant :

events {
    worker_connections 1024;
}

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

    upstream api_service {
        server api:3005;
    }

    upstream ingestion_service {
        server ingestion:3003;
    }

    # ─── Limitation de Débit ───────────────────────────────────
    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;

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

    # ─── Serveur HTTPS Principal ───────────────────────────────
    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;

        # ─── En-têtes de Sécurité ─────────────────────────────
        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 d'Ingestion (webhooks d'intégration) ─────────
        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;
        }

        # Route d'ingestion héritée
        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;
        }

        # ─── Passerelle d'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;
        }

        # ─── Vérification de Santé ────────────────────────────
        location /health {
            access_log off;
            return 200 "healthy";
            add_header Content-Type text/plain;
        }

        # ─── Application 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;

            # Support 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;
        }
    }
}

Étape 5 : Créer la Configuration Docker Compose

Créez docker-compose.yml avec le contenu suivant :

services:
  # ─── Services Principaux ─────────────────────────────────────
  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:
      # Conserve le secret et le blob de licence auto-générés lors des mises à
      # jour d'image pour que `docker compose pull` ne régénère pas la licence.
      - 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

  # ─── Services de Traitement ──────────────────────────────────
  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

  # ─── Infrastructure ──────────────────────────────────────────
  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 Inverse ───────────────────────────────────────────
  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:

Besoin de la recherche entreprise (OpenSearch) ? L’Installateur de Bureau peut ajouter les services search-sync, opensearch et opensearch-dashboards pour vous. Pour la plupart des évaluations locales, la recherche basée sur PostgreSQL ci-dessus suffit amplement.

Étape 6 : Configurer le DNS Local

Ajoutez l’entrée suivante à votre fichier hosts :

Pour macOS et Linux :

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

Pour Windows :

Ajoutez la ligne suivante à C:\Windows\System32\drivers\etc\hosts :

127.0.0.1 local.casebender.com

Étape 7 : Démarrer l’Application

Téléchargez les images requises :

docker compose pull

Démarrez tous les services :

docker compose up -d

Surveillez les journaux :

docker compose logs -f

Accédez à l’application sur https://local.casebender.com

Identifiants de Connexion par Défaut

Après le déploiement de CaseBender, vous pouvez vous connecter avec les identifiants par défaut suivants :

Utilisateur : admin@casebender.app
Mot de passe : secret1234

Pour des raisons de sécurité, nous vous recommandons vivement de changer ces identifiants par défaut immédiatement après votre première connexion.

Fonctionnement derrière un proxy d’entreprise

Si votre hôte ne peut accéder à Internet qu’à travers un proxy HTTP d’entreprise (réseaux « proxy uniquement »), les appels sortants de CaseBender — activation de licence et intégrations telles que Microsoft Defender et Splunk — doivent être routés à travers celui-ci. Ajoutez les variables de proxy à votre .env :

HTTP_PROXY=http://proxy.example.com:8080
HTTPS_PROXY=http://proxy.example.com:8080
# Les services Docker internes (et toute cible on-prem) DOIVENT contourner le proxy :
NO_PROXY=127.0.0.1,localhost,db,redis,minio,api,ingestion,worker,workflow-processor,misp-processor,search-sync,opensearch

Transmettez-les ensuite à chaque service CaseBender en ajoutant ces lignes au bloc environment: de chaque service dans docker-compose.yml :

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

NO_PROXY doit inclure les noms des services Docker internes ci-dessus. Sinon, le trafic entre conteneurs (p. ex. l’application web appelant le service d’ingestion) est envoyé au proxy d’entreprise et échoue — cassant l’application même si cela n’a rien à voir avec Internet.

Quelles cibles passent par le proxy ? Les endpoints publics doivent passer par le proxy et NE doivent PAS figurer dans NO_PROXY — p. ex. Microsoft Defender (login.microsoftonline.com, graph.microsoft.com). Les cibles on-prem doivent être listées dans NO_PROXY pour être atteintes directement — p. ex. un Splunk HEC interne. Si vous utilisez Splunk Cloud, ne l’incluez pas afin qu’il soit routé via le proxy.

Vérifiez la connectivité depuis l’intérieur d’un conteneur (utilise node, sans 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))"

Lorsqu’un proxy est configuré, chaque service journalise [proxy] Outbound fetch routed through corporate proxy (...) au démarrage.

Dépannage

Problèmes Courants

Avertissements de Certificat :
- Le navigateur affichera un avertissement de sécurité car nous utilisons un certificat auto-signé
- Cliquez sur « Avancé » et poursuivez vers le site web
- À des fins de développement, ceci est attendu et sans danger
Conflits de Ports :
- Assurez-vous que les ports 80, 443, 3000, 3001, 3002, 3003, 3004, 3005, 5433, 6379, 9000 et 9090 ne sont pas utilisés
- Si nécessaire, modifiez les mappages de ports dans docker-compose.yml
Connexion à la Base de Données :
- Vérifiez les journaux PostgreSQL : docker compose logs db
- Vérifiez les identifiants de la base de données dans .env
- Assurez-vous que la base de données est en cours d’exécution : docker compose ps db
Dépendances des Services :
- Si les services ne démarrent pas, vérifiez leurs dépendances :
docker compose ps docker compose logs [nom_du_service]

Consulter les Journaux

Consultez les journaux de services spécifiques :

# Tous les services
docker compose logs

# Un service spécifique
docker compose logs [nom_du_service]

# Suivre les journaux
docker compose logs -f [nom_du_service]

Gestion des Services

# Redémarrer un service spécifique
docker compose restart [nom_du_service]

# Arrêter tous les services
docker compose down

# Supprimer les volumes (supprimera toutes les données)
docker compose down -v

Étapes Suivantes

Maintenant que CaseBender fonctionne localement, vous pourriez vouloir :

Déploiement en Production

Déployez CaseBender dans votre environnement de production

Configuration

Découvrez les options de configuration avancées

Mise en Route

Déploiement

Gestion des Alertes

Gestion des Dossiers

Gestion des Tâches

Analytique

Audits

Paramètres

Guide de Démarrage Rapide

Prérequis

Installation de Docker

Pour macOS :

Pour Linux (Ubuntu/Debian) :

Pour Windows :

Étape 1 : Créer le Répertoire du Projet

Étape 2 : Configurer les Variables d’Environnement

Étape 3 : Générer les Certificats SSL

Étape 4 : Configurer Nginx

Étape 5 : Créer la Configuration Docker Compose

Étape 6 : Configurer le DNS Local

Pour macOS et Linux :

Pour Windows :

Étape 7 : Démarrer l’Application

Identifiants de Connexion par Défaut

Fonctionnement derrière un proxy d’entreprise

Dépannage

Problèmes Courants

Consulter les Journaux

Gestion des Services

Étapes Suivantes

Déploiement en Production

Configuration

​Prérequis

​Installation de Docker

​Pour macOS :

​Pour Linux (Ubuntu/Debian) :

​Pour Windows :

​Étape 1 : Créer le Répertoire du Projet

​Étape 2 : Configurer les Variables d’Environnement

​Étape 3 : Générer les Certificats SSL

​Étape 4 : Configurer Nginx

​Étape 5 : Créer la Configuration Docker Compose

​Étape 6 : Configurer le DNS Local

​Pour macOS et Linux :

​Pour Windows :

​Étape 7 : Démarrer l’Application

​Identifiants de Connexion par Défaut

​Fonctionnement derrière un proxy d’entreprise

​Dépannage

​Problèmes Courants

​Consulter les Journaux

​Gestion des Services

​Étapes Suivantes

Déploiement en Production

Configuration

Prérequis

Installation de Docker

Pour macOS :

Pour Linux (Ubuntu/Debian) :

Pour Windows :

Étape 1 : Créer le Répertoire du Projet

Étape 2 : Configurer les Variables d’Environnement

Étape 3 : Générer les Certificats SSL

Étape 4 : Configurer Nginx

Étape 5 : Créer la Configuration Docker Compose

Étape 6 : Configurer le DNS Local

Pour macOS et Linux :

Pour Windows :

Étape 7 : Démarrer l’Application

Identifiants de Connexion par Défaut

Fonctionnement derrière un proxy d’entreprise

Dépannage

Problèmes Courants

Consulter les Journaux

Gestion des Services

Étapes Suivantes