LibpcSecret

De wiki_pcwiki2
Version datée du 15 novembre 2026 à 16:33 par Pchevalier (discussion | contributions) (Page créée avec « 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 <code>pcSecretd</code> (socket <code>/run/pcvault.sock</code>). Elle fournit deux classes : <code>ClassPcSecret</code> (accès au coffre : liste, commentaires, lecture) et <code>ClassSecureString</code> (chaîne effacée à la destruction). Elle est l... »)
(diff) ← Version précédente | Version actuelle (diff) | Version suivante → (diff)
Aller à la navigationAller à la recherche

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 : ClassSecureString efface 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) ; seule isAvailable() 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 --set ou gpcSecret).
  • 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.