Aller au contenu

Liste de contrôle sécurité

KiwiDesk garde des données sensibles : coordonnées des clients, codes de déverrouillage de leurs appareils, pièces d’identité du registre de police, factures. Parcourez cette liste avant d’ouvrir l’instance à l’équipe, puis une fois par an.

Serveur et réseau

  • KiwiDesk est servi en HTTPS, avec COOKIE_SECURE=true (Reverse proxy et HTTPS).
  • Seuls les ports 80 et 443 du reverse proxy sont ouverts sur Internet ; pas le 3000, ni le 4000, ni le 5432 (l’API et la base sont publiées sur 127.0.0.1 uniquement).
  • WEB_TRUSTED_PROXIES contient l’adresse du reverse proxy et rien d’autre ; TRUST_PROXY vaut 1.
  • Le système du serveur reçoit ses mises à jour de sécurité.

Secrets

  • POSTGRES_PASSWORD, ENCRYPTION_KEY, JWT_ACCESS_SECRET et JWT_REFRESH_SECRET sont générés aléatoirement et propres à cette instance ; plus aucune valeur CHANGE-ME.
  • ENCRYPTION_KEY est rangée dans un coffre-fort, à part des sauvegardes.
  • Le fichier .env n’est lisible que par l’administrateur (chmod 600 .env).
  • SWAGGER_ENABLED=false.

Comptes

  • Le mot de passe initial du super administrateur a été changé et la double authentification activée sur ce compte.
  • Paramètres > Sécurité > Double authentification est réglée au moins sur Administrateurs et rôles sensibles (Double authentification).
  • Chaque personne a son propre compte, avec le rôle le plus restreint qui lui suffit (Rôles et permissions).
  • Le verrouillage automatique des sessions est réglé (Paramètres > Sécurité > Sessions & verrouillage) (Verrouillage et postes de travail).

Données

Matériel et services

  • La page locale du Bridge n’est ouverte au réseau qu’avec un code d’accès, et seulement si c’est utile (Accès depuis un autre poste).
  • Les clés API créées ont les seules permissions nécessaires et sont révoquées quand elles ne servent plus.
  • Mots de passe hachés avec Argon2id ; tentatives de connexion limitées par adresse et compte verrouillé après plusieurs échecs.
  • Sessions courtes (jeton de 15 minutes) renouvelées par un cookie HttpOnly, révocables depuis Mon compte.
  • Codes de déverrouillage, secrets de double authentification, mots de passe SMTP, IMAP et SMS, clés des fournisseurs d’IA et numéros de pièces d’identité chiffrés en AES-256-GCM.
  • Chaque lecture d’un code de déverrouillage, chaque connexion et chaque changement de réglage sont inscrits au journal d’audit, que personne ne peut modifier.
  • Les webhooks ne visent que des adresses publiques, sauf exceptions listées dans WEBHOOK_ALLOWED_PRIVATE_TARGETS.

Changez ENCRYPTION_KEY si elle a pu être exposée (ancien prestataire, fichier .env copié par erreur). Ne la remplacez jamais directement : les données chiffrées avec l’ancienne deviendraient illisibles. La procédure garde l’ancienne clé le temps de tout rechiffrer.

  1. Générer une nouvelle clé : openssl rand -base64 32.

  2. Modifier .env : déplacez la clé actuelle dans ENCRYPTION_PREVIOUS_KEYS sous la forme <version>:<clé>, mettez la nouvelle dans ENCRYPTION_KEY et augmentez ENCRYPTION_KEY_VERSION :

    ENCRYPTION_KEY=<nouvelle clé>
    ENCRYPTION_KEY_VERSION=2
    ENCRYPTION_PREVIOUS_KEYS=1:<ancienne clé>
  3. Redémarrer l’API : docker compose -f docker-compose.yml up -d api. Les nouvelles valeurs utilisent la nouvelle clé ; les anciennes restent lisibles.

  4. Rechiffrer les anciennes valeurs, d’abord à blanc, puis pour de bon :

    Fenêtre de terminal
    docker compose -f docker-compose.yml exec -w /app/apps/api api node dist/scripts/reencrypt.js --dry-run
    docker compose -f docker-compose.yml exec -w /app/apps/api api node dist/scripts/reencrypt.js

    La commande avance par lots, peut être interrompue et relancée, et inscrit l’opération au journal d’audit. Elle se termine avec le code 2 si une valeur n’a pas pu être déchiffrée.

  5. Retirer l’ancienne clé de ENCRYPTION_PREVIOUS_KEYS quand la commande ne signale plus aucun échec, puis redémarrez l’API.