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 ; --list ne 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.
  • --print expose 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. Utilisez unset aprè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.

--print

  • 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 -h ou pcSecretClient --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.