Aller au contenu principal

Chiffrement et secrets

Les mots de passe et les clés des fichiers de configuration sont stockés chiffrés, sous forme de valeurs ENC:…, avec la clé maître de l'installation. Le serveur les déchiffre au chargement des fichiers.


Ce qui est chiffré​

Chaque champ secret est chiffré à l'enregistrement depuis les pages Liberty Next :

OùChamp
Liberty Next → Administrer → PoolsLe mot de passe du pool.
Liberty Next → Données → Connecteurs (connecteurs API)Identifiants, jetons, secrets client.
Liberty Next → Administrer → AppLa clé de licence, la clé de l'IA, le secret client OpenID Connect, le mot de passe SMTP.

Le champ est une saisie masquée — le mot de passe d'un pool avec un œil pour en afficher le contenu. Une nouvelle valeur est toujours écrite chiffrée ; sans clé maître, l'enregistrement est refusé.


La clé maître​

La clé maître vient de la variable d'environnement LIBERTY_MASTER_KEY. La clé est une phrase secrète : la clé de chiffrement en est dérivée (PBKDF2), et chaque valeur est chiffrée en AES-256-GCM.

  • L'installation Docker la génère dans release/.env ; une installation Python la définit dans le fichier d'environnement du service.
  • En garder une copie hors du serveur : une sauvegarde est inutilisable sans elle.
  • Ne jamais la changer sur une installation existante : toutes les valeurs ENC: deviendraient illisibles et les pools ne se connecteraient plus. ./liberty doctor vérifie qu'elle déchiffre bien chaque mot de passe de pool.

Autres façons de fournir un secret​

FaçonQuand
${VARIABLE} dans le fichierLe secret vient de l'environnement ou d'un gestionnaire de secrets. Les pages Liberty Next affichent la référence telle quelle.
<NOM>_FILEPour les variables LIBERTY_*, POSTGRES_* et PGADMIN_* : la valeur est lue dans un fichier (secrets Docker, Swarm ou Kubernetes).
liberty-crypto encryptPour écrire à la main une valeur ENC: dans un fichier : liberty-crypto encrypt lit la valeur sur son entrée standard et affiche ENC:…. Voir CLI.

Mots de passe des utilisateurs​

Les mots de passe de connexion des utilisateurs locaux ne sont pas chiffrés mais hachés (Argon2id) : ils ne peuvent pas être relus. Un mot de passe oublié se remplace avec liberty-admin set-password.