<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="fr">
	<id>https://pcwiki.pcstreet.org/index.php?action=history&amp;feed=atom&amp;title=PcSecretClient</id>
	<title>PcSecretClient - Historique des versions</title>
	<link rel="self" type="application/atom+xml" href="https://pcwiki.pcstreet.org/index.php?action=history&amp;feed=atom&amp;title=PcSecretClient"/>
	<link rel="alternate" type="text/html" href="https://pcwiki.pcstreet.org/index.php?title=PcSecretClient&amp;action=history"/>
	<updated>2026-11-22T22:45:06Z</updated>
	<subtitle>Historique des versions pour cette page sur le wiki</subtitle>
	<generator>MediaWiki 1.46.0</generator>
	<entry>
		<id>https://pcwiki.pcstreet.org/index.php?title=PcSecretClient&amp;diff=22839&amp;oldid=prev</id>
		<title>Pchevalier : Page créée avec « KEYWORDS: PCSECRETCLIENT  &#039;&#039;&#039;Le 15/11/2026:&#039;&#039;&#039; = pcSecretClient =  * &#039;&#039;&#039;Version&#039;&#039;&#039; : 1.03 * &#039;&#039;&#039;Date&#039;&#039;&#039; : 15/11/2026  == Fonctionnement == Client en ligne de commande du vault &lt;code&gt;pcSecretd&lt;/code&gt;. Il se connecte au socket &lt;code&gt;/run/pcvault.sock&lt;/code&gt; 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&#039;est pas affiché (seule sa longueur l&#039;est) ; &lt;code&gt;--print&lt;/code&gt;... »</title>
		<link rel="alternate" type="text/html" href="https://pcwiki.pcstreet.org/index.php?title=PcSecretClient&amp;diff=22839&amp;oldid=prev"/>
		<updated>2026-11-15T16:34:26Z</updated>

		<summary type="html">&lt;p&gt;Page créée avec « KEYWORDS: PCSECRETCLIENT  &amp;#039;&amp;#039;&amp;#039;Le 15/11/2026:&amp;#039;&amp;#039;&amp;#039; = pcSecretClient =  * &amp;#039;&amp;#039;&amp;#039;Version&amp;#039;&amp;#039;&amp;#039; : 1.03 * &amp;#039;&amp;#039;&amp;#039;Date&amp;#039;&amp;#039;&amp;#039; : 15/11/2026  == Fonctionnement == Client en ligne de commande du vault &amp;lt;code&amp;gt;pcSecretd&amp;lt;/code&amp;gt;. Il se connecte au socket &amp;lt;code&amp;gt;/run/pcvault.sock&amp;lt;/code&amp;gt; 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&amp;#039;est pas affiché (seule sa longueur l&amp;#039;est) ; &amp;lt;code&amp;gt;--print&amp;lt;/code&amp;gt;... »&lt;/p&gt;
&lt;p&gt;&lt;b&gt;Nouvelle page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;KEYWORDS: PCSECRETCLIENT&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Le 15/11/2026:&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
= pcSecretClient =&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Version&amp;#039;&amp;#039;&amp;#039; : 1.03&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Date&amp;#039;&amp;#039;&amp;#039; : 15/11/2026&lt;br /&gt;
&lt;br /&gt;
== Fonctionnement ==&lt;br /&gt;
Client en ligne de commande du vault &amp;lt;code&amp;gt;pcSecretd&amp;lt;/code&amp;gt;. Il se connecte au socket &amp;lt;code&amp;gt;/run/pcvault.sock&amp;lt;/code&amp;gt; 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&amp;#039;est pas affiché (seule sa longueur l&amp;#039;est) ; &amp;lt;code&amp;gt;--print&amp;lt;/code&amp;gt; l&amp;#039;écrit en clair sur stdout. Le commentaire (à quoi sert le secret) est chiffré dans le coffre : &amp;lt;code&amp;gt;--info&amp;lt;/code&amp;gt; le révèle, mais jamais les valeurs.&lt;br /&gt;
&lt;br /&gt;
Dans un programme C++, utiliser la bibliothèque &amp;lt;code&amp;gt;libpcSecret&amp;lt;/code&amp;gt; (classes &amp;lt;code&amp;gt;ClassPcSecret&amp;lt;/code&amp;gt; et &amp;lt;code&amp;gt;ClassSecureString&amp;lt;/code&amp;gt;) : voir &amp;lt;code&amp;gt;libpcSecret.wiki&amp;lt;/code&amp;gt; et &amp;lt;code&amp;gt;libpcSecret.txt&amp;lt;/code&amp;gt;. Le client en ligne de commande s&amp;#039;appuie sur la classe interne &amp;lt;code&amp;gt;ClassVaultClient&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Avantages ==&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Le secret n&amp;#039;est jamais sur disque&amp;#039;&amp;#039;&amp;#039; : un script le récupère à l&amp;#039;exécution, au lieu de le stocker dans un fichier de configuration ou dans le script.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Par défaut, rien n&amp;#039;est affiché&amp;#039;&amp;#039;&amp;#039; : sans &amp;lt;code&amp;gt;--print&amp;lt;/code&amp;gt;, seule la longueur apparaît, ce qui permet de tester l&amp;#039;accès sans exposer la valeur.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Un seul secret à la fois&amp;#039;&amp;#039;&amp;#039; : on ne demande que celui dont on a besoin ; &amp;lt;code&amp;gt;--list&amp;lt;/code&amp;gt; et &amp;lt;code&amp;gt;--info&amp;lt;/code&amp;gt; ne révèlent jamais les valeurs (&amp;lt;code&amp;gt;--info&amp;lt;/code&amp;gt; ajoute seulement le commentaire).&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Sortie propre pour les scripts&amp;#039;&amp;#039;&amp;#039; : avec &amp;lt;code&amp;gt;--print&amp;lt;/code&amp;gt;, la valeur est seule sur stdout (messages sur stderr), sans saut de ligne parasite hors terminal : &amp;lt;code&amp;gt;pw=$(pcSecretClient --print nom)&amp;lt;/code&amp;gt;.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Code de retour exploitable&amp;#039;&amp;#039;&amp;#039; : 0 succès, 1 erreur, 2 option inconnue.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Copie effacée&amp;#039;&amp;#039;&amp;#039; : la copie du secret en mémoire du client est effacée (&amp;lt;code&amp;gt;explicit_bzero&amp;lt;/code&amp;gt;) dès l&amp;#039;usage terminé.&lt;br /&gt;
&lt;br /&gt;
== Défauts et limites ==&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Réservé à root&amp;#039;&amp;#039;&amp;#039; : le daemon refuse tout autre uid.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Pas de contrôle par programme&amp;#039;&amp;#039;&amp;#039; : n&amp;#039;importe quel processus root peut demander n&amp;#039;importe quel secret.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;&amp;lt;code&amp;gt;--print&amp;lt;/code&amp;gt; expose le secret&amp;#039;&amp;#039;&amp;#039; : la valeur apparaît dans le terminal, ou dans une variable de script qui peut finir dans l&amp;#039;environnement, l&amp;#039;historique ou un journal si le script est mal écrit. Utilisez &amp;lt;code&amp;gt;unset&amp;lt;/code&amp;gt; après usage, et ne l&amp;#039;écrivez jamais dans un fichier.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Le daemon doit tourner&amp;#039;&amp;#039;&amp;#039; (et être déverrouillé) : sinon &amp;lt;code&amp;gt;Connexion à pcSecretd échouée&amp;lt;/code&amp;gt;.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Vue figée&amp;#039;&amp;#039;&amp;#039; : après une modification du coffre, le daemon (donc le client) sert l&amp;#039;ancienne version jusqu&amp;#039;à son redémarrage.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Efface au mieux&amp;#039;&amp;#039;&amp;#039; : seule la copie du client est effacée ; les copies intermédiaires d&amp;#039;un script shell ne le sont pas.&lt;br /&gt;
&lt;br /&gt;
== Syntaxe ==&lt;br /&gt;
&amp;lt;pre&amp;gt;pcSecretClient [--print] [--list | --info] [NOM]&amp;lt;/pre&amp;gt;&lt;br /&gt;
NOM : nom du secret (défaut : &amp;lt;code&amp;gt;default&amp;lt;/code&amp;gt;).&lt;br /&gt;
&lt;br /&gt;
== Options : syntaxe et exemple ==&lt;br /&gt;
&lt;br /&gt;
=== (aucune option) ===&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Syntaxe&amp;#039;&amp;#039;&amp;#039; : &amp;lt;code&amp;gt;pcSecretClient [NOM]&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Exemple&amp;#039;&amp;#039;&amp;#039; : &amp;lt;code&amp;gt;pcSecretClient db_pg&amp;lt;/code&amp;gt;&lt;br /&gt;
* Vérifie l&amp;#039;accès au secret NOM et affiche seulement sa longueur.&lt;br /&gt;
&lt;br /&gt;
=== --print ===&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Syntaxe&amp;#039;&amp;#039;&amp;#039; : &amp;lt;code&amp;gt;pcSecretClient --print [NOM]&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Exemple&amp;#039;&amp;#039;&amp;#039; : &amp;lt;code&amp;gt;pw=$(pcSecretClient --print db_pg)&amp;lt;/code&amp;gt;&lt;br /&gt;
* Écrit le secret seul sur stdout. Sur un terminal un saut de ligne est ajouté ; dans &amp;lt;code&amp;gt;$(...)&amp;lt;/code&amp;gt; ou un tube, la valeur reste exacte.&lt;br /&gt;
&lt;br /&gt;
=== --list ===&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Syntaxe&amp;#039;&amp;#039;&amp;#039; : &amp;lt;code&amp;gt;pcSecretClient --list&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Exemple&amp;#039;&amp;#039;&amp;#039; : &amp;lt;code&amp;gt;pcSecretClient --list&amp;lt;/code&amp;gt;&lt;br /&gt;
* Liste les noms des secrets disponibles, un par ligne, jamais les valeurs.&lt;br /&gt;
&lt;br /&gt;
=== --info ===&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Syntaxe&amp;#039;&amp;#039;&amp;#039; : &amp;lt;code&amp;gt;pcSecretClient --info&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Exemple&amp;#039;&amp;#039;&amp;#039; : &amp;lt;code&amp;gt;pcSecretClient --info&amp;lt;/code&amp;gt;&lt;br /&gt;
* Liste les noms ET leur commentaire, une ligne &amp;lt;code&amp;gt;nom&amp;lt;TAB&amp;gt;commentaire&amp;lt;/code&amp;gt; par secret (le commentaire est vide s&amp;#039;il n&amp;#039;y en a pas). Jamais les valeurs. Un NOM ou &amp;lt;code&amp;gt;--print&amp;lt;/code&amp;gt; donnés en plus sont ignorés : &amp;lt;code&amp;gt;--info&amp;lt;/code&amp;gt; est traité en premier.&lt;br /&gt;
&lt;br /&gt;
=== -h, --help ===&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Syntaxe&amp;#039;&amp;#039;&amp;#039; : &amp;lt;code&amp;gt;pcSecretClient -h&amp;lt;/code&amp;gt; ou &amp;lt;code&amp;gt;pcSecretClient --help&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Exemple&amp;#039;&amp;#039;&amp;#039; : &amp;lt;code&amp;gt;pcSecretClient --help&amp;lt;/code&amp;gt;&lt;br /&gt;
* Affiche l&amp;#039;aide et quitte.&lt;br /&gt;
&lt;br /&gt;
== Code de retour ==&lt;br /&gt;
0 succès ; 1 erreur (daemon absent, accès refusé, secret inconnu) ; 2 option inconnue.&lt;/div&gt;</summary>
		<author><name>Pchevalier</name></author>
	</entry>
</feed>