LibpcSecret
KEYWORDS: LIBPCSECRET
Le 15/11/2026:
libpcSecret
- Version : 1.03
- Date : 15/11/2026
Fonctionnement
Bibliothèque C++17 qui permet à un autre programme de lire les secrets du daemon pcSecretd (socket /run/pcvault.sock). Elle fournit deux classes : ClassPcSecret (accès au coffre : liste, commentaires, lecture) et ClassSecureString (chaîne effacée à la destruction). Elle est livrée en statique (libpcSecret.a) et en partagée (libpcSecret.so), avec deux en-têtes publics : ClassPcSecret.hpp et ClassSecureString.hpp. L'API complète est décrite dans libpcSecret.txt.
#include <ClassPcSecret.hpp>
ClassPcSecret vault;
ClassSecureString pw = vault.get("db_pg");
connect(host, pw.c_str()); // pw est effacé à la sortie de portée
Avantages
- Aucun secret sur disque : le programme le demande au daemon à l'exécution.
- Effacement mémoire :
ClassSecureStringefface son contenu (explicit_bzero) à la destruction, àclear()et au déplacement, sans résidu, même pour les chaînes courtes. - Aucune dépendance : pas d'OpenSSL ni d'argon2, seulement le client socket.
- Erreurs par exceptions (
std::runtime_error) ; seuleisAvailable()ne lève jamais. - Sans état, utilisable depuis plusieurs threads : une connexion courte par appel.
- Statique ou partagée, testée par
TestPcSecret.
Défauts et limites
- Lecture seule : pas d'ajout ni de modification (utiliser
pcSecretd --setougpcSecret). - Réservé à root et daemon déverrouillé obligatoire.
- Pas de cache, vue figée : redémarrer le daemon pour voir une modification du coffre.
- Copies tierces non effacées :
getPlain(),toString(),QString, etc. exigent que l'appelant efface (ClassSecureString::wipe) ou s'en passe. - Pas de contrôle fin : tout processus root lit tous les secrets.
- Un aller-retour par appel :
has()relit la liste des noms. - Pas d'internationalisation : messages d'erreur en français seulement.
Syntaxe
g++ -std=c++17 -I includes app.cpp -L build -lpcSecret -o app g++ -std=c++17 -I includes app.cpp build/libpcSecret.a -o app
Après make install : en-têtes dans /home/local/include/pcSecret, bibliothèques dans /home/local/lib (ajouter -Wl,-rpath,/home/local/lib pour la version partagée). Paquets Debian pour construire : apt install g++ cmake libargon2-dev libssl-dev.
API : syntaxe et exemple
ClassPcSecret
| Méthode | Rôle | Exemple |
|---|---|---|
ClassPcSecret(socket_path = "/run/pcvault.sock") |
mémorise le socket, sans connexion | ClassPcSecret vault;
|
socketPath() |
chemin du socket utilisé | vault.socketPath()
|
isAvailable() |
true si le daemon répond et accepte ce processus, sans exception | if (!vault.isAvailable()) return 1;
|
names() |
noms des secrets | for (auto& n : vault.names()) ...
|
infos() |
noms et commentaires (Info{name, comment}) |
vault.infos()[0].comment
|
has(name) |
true si le secret existe | vault.has("rsync")
|
get(name = "default") |
valeur dans une ClassSecureString |
auto pw = vault.get("db_pg");
|
getPlain(name = "default") |
valeur en std::string (à effacer) |
auto s = vault.getPlain("db_pg");
|
ClassSecureString
| Méthode | Rôle | Exemple |
|---|---|---|
ClassSecureString(), ClassSecureString(std::string&&) |
vide, ou prend un secret (la source est effacée) | ClassSecureString s(std::move(plain));
|
data(), c_str(), size(), empty() |
accès aux octets | login(user, pw.c_str());
|
view() |
std::string_view sans copie |
if (pw.view() == "x") ...
|
toString() |
copie en clair (à effacer) | std::string c = pw.toString();
|
clear() |
efface puis vide | pw.clear();
|
static wipe(std::string&) |
efface une std::string quelconque |
ClassSecureString::wipe(c);
|
Non copiable, déplaçable.
Exemple complet
Fichier exemple.cpp (compilé et vérifié) :
// exemple.cpp — lecture d'un secret avec libpcSecret
#include <ClassPcSecret.hpp>
#include <cstdlib>
#include <iostream>
#include <stdexcept>
using namespace std;
int main(int argc, char* argv[])
{
const string name = (argc > 1) ? argv[1] : "default";
try
{
ClassPcSecret vault; // /run/pcvault.sock
if (!vault.isAvailable())
throw runtime_error("pcSecretd absent ou verrouillé");
for (const auto& i : vault.infos()) // noms + commentaires
cout << i.name << " : " << i.comment << "\n";
if (!vault.has(name))
throw invalid_argument("secret inconnu : " + name);
ClassSecureString pw = vault.get(name); // effacé en fin de portée
cout << name << " : " << pw.size() << " octet(s)\n";
// connect(host, pw.c_str());
}
catch (const exception& e)
{
cerr << "Erreur : " << e.what() << "\n";
return EXIT_FAILURE;
}
return EXIT_SUCCESS;
}
Compilation et exécution (en root, daemon déverrouillé) :
g++ -std=c++17 -Wall -Wextra -I includes exemple.cpp \
build/libpcSecret.a -o exemple
./exemple db_pg
Avec CMake
add_executable(app app.cpp) target_include_directories(app PRIVATE /home/local/include/pcSecret) target_link_libraries(app PRIVATE /home/local/lib/libpcSecret.a)
Protocole du socket (dialogue direct avec pcSecretd)
La bibliothèque n'est qu'un client du socket Unix /run/pcvault.sock (permissions 0600, uid vérifié par SO_PEERCRED, root seulement). Un programme non C++ peut dialoguer directement : une connexion par requête, une ligne de requête, une seule réponse, puis fermeture. Délai de 10 s.
| Requête | Réponse en cas de succès | Correspond à |
|---|---|---|
LIST |
OK nom1\nnom2\n... |
names(), has(), isAvailable()
|
LISTX |
OK nom1<TAB>commentaire1\nnom2<TAB>commentaire2... |
infos()
|
GET <nom> |
OK <valeur> (octets bruts, sans fin de ligne) |
get(), getPlain()
|
GET_SECRET |
idem GET default (compatibilité V1.01) |
— |
Réponses d'erreur : ERR DENIED (uid non autorisé), ERR NOTFOUND (secret absent), ERR UNKNOWN (requête ou nom invalide), ERR INTERNAL (erreur du daemon). Le client de la bibliothèque rejette toute réponse de plus de 20000 octets.
Exemple en bash (socat requis : apt install socat) :
echo LISTX | socat - UNIX-CONNECT:/run/pcvault.sock echo "GET db_pg" | socat - UNIX-CONNECT:/run/pcvault.sock
Les noms de secrets font de 1 à 64 caractères parmi A-Z a-z 0-9 _ . -.
Erreurs
std::runtime_error : connexion échouée (daemon absent), accès refusé (uid non root), secret inconnu, requête rejetée (nom invalide), réponse trop longue.