Info::pcSecretd comment protéger un secret en unix

De wiki_pcwiki2
Aller à la navigationAller à la recherche

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_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. Les fichiers de version 1 (secret unique) restent lisibles : leur secret est servi sous le nom default. 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.key ont 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 ; default si 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 format nom = 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 -h ou pcSecretd --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