PcSecretd.wiki
KEYWORDS: PCSECRED, DAEMON
Le 15/11/2026:
pcSecretd
- Version : 1.03
- Date : 15/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. Chaque secret porte un commentaire (à quoi il sert, 256 octets maximum, UTF-8, sans caractère de contrôle) qui est chiffré avec lui : contrairement à l'indice du fichier, il n'est jamais lisible sans clé. Les fichiers de version 1 (secret unique) restent lisibles : leur secret est servi sous le nomdefault. La lecture accepte les versions 1, 2 et 3 ; l'écriture produit toujours la version 3 (un binaire antérieur refuse un fichier 3 : « version non supportée »).
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, commentés | Plusieurs secrets dans un seul coffre ; un client demande uniquement celui dont il a besoin. Le commentaire (chiffré) rappelle à quoi sert chaque secret. |
| É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 4 commandes, bibliothèque C++ libpcSecret (ClassPcSecret, voir libpcSecret.wiki), 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, 256 octets par commentaire, 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 | --enroll-machine | --hint | --set-hint | --show [NOM] | --set NOM | --comment NOM | --delete NOM | -h | --help]
Doit être exécuté en root (sauf aide). Une option inconnue est refusée (code 2). --show, --set, --comment, --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, valeur sans écho, puis commentaire facultatif ; nom vide pour terminer ;
defaultsi aucun nom au premier), puis l'indice (avec explications à l'écran). Demande confirmation avant de remplacer un coffre existant.
--enroll-machine
Enrôle CETTE machine dans un coffre existant, copié depuis un autre serveur. Demande la passphrase, crée /etc/pcvault/machine.key si absent, ajoute un keyslot machine et conserve ceux des autres serveurs (max 16). Idempotent. Les éditions (--set, --delete, gpcSecret) conservent tous les slots.
- Syntaxe :
pcSecretd --enroll-machine - Exemple (nouveau serveur) :
scp vieux:/etc/pcvault/secret.enc /etc/pcvault/ && pcSecretd --enroll-machine && systemctl restart pcSecretd
--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, le commentaire sur la ligne#qui précède) - Déchiffre le fichier directement (passphrase requise), sans passer par le daemon. Le commentaire n'est affiché que s'il n'est pas vide.
--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, puis commentaire : l'actuel est proposé, Entrée le conserve). L'ancien fichier est conservé en
secret.enc.bak.
--comment NOM
- Syntaxe :
pcSecretd --comment NOM - Exemple :
pcSecretd --comment rsync - Change seulement le commentaire du secret NOM (passphrase requise) : le texte qui rappelle à quoi sert le secret. Il est chiffré avec le secret (256 octets maximum, UTF-8, sans tabulation ni caractère de contrôle) ; un texte vide efface le commentaire. La valeur n'est pas retouchée, et rien n'est écrit si le texte est inchangé. Secret inconnu : refusé.
--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).
Envoyer le coffre sur un autre serveur
Le coffre est lié à la machine : copier secret.enc seul ne suffit pas (pcClaude obtient alors « 401 User not found », la clé du secret openrouter étant introuvable). Il faut aussi enrôler le serveur (--enroll-machine), qui ajoute un slot machine sans toucher aux autres.
Avec le script
.pcmakeSendPcSecret [-n] [SERVEUR] (dans le répertoire du projet ; SERVEUR = srv18 par défaut).
- Envoie, par rsync sur ssh :
pcSecretdetpcSecretClient(/home/local/bin),pcSecretd.service(/etc/systemd/system) et/etc/pcvault/secret.enc(mode 600). - Puis, sur le serveur (
ssh -t, passphrase saisie au clavier) :pcSecretd --enroll-machine,systemctl daemon-reload,enable,restartetis-active. -n: envoi seul, sans enrôlement ni démarrage.- Exemple :
./.pcmakeSendPcSecret srv18 - Prérequis : accès ssh par clé en root, rsync des deux côtés,
apt install libargon2-1 libssl3sur le serveur cible.
À la main
scp /etc/pcvault/secret.enc srv18:/etc/pcvault/ ssh -t srv18 pcSecretd --enroll-machine ssh srv18 systemctl enable --now pcSecretd
Après une modification du coffre
Après un --set, --delete ou une édition par gpcSecret, renvoyer secret.enc aux autres serveurs (./.pcmakeSendPcSecret -n SERVEUR). Leur slot machine reste valide : pas de nouvel enrôlement. Ne pas éditer avec un ancien binaire (antérieur à --enroll-machine) : il supprimerait les slots des autres serveurs.
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
|
LISTX |
OK + une ligne nom<TAB>commentaire par secret (jamais les valeurs)
|
| erreurs | ERR DENIED, ERR UNKNOWN, ERR NOTFOUND, ERR INTERNAL
|
Interface graphique
gpcSecret (voir gpcSecret.wiki) partage la classe d'édition ClassVaultEditor avec --show/--set/--comment/--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