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

De wiki_pcwiki2
Aller à la navigationAller à la recherche

KEYWORDS: GPCSECRET

Le 15/11/2026:
pcSecretd.wiki
pcSecretClient
libpcSecret

gpcSecret

  • Version : 1.03
  • Date : 15/11/2026

Fonctionnement

Interface graphique (Qt6 Widgets) du coffre-fort pcSecretd. Elle demande la passphrase (3 essais, l'indice est affiché), déchiffre /etc/pcvault/secret.enc et permet :

  • de lister les secrets nommés, avec un champ de recherche ;
  • d'afficher la valeur en clair ;
  • de copier la valeur dans le presse-papiers (effacé après 30 s) ;
  • d'ajouter, modifier (double-clic) et supprimer un secret ; le dialogue demande aussi un commentaire facultatif (« à quoi sert ce secret », 256 octets maximum, sans tabulation ni caractère de contrôle), affiché sous la valeur du secret sélectionné ; le dernier secret ne peut pas être supprimé ;
  • de modifier l'indice en clair (menu Fichier > Modifier l'indice…, avec explications : il est lisible par tous et ne doit pas révéler la passphrase) ;
  • d'enregistrer sur disque (bouton ou Ctrl+S) : l'ancien fichier est conservé en secret.enc.bak (0600), l'écriture est atomique ; à la fermeture, une confirmation est demandée s'il reste des modifications ;
  • de choisir un thème (menu Thème) ;
  • de vérifier au lancement que le daemon pcSecretd tourne et, sinon, de le lancer automatiquement (voir ci-dessous).

Les fenêtres (déverrouillage, fenêtre principale, dialogues) s'ouvrent, centrées, sur l'écran où se trouve le pointeur au lancement, donc normalement celui du terminal d'où l'appli a été lancée ; à défaut, l'écran principal.

Lancement automatique du daemon

Au démarrage, une fois la passphrase saisie, l'application vérifie en arrière-plan (sans bloquer l'interface) que le socket /run/pcvault.sock accepte les connexions :

  • daemon actif : rien n'est fait (« Daemon : actif ● » dans la barre d'état) ;
  • daemon arrêté : l'application le lance : par systemctl start pcSecretd si l'unité systemd est installée (/etc/systemd/system/pcSecretd.service), sinon directement par pcSecretd --auto, détaché de l'application (il continue de tourner après sa fermeture). Sa sortie est écrite dans /run/pcvault-start.log (0600) ;
  • affichage : quand l'application a lancé le daemon, elle l'annonce dans un bandeau sous le titre (« ✔ Daemon pcSecretd lancé (pid …). Démarré directement en mode --auto… », fermable, masqué seul après 20 s), dans la barre d'état et par le témoin « Daemon : lancé ● » ; pendant le lancement, un bandeau « lancement automatique en cours… » est affiché ;
  • échec (clé machine modifiée, noyau sans memfd_secret, binaire introuvable…) : une boîte de dialogue affiche la cause (fin de la sortie du daemon) et la commande à lancer à la main.

Le programme pcSecretd est cherché à côté de l'exécutable gpcSecret, puis dans /home/local/bin, puis dans le PATH. Le lancement automatique est désactivé avec --no-daemon, et aussi quand --file désigne un autre coffre que celui par défaut (un coffre d'essai n'a rien à voir avec le daemon réel).

Avantages

  • Plus confortable que la ligne de commande : liste, recherche, affichage à la demande, copie en un clic, édition avec confirmation, une seule saisie de passphrase pour toute la session.
  • Presse-papiers prudent : la valeur copiée est effacée après 30 s et à la fermeture, uniquement si le presse-papiers contient encore cette valeur (comparaison par empreinte SHA-256, la valeur n'est pas conservée).
  • Valeurs affichées en clair : aucun masquage par des points (choix voulu) ; quiconque voit l'écran voit les secrets.
  • Même cœur que le programme en ligne de commande : la classe ClassVaultEditor est partagée avec pcSecretd --show/--set/--comment/--delete/--set-hint : mêmes règles, mêmes formats (y compris le commentaire chiffré de chaque secret) ; toute évolution profite aux deux.
  • Édition sûre : écriture atomique, sauvegarde secret.enc.bak à chaque enregistrement, validation des noms et des valeurs avant toute modification, confirmation avant de fermer avec des modifications non enregistrées.
  • Daemon toujours disponible : s'il est arrêté, il est relancé automatiquement au démarrage de l'interface.
  • Fonctionne sans le daemon : lit et écrit secret.enc directement (passphrase requise).
  • Confort visuel : plus de 40 thèmes, thèmes personnalisés autour d'une couleur, lisibilité vérifiée automatiquement (contraste WCAG).

Défauts et limites

  • Protection mémoire « au mieux » : la passphrase et les valeurs transitent par des QString de Qt, qui ne peuvent pas être effacés de façon garantie ; seuls les tampons C++ (std::string) le sont. Le processus est non dumpable et sans core dump, mais ce n'est pas l'équivalent du memfd_secret du daemon.
  • Presse-papiers lisible : pendant 30 s, tout programme de la session peut lire la valeur copiée (et un gestionnaire d'historique du presse-papiers peut la conserver).
  • Affichage à l'écran : une valeur affichée peut être vue par une personne ou une capture d'écran.
  • Le daemon est lancé en --auto (clé machine, sans saisie) : c'est le mode le moins strict (voir pcSecretd.wiki), même si vous avez déverrouillé l'interface par passphrase. Pour un daemon déverrouillé par passphrase, lancez-le vous-même dans un terminal avant l'interface.
  • Pas de redémarrage automatique après édition : si le daemon tournait déjà, il garde l'ancienne version.
  • Passphrase obligatoire : pas de déverrouillage par clé machine dans l'interface (la passphrase sert aussi à réécrire le fichier).
  • Le daemon n'est pas mis à jour : un pcSecretd en cours garde l'ancienne version et doit être redémarré après un enregistrement.
  • Pas de changement de passphrase dans l'interface (ré-enrôlement par pcSecretd --enroll).
  • Prérequis : session graphique et Qt6 ; lancement en root pour le fichier par défaut ; icônes en symboles Unicode (police du type Symbola, sinon des carrés peuvent apparaître) ; interface en français uniquement.
  • Placement des fenêtres : sous X11, l'écran du lanceur n'est pas connu ; on prend celui du pointeur au démarrage.

Syntaxe

gpcSecret [--file CHEMIN] [--conf DOSSIER] [--no-daemon] [--theme ID] [--list-themes] [-h | --help]

Options : syntaxe et exemple

(aucune option)

  • Syntaxe : gpcSecret
  • Exemple : gpcSecret
  • Ouvre /etc/pcvault/secret.enc avec le thème mémorisé.

--file CHEMIN

  • Syntaxe : gpcSecret --file CHEMIN
  • Exemple : gpcSecret --file /tmp/essai/secret.enc
  • Ouvre un autre fichier chiffré (utile pour essayer sans toucher au coffre réel).

--conf DOSSIER

  • Syntaxe : gpcSecret --conf DOSSIER
  • Exemple : gpcSecret --file /tmp/essai/secret.enc --conf /tmp/essai
  • Dossier contenant machine.key (défaut : /etc/pcvault) ; à utiliser avec --file.

--no-daemon

  • Syntaxe : gpcSecret --no-daemon
  • Exemple : gpcSecret --no-daemon
  • Ne vérifie pas et ne lance pas le daemon (par défaut il est lancé en --auto s'il ne tourne pas).

--theme ID

  • Syntaxe : gpcSecret --theme ID
  • Exemple : gpcSecret --theme neon
  • Choisit le thème visuel ; il est mémorisé pour les lancements suivants. Identifiant inconnu : refusé (code 2).

--list-themes

  • Syntaxe : gpcSecret --list-themes
  • Exemple : gpcSecret --list-themes
  • Liste les identifiants et noms des thèmes (intégrés et personnalisés) et quitte.

-h, --help

  • Syntaxe : gpcSecret -h ou gpcSecret --help
  • Exemple : gpcSecret --help
  • Affiche l'aide et quitte.

Raccourcis et menus

  • Raccourcis : Ctrl+S enregistrer, Ctrl+Q quitter, Ctrl+T thème suivant, Ctrl+Maj+T thème au hasard.
  • Fichier : Enregistrer, Modifier l'indice…, Quitter.
  • Thème : Sombres, Clairs, Personnalisés, Thème suivant, Thème au hasard, Créer un thème depuis une couleur…, Modifier le thème actuel…, Supprimer le thème actuel.
  • Aide : À propos.

Thèmes

Menu Thème : plus de 40 thèmes intégrés rangés en sous-menus Sombres, Clairs et Personnalisés ; Thème suivant (Ctrl+T) ; Thème au hasard (Ctrl+Maj+T). Le choix est mémorisé (seul l'identifiant du thème, dans la configuration Qt de root). gpcSecret --list-themes donne tous les identifiants.

Exemples : sombres — sombre (défaut), neon, matrix, dracula, nord, solarized-sombre, monokai, gruvbox-sombre, mocha, synthwave, ambre, gameboy, dos, contraste-noir… ; clairs — clair, bonbon, papier, menthe, lavande, solarized-clair, sable, contraste-blanc…

Chaque thème est une ligne de couleurs dans ClassThemeManager.cpp : palette, feuille de style, bandeau en dégradé et icônes sont générés à partir d'elle.

Détails de rendu

Les cases cochées affichent une vraie coche ✓ (petite image générée dans le cache de l'utilisateur, `~/.cache/…/gpc-theme/`, une par couleur ; sans accès au cache, la case reste un aplat de la couleur d'accent). Les noms des thèmes intégrés existent en français et en anglais (`ClassThemeManager::setLanguage("UK")` ; gpcSecret reste en français).

Lisibilité garantie

Pour chaque thème (intégré ou personnalisé), les couleurs sont corrigées automatiquement (teinte conservée, seule la luminosité bouge) pour que chaque texte se lise sur son fond selon le contraste WCAG : texte courant ≥ 4,5 (fond, panneau, survol, bouton enfoncé, sélection, bandeau, bouton danger), éléments atténués et accents ≥ 3. Les champs de saisie sont aussi garantis distincts : le fond des champs et des listes se démarque du fond de fenêtre (contraste de luminance ≥ 1,3, ou écart de teinte net ΔE ≥ 12 : un jaune pâle se distingue du blanc sans être assombri) et ils sont cernés d'une bordure visible (≥ 2,2 par rapport à l'intérieur, ≥ 1,5 par rapport au fond) : un thème clair n'a donc jamais un fond presque blanc qui masque les champs. Les couleurs d'identité (accent, seconde couleur, danger) gardent leur teinte d'origine : elles ne servent qu'en aplat, avec un texte noir ou blanc dessus ; quand elles servent de texte, d'icône ou de bordure, des variantes de luminosité ajustée sont utilisées. Le test TestThemeContrast (ctest) contrôle plus de 26 000 paires texte/fond sur tous les thèmes intégrés et un balayage de milliers de couleurs dominantes (jaune, cyan, gris, noir, blanc inclus).

Modifier un thème

Menu Thème > Modifier le thème actuel… ouvre le même dialogue, prérempli :

  • sur un thème personnalisé : on change la couleur dominante, la seconde couleur (automatique ou choisie), le mode ou le nom ; changer le nom renomme le thème (si le nouveau nom existe déjà, une confirmation est demandée) ;
  • sur un thème intégré : il n'est jamais altéré ; le dialogue crée une copie personnalisée (nom proposé « nom (perso) ») que l'on peut ensuite modifier à volonté.

L'aperçu (bandeau, panneau, fond avec de vrais textes) se met à jour en direct, et les règles de lisibilité s'appliquent quelles que soient les couleurs choisies.

Thème depuis une couleur dominante

Menu Thème > Créer un thème depuis une couleur… : on choisit une couleur, un mode (sombre ou clair) et un nom. Le nom proposé est celui de la couleur la plus proche (noms SVG : orange, steelblue…), modifiable. Le thème est décliné autour de la couleur : fonds teintés, accent, seconde teinte (+35° de teinte), texte, bordures, avec un aperçu en direct (vrais textes sur bandeau, panneau et fond). Les couleurs sont ajustées pour rester lisibles (le jaune devient plus doré : texte foncé sur le bandeau). Il est enregistré sous ce nom (identifiant perso-<nom>, utilisable avec --theme) et apparaît dans le menu. Thème > Supprimer le thème actuel retire un thème personnalisé (les thèmes intégrés ne sont pas supprimables).

Compilation

apt install qt6-base-dev libargon2-dev libssl-dev
cd build && cmake .. && make

Sans Qt6, cmake ignore gpcSecret et construit le reste.