Info::pcSecretClient comment protéger un secret en unix
De wiki_pcwiki2
Aller à la navigationAller à la recherche
KEYWORDS: PCSECRETCLIENT
Le 12/11/2026:
pcSecretClient
- Version : 1.02
- Date : 12/11/2026
Fonctionnement
Client en ligne de commande du vault pcSecretd. Il se connecte au socket /run/pcvault.sock et demande un secret par son nom, ou la liste des noms. Seul root est autorisé. Par défaut le secret n'est pas affiché (seule sa longueur l'est) ; --print l'écrit en clair sur stdout.
Dans un programme C++, on utilise directement la classe ClassVaultClient : fetchSecret("nom") et listSecrets().
Avantages
- Le secret n'est jamais sur disque : un script le récupère à l'exécution, au lieu de le stocker dans un fichier de configuration ou dans le script.
- Par défaut, rien n'est affiché : sans
--print, seule la longueur apparaît, ce qui permet de tester l'accès sans exposer la valeur. - Un seul secret à la fois : on ne demande que celui dont on a besoin ;
--listne révèle jamais les valeurs. - Sortie propre pour les scripts : avec
--print, la valeur est seule sur stdout (messages sur stderr), sans saut de ligne parasite hors terminal :pw=$(pcSecretClient --print nom). - Code de retour exploitable : 0 succès, 1 erreur, 2 option inconnue.
- Copie effacée : la copie du secret en mémoire du client est effacée (
explicit_bzero) dès l'usage terminé.
Défauts et limites
- Réservé à root : le daemon refuse tout autre uid.
- Pas de contrôle par programme : n'importe quel processus root peut demander n'importe quel secret.
--printexpose le secret : la valeur apparaît dans le terminal, ou dans une variable de script qui peut finir dans l'environnement, l'historique ou un journal si le script est mal écrit. Utilisezunsetaprès usage, et ne l'écrivez jamais dans un fichier.- Le daemon doit tourner (et être déverrouillé) : sinon
Connexion à pcSecretd échouée. - Vue figée : après une modification du coffre, le daemon (donc le client) sert l'ancienne version jusqu'à son redémarrage.
- Efface au mieux : seule la copie du client est effacée ; les copies intermédiaires d'un script shell ne le sont pas.
Syntaxe
pcSecretClient [--print] [--list] [NOM]
NOM : nom du secret (défaut : default).
Options : syntaxe et exemple
(aucune option)
- Syntaxe :
pcSecretClient [NOM] - Exemple :
pcSecretClient db_pg - Vérifie l'accès au secret NOM et affiche seulement sa longueur.
- Syntaxe :
pcSecretClient --print [NOM] - Exemple :
pw=$(pcSecretClient --print db_pg) - Écrit le secret seul sur stdout. Sur un terminal un saut de ligne est ajouté ; dans
$(...)ou un tube, la valeur reste exacte.
--list
- Syntaxe :
pcSecretClient --list - Exemple :
pcSecretClient --list - Liste les noms des secrets disponibles, un par ligne, jamais les valeurs.
-h, --help
- Syntaxe :
pcSecretClient -houpcSecretClient --help - Exemple :
pcSecretClient --help - Affiche l'aide et quitte.
Code de retour
0 succès ; 1 erreur (daemon absent, accès refusé, secret inconnu) ; 2 option inconnue.