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.
Avant l’ouverture
Section intitulée « Avant l’ouverture »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 le4000, ni le5432(l’API et la base sont publiées sur127.0.0.1uniquement). -
WEB_TRUSTED_PROXIEScontient l’adresse du reverse proxy et rien d’autre ;TRUST_PROXYvaut1. - Le système du serveur reçoit ses mises à jour de sécurité.
Secrets
-
POSTGRES_PASSWORD,ENCRYPTION_KEY,JWT_ACCESS_SECRETetJWT_REFRESH_SECRETsont générés aléatoirement et propres à cette instance ; plus aucune valeurCHANGE-ME. -
ENCRYPTION_KEYest rangée dans un coffre-fort, à part des sauvegardes. - Le fichier
.envn’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
- Les sauvegardes tournent, sont copiées hors du serveur et une restauration a été testée (Sauvegarde et restauration).
- La Santé de l’instance est verte (Surveillance et santé).
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.
Ce que KiwiDesk fait de lui-même
Section intitulée « Ce que KiwiDesk fait de lui-même »- 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.
Rotation de la clé de chiffrement
Section intitulée « Rotation de la clé de chiffrement »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.
-
Générer une nouvelle clé :
openssl rand -base64 32. -
Modifier
.env: déplacez la clé actuelle dansENCRYPTION_PREVIOUS_KEYSsous la forme<version>:<clé>, mettez la nouvelle dansENCRYPTION_KEYet augmentezENCRYPTION_KEY_VERSION:ENCRYPTION_KEY=<nouvelle clé>ENCRYPTION_KEY_VERSION=2ENCRYPTION_PREVIOUS_KEYS=1:<ancienne clé> -
Redémarrer l’API :
docker compose -f docker-compose.yml up -d api. Les nouvelles valeurs utilisent la nouvelle clé ; les anciennes restent lisibles. -
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-rundocker compose -f docker-compose.yml exec -w /app/apps/api api node dist/scripts/reencrypt.jsLa 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
2si une valeur n’a pas pu être déchiffrée. -
Retirer l’ancienne clé de
ENCRYPTION_PREVIOUS_KEYSquand la commande ne signale plus aucun échec, puis redémarrez l’API.