PcSecretd.wiki

De wiki_pcwiki2
Version datée du 15 novembre 2026 à 16:35 par Pchevalier (discussion | contributions) (Page créée avec « 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 <code>/etc/pcvault/secret.enc</code> (AES-256-GCM, deux keyslots : passphrase et clé machine), charge les secrets nommés dans une mémoire noyau protégée (<code>memfd_secret</code>) et les sert, sur le socket Unix <code>/run/pcvault.sock</code>, aux clients dont l'uid est 0 (vér... »)
(diff) ← Version précédente | Version actuelle (diff) | Version suivante → (diff)
Aller à la navigationAller à la recherche

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_uuid DMI + 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 nom default. 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.key ont 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 ; default si 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 format nom = 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 -h ou pcSecretd --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 : pcSecretd et pcSecretClient (/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, restart et is-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 libssl3 sur 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