Info::pcSecretd comment protéger un secret en unix
KEYWORDS: PCSECRETD, DAEMON
Le 12/11/2026:
pcSecretd
- Version : 1.02
- Date : 12/11/2026
Fonctionnement
Daemon de coffre-fort pour root. Il déchiffre /etc/pcvault/secret.enc (AES-256-GCM, deux keyslots : passphrase et clé machine), charge les secrets nommés dans une mémoire noyau protégée (memfd_secret) et les sert, sur le socket Unix /run/pcvault.sock, aux clients dont l'uid est 0 (vérifié par SO_PEERCRED). Le secret n'est jamais écrit en clair sur disque.
- Chiffrement : une clé aléatoire (DEK) chiffre les données ; elle est « enveloppée » dans deux keyslots, l'un dérivé de la passphrase (argon2id), l'autre de la machine (
machine.key+product_uuidDMI +machine-id). - Durcissement du processus : non dumpable (
PR_SET_DUMPABLE=0),RLIMIT_CORE=0,umask 077; socket en 0600 dès sa création ; un client muet est déconnecté après 5 s. - Secrets nommés : jusqu'à 32 secrets, nom de 1 à 64 caractères parmi
A-Za-z0-9_.-, valeur de 1 à 4096 octets. Les fichiers de version 1 (secret unique) restent lisibles : leur secret est servi sous le nomdefault. Tout nouvel enrôlement écrit le format version 2.
Avantages
Par rapport à un simple fichier en chmod 700 appartenant à root :
| Avantage | Pourquoi c'est utile |
|---|---|
| Chiffrement au repos (AES-256-GCM, argon2id) | Un disque volé, un backup ou un snapshot ne révèlent pas les secrets ; un fichier chmod 700 est lisible en clair par quiconque monte le disque.
|
| Jamais de secret en clair sur disque | Les secrets ne vivent qu'en mémoire, dans un memfd_secret : ni swap, ni /proc/<pid>/mem, ni ptrace, même pour root.
|
| Double déverrouillage | Passphrase (manuel, sûr) ou clé machine (--auto, démarrage sans intervention) : on choisit entre sécurité maximale et commodité.
|
| Détection d'altération | AES-GCM authentifie le contenu ; l'indice est lié au fichier (AAD) : toute modification du fichier est détectée au déchiffrement. |
| Liaison à la machine | Le slot machine ne s'ouvre pas si le fichier est copié sur un autre matériel (product_uuid).
|
| Contrôle d'accès à la connexion | SO_PEERCRED : l'identité du client vient du noyau, elle ne peut pas être falsifiée par le client.
|
| Secrets nommés | Plusieurs secrets dans un seul coffre ; un client demande uniquement celui dont il a besoin. |
| Édition sûre | Écriture atomique (fichier temporaire + rename), sauvegarde secret.enc.bak avant chaque modification : un crash ne détruit jamais le coffre.
|
| Journalisation des accès | Chaque requête (uid, pid, nom du secret, résultat) est tracée sur la sortie du daemon (journald avec systemd). |
| Simple à intégrer | Socket + protocole texte de 3 commandes, classe C++ ClassVaultClient, client en ligne de commande, interface graphique gpcSecret.
|
| Léger et testé | C++17, dépendances minimales (argon2, OpenSSL) ; tests automatisés (ctest) du chiffrement, du format, de l'édition, du serveur.
|
Défauts et limites
| Limite | Détail |
|---|---|
| Ne protège pas contre un root actif sur la machine en marche | Un attaquant root peut interroger le socket, lire machine.key puis ouvrir le slot machine, ou lire la mémoire par un module noyau. Le vault protège les données au repos, pas un système déjà compromis.
|
| Tous les root se valent | Pas de contrôle par programme ou par secret : tout processus d'uid 0 obtient tous les secrets. (Une liste blanche par exécutable est une amélioration possible, non faite.) |
Le mode --auto est moins sûr |
La clé machine se reconstitue à partir d'éléments stockés sur la machine (machine.key, machine-id) et d'éléments matériels lisibles par root (product_uuid). Il protège contre le vol du seul secret.enc, pas contre quelqu'un qui possède le matériel ou connaît l'UUID. Pas de TPM.
|
| Perte irrécupérable | Passphrase oubliée ET machine.key perdu (ou matériel changé) : les secrets sont perdus. Pensez à sauvegarder /etc/pcvault séparément du disque.
|
| Pas de rechargement à chaud | Après --set, --delete ou une édition par gpcSecret, le daemon garde l'ancienne version : il faut le redémarrer.
|
| Pas de changement de passphrase | Aucune commande dédiée : il faut ré-enrôler (--enroll).
|
| Prérequis noyau | memfd_secret exige Linux ≥ 5.14 avec CONFIG_SECRETMEM=y ; sinon le daemon refuse de démarrer (volontairement : pas de repli en mémoire non protégée).
|
| Capacité bornée | 32 secrets, 4096 octets par valeur, noms restreints. |
| Daemon séquentiel | Un client à la fois (suffisant pour l'usage visé, pas pour une charge élevée). |
| Valeurs visibles à l'affichage | --show et pcSecretClient --print écrivent le secret en clair dans le terminal ou une variable : à utiliser avec précaution.
|
| Journal sans valeurs, mais sans signature | Les journaux d'accès ne sont pas protégés contre une modification par root. |
Syntaxe
pcSecretd [--auto | --enroll | --hint | --set-hint | --show [NOM] | --set NOM | --delete NOM | -h | --help]
Doit être exécuté en root (sauf aide). Une option inconnue est refusée (code 2). --show, --set, --set-hint et --delete travaillent hors daemon.
Options : syntaxe et exemple
(aucune option)
- Syntaxe :
pcSecretd - Exemple :
pcSecretd - Déverrouillage manuel : demande la passphrase (3 essais, l'indice est affiché), charge les secrets en mémoire protégée, puis écoute sur le socket.
--auto
- Syntaxe :
pcSecretd --auto - Exemple :
pcSecretd --auto - Déverrouillage automatique par la clé machine, sans saisie (démarrage systemd). Échoue si le matériel ou
machine.keyont changé.
--enroll
- Syntaxe :
pcSecretd --enroll - Exemple :
pcSecretd --enroll - Crée le coffre : passphrase (confirmée), puis un ou plusieurs secrets (nom puis valeur sans écho ; nom vide pour terminer ;
defaultsi aucun nom au premier), puis l'indice (avec explications à l'écran). Demande confirmation avant de remplacer un coffre existant.
--hint
- Syntaxe :
pcSecretd --hint - Exemple :
pcSecretd --hint - Affiche l'indice en clair, sans aucune clé.
--set-hint
- Syntaxe :
pcSecretd --set-hint - Exemple :
pcSecretd --set-hint - Change l'indice (passphrase requise). L'indice est lisible par tous : il doit aider à retrouver la passphrase sans la révéler. Refusé s'il contient la passphrase, un saut de ligne, ou dépasse 200 octets.
--show [NOM]
- Syntaxe :
pcSecretd --show [NOM] - Exemples :
pcSecretd --show rsync(la valeur seule) ;pcSecretd --show(tous, au formatnom = valeur) - Déchiffre le fichier directement (passphrase requise), sans passer par le daemon.
--set NOM
- Syntaxe :
pcSecretd --set NOM - Exemple :
pcSecretd --set rsync - Ajoute ou modifie le secret NOM (passphrase requise ; valeur saisie sans écho, confirmée deux fois). L'ancien fichier est conservé en
secret.enc.bak.
--delete NOM
- Syntaxe :
pcSecretd --delete NOM - Exemple :
pcSecretd --delete rsync - Supprime le secret NOM (passphrase requise). Le dernier secret ne peut pas être supprimé (utiliser
--enroll).
-h, --help
- Syntaxe :
pcSecretd -houpcSecretd --help - Exemple :
pcSecretd --help - Affiche l'aide et quitte (utilisable sans être root).
Protocole du socket
Une requête par connexion.
| Requête | Réponse |
|---|---|
GET <nom> |
OK + valeur
|
GET_SECRET |
équivaut à GET default (compatibilité V1.01)
|
LIST |
OK + noms séparés par des sauts de ligne
|
| erreurs | ERR DENIED, ERR UNKNOWN, ERR NOTFOUND, ERR INTERNAL
|
Interface graphique
gpcSecret (voir gpcSecret.wiki) partage la classe d'édition ClassVaultEditor avec --show/--set/--delete/--set-hint.
Service systemd
systemd/pcSecretd.service : démarre pcSecretd --auto avec un durcissement (aucune capability, réseau privé, MemoryDenyWriteExecute, LimitCORE=0, ProtectHome=read-only, etc.). Installation : systemctl daemon-reload puis systemctl enable --now pcSecretd.
Tests
cd build && cmake .. && make && ctest --output-on-failure