PcSecretClient

De wiki_pcwiki2
Aller à la navigationAller à la recherche

KEYWORDS: PCSECRETCLIENT

Le 15/11/2026:

pcSecretClient

  • Version : 1.03
  • Date : 15/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, la liste des noms, ou la liste des noms avec leur commentaire. 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. Le commentaire (à quoi sert le secret) est chiffré dans le coffre : --info le révèle, mais jamais les valeurs.

Dans un programme C++, utiliser la bibliothèque libpcSecret (classes ClassPcSecret et ClassSecureString) : voir libpcSecret.wiki et libpcSecret.txt. Le client en ligne de commande s'appuie sur la classe interne ClassVaultClient.

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 et --info ne révèlent jamais les valeurs (--info ajoute seulement le commentaire).
  • 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 | --info] [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.

--info

  • Syntaxe : pcSecretClient --info
  • Exemple : pcSecretClient --info
  • Liste les noms ET leur commentaire, une ligne nom<TAB>commentaire par secret (le commentaire est vide s'il n'y en a pas). Jamais les valeurs. Un NOM ou --print donnés en plus sont ignorés : --info est traité en premier.

-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.