INFO::pcMakeAndSendSshKey modifié par Claude

De wiki_pcwiki2
Aller à la navigationAller à la recherche

KEYWORDS: PCMAKEANDSENDSSHKEY, SSH, CLE, KEY, RSYNC

Le29/07/2026:

pcMakeAndSendSshKey

Version : 1.13 (V1.01)

Date : 2026/07/29

Auteur : pcroad2gmail.com

Fonctionnement

pcMakeAndSendSshKey automatise la distribution d'une clé SSH publique locale vers l'ensemble des serveurs d'une flotte, en s'appuyant sur un démon rsyncd déjà déployé sur chaque serveur distant (module RaCiNe mappé vers la racine du filesystem / ; le fichier ciblé est donc RaCiNe/root/.ssh/authorized_keys).

Déroulement :

  1. Lecture du fichier ini listant les couples host:port
 (le port est celui du démon rsyncd distant, 873 ou
 874 — jamais le port SSH).
  1. Exclusion du serveur hôte (la machine locale) de cette liste, par
 comparaison des adresses IP locales (getifaddrs) et du
 nom d'hôte.
  1. Pour chaque serveur restant, test de présence ("UP") par simple
 connexion TCP sur le port SSH (22 par défaut) — aucune
 authentification n'est tentée à ce stade, on vérifie seulement que
 sshd répond.
  1. Création d'une clé locale ed25519 si elle n'existe pas encore
 (commentaire clé créée le YYYY/MM/DD par pcMakeAndSendSshKey).
 Si la clé existe déjà, elle est réutilisée telle quelle (pas de
 régénération).
  1. Pour chaque serveur actif : récupération de
 /root/.ssh/authorized_keys via rsync (démon, module
 RaCiNe, authentification par mot de passe), ajout de la
 clé publique locale si elle n'y est pas déjà (dédoublonnage par
 contenu de clé, pas par commentaire), puis renvoi du fichier fusionné
 vers le serveur.

Fichiers de configuration

Fichier Rôle Permissions requises
/root/.config/pcMakeAndSendSshKey/pcMakeAndSendSshKey.ini Liste des serveurs, une ligne host:port par serveur (voir
 format détaillé ci-dessous). Lignes vides ou débutant par
 #/; ignorées.
lecture
/root/.config/pcMakeAndSendSshKey/rsyncd.secret Mot de passe d'authentification auprès du démon rsyncd distant
 (utilisateur root).
600 obligatoire (le programme refuse de démarrer sinon)

Le fichier est organisé en deux sections optionnelles, [CopyIni] et [CopyNotIni] : un serveur listé sous [CopyNotIni] voit son répertoire de configuration distant protégé d'un écrasement par -C/--copy-ini (le binaire et la clé SSH restent propagés normalement vers lui, seul le répertoire est épargné). Les lignes placées avant tout en-tête de section sont implicitement dans [CopyIni] — un fichier sans aucune section reste donc parfaitement valide (rétro-compatible).

Exemple de fichier ini :

# pcMakeAndSendSshKey.ini
[CopyIni]
srv1.lan:873
srv2.lan:874
192.168.1.50:873

[CopyNotIni]
srv3.lan:873

Syntaxe

pcMakeAndSendSshKey [OPTIONS]

Les options -l, -a, -d et -C sont des actions autonomes, mutuellement exclusives entre elles et avec la synchronisation normale : une seule peut être utilisée à la fois.

Options

Option Description Défaut Exemple
-h, --help Affiche l'aide et quitte. — pcMakeAndSendSshKey --help
-i, --info Explique en détail le but et le fonctionnement du programme (plus
 complet que --help sur le « pourquoi »), et quitte.
— pcMakeAndSendSshKey --info
-c, --config <chemin> Chemin du fichier ini des serveurs. /root/.config/pcMakeAndSendSshKey/pcMakeAndSendSshKey.ini pcMakeAndSendSshKey -c /etc/monfleet.ini
-l, --list Liste le contenu du fichier ini (chemin + couples host:port), groupé
 par section [CopyIni]/[CopyNotIni] (cf.
 -C), et quitte. Aucune connexion réseau.
— pcMakeAndSendSshKey --list
-a, --add <host:port> Ajoute un serveur dans la section [CopyIni] du fichier
 ini, ou met à jour son port s'il existe déjà sans changer sa
 section (un serveur déjà dans [CopyNotIni] y reste).
 Déplacer un serveur vers [CopyNotIni] se fait en éditant
 le fichier à la main.
section : [CopyIni] pcMakeAndSendSshKey -a srv22:873
-d, --delete <host> Supprime un serveur du fichier ini (par nom d'hôte, dans n'importe
 quelle section) et quitte.
— pcMakeAndSendSshKey -d srv22
-C, --copy-ini Envoie via rsync tout le répertoire de configuration (celui
 contenant le fichier ini) vers le même chemin absolu sur chaque
 serveur actif de la flotte, sauf ceux de la section
 [CopyNotIni]. Inclut donc rsyncd.secret
 pour les serveurs de [CopyIni]. Copie aussi le binaire
 local (cf. -b) vers le même chemin distant (tous les
 serveurs actifs, quelle que soit leur section), et distribue/met à
 jour la clé SSH locale dans authorized_keys de chaque
 serveur si nécessaire (même dédoublonnage qu'une exécution normale) :
 une seule commande pour garder toute la flotte à jour (config,
 binaire, confiance SSH).
— pcMakeAndSendSshKey --copy-ini
-b, --bin <chemin> Exécutable local à propager vers la flotte avec
 -C/--copy-ini. Absent localement : la copie
 du binaire est simplement ignorée (avertissement, pas d'erreur).
/home/local/bin/pcMakeAndSendSshKey pcMakeAndSendSshKey -b /home/local/bin/pcMakeAndSendSshKey
-k, --key <chemin> Clé privée ed25519 locale (réutilisée si présente, sinon créée). /root/.ssh/id_ed25519 pcMakeAndSendSshKey -k /root/.ssh/id_fleet
-s, --secret <chemin> Fichier contenant le mot de passe du démon rsyncd (permissions 600). /root/.config/pcMakeAndSendSshKey/rsyncd.secret pcMakeAndSendSshKey -s /root/.rsyncd.pwd
-u, --rsync-user <utilisateur> Utilisateur d'authentification rsyncd. root pcMakeAndSendSshKey -u root
-m, --module <nom> Nom du module rsyncd distant mappé vers la racine du filesystem
 (/).
RaCiNe pcMakeAndSendSshKey -m RaCiNe
-p, --ssh-port <port> Port TCP utilisé pour le test de présence des serveurs. 22 pcMakeAndSendSshKey -p 22
-n, --dry-run N'effectue aucune écriture distante ; affiche les actions prévues. désactivé pcMakeAndSendSshKey --dry-run
-v, --verbose Affiche la sortie des sous-commandes (ssh-keygen, rsync). désactivé pcMakeAndSendSshKey --verbose

Codes de retour

Code Signification
0 Tous les serveurs actifs ont été synchronisés avec succès (ou aucun serveur actif).
1 Au moins un serveur actif a échoué (rsync, ou autre erreur par serveur). Les autres serveurs sont tout de même traités.
2 Erreur de configuration : fichier ini absent/invalide, mot de passe rsyncd absent ou trop permissif, option de ligne de commande invalide.

Compilation

Paquets Debian requis :

apt install g++ cmake libboost-all-dev openssh-client rsync

Build (binaire statique partiel : libstdc++/libgcc et Boost sont liés statiquement, la glibc reste dynamique) :

mkdir -p build && cd build && cmake .. && make

Le binaire pcMakeAndSendSshKey est généré dans build/. À la toute première compilation dans un répertoire de build donné, le programme pcShowDir est automatiquement invoqué.

Installation dans /home/local/bin (chemin utilisé par défaut par -b/--copy-ini) :

cmake --install build

Pourquoi pas un lien 100 % statique (-static) : testé, et rejeté après avoir provoqué un crash reproductible (confirmé sous gdb, y compris localement sur la machine de compilation elle-même — donc indépendant de la machine cible) :

Program received signal SIGFPE, Arithmetic exception.
...
#14 getaddrinfo ()
#15 ClassLocalHostDetector::isLocalHost(...)

Cause : getaddrinfo() charge le module NSS (libnss_dns.so) via dlopen(), et le chargement dynamique d'une bibliothèque depuis un exécutable entièrement statique est structurellement cassé dans la glibc moderne (bug connu d'initialisation TLS pour les objets chargés par dlopen dans ce contexte). Ce n'est pas contournable : ça plante sur toute résolution DNS, quelle que soit la machine. D'où le choix du statique partiel : la glibc restant dynamique, dlopen() fonctionne normalement.

Compiler sur le système le plus ancien de la flotte : la glibc est rétro-compatible (un binaire lié à une glibc ancienne tourne sur toute glibc plus récente) mais pas l'inverse. Un binaire statique-partiel compilé sous Debian 13 (glibc 2.41) refuse de démarrer sur un Debian 12 (glibc plus ancienne) : version 'GLIBC_2.38' not found. Si la flotte mélange plusieurs versions d'OS, compiler sur la version la plus ancienne présente dans la flotte (ex. chroot Debian 12 via debootstrap, cf. dépôt de ce projet pour le script utilisé). Vérification de la version glibc minimale requise par un binaire donné :

objdump -T build/pcMakeAndSendSshKey | grep -oP 'GLIBC_[0-9.]+' | sort -V -u | tail -3

Prérequis côté serveurs distants

Chaque serveur de la flotte doit exposer un démon rsyncd avec un module RaCiNe mappé vers la racine du filesystem (/), protégé par mot de passe (utilisateur root). Exemple minimal de /etc/rsyncd.conf côté serveur distant :

port = 873
[RaCiNe]
    path = /
    read only = false
    auth users = root
    secrets file = /etc/rsyncd.secrets

Le fichier distant manipulé est donc /root/.ssh/authorized_keys, atteint via RaCiNe/root/.ssh/authorized_keys.

Avec /etc/rsyncd.secrets (permissions 600) contenant root:billou (mot de passe à adapter).

Côté client (cette machine), aucune version minimale de rsync n'est requise au-delà du support de --relative/-R et --chmod, disponibles depuis rsync 3.1.0 (2013) : testé et validé avec rsync 3.1.1 (Debian 12) comme 3.4.4 (Debian 13/trixie).

Pièges et limites connues

  • IPv6 cassé sur un serveur = blocage en syntaxe rsync://,
 même avec --contimeout : rencontré en conditions
 réelles sur un serveur dont l'adresse IPv6 ne répond pas (paquets
 ignorés). La syntaxe rsync://user@host:port/module
 (celle utilisée par ce programme) tente alors l'IPv6 et reste
 bloquée malgré --contimeout, alors que la syntaxe
 historique host::module réussit instantanément (elle
 semble préférer l'IPv4). Solution : -4/--ipv4
 est désormais forcé sur tous les appels rsync de ce programme. Si un
 jour un serveur de la flotte est joignable uniquement en IPv6, il
 faudra retirer ce -4 (actuellement en dur dans
 ClassRsyncAuthorizedKeysSync.cpp et
 ClassRsyncPathPusher.cpp).
  • Port SSH testé, port rsync non testé : le test de présence
 (-p) vérifie uniquement que le port SSH répond. Le port
 du démon rsync (873/874) peut être filtré séparément (paquets
 silencieusement ignorés par un pare-feu) sans que cela apparaisse au
 test de présence. Deux filets de sécurité couvrent ce cas : l'option
 rsync --contimeout=8 (timeout dédié à la connexion,
 distinct de --timeout qui ne couvre que les I/O une fois
 connecté) et un timeout global de 30 s dans ClassProcessRunner
 qui tue le sous-processus si besoin. Un serveur au port rsync filtré
 est donc traité en échec (et n'interrompt pas les serveurs suivants),
 jamais en blocage indéfini.
  • -C/--copy-ini propage le mot de passe
 rsyncd : le répertoire copié contient rsyncd.secret.
 Après un --copy-ini, chaque serveur de la flotte connaît
 le même secret rsyncd que tous les autres. À n'utiliser que si c'est
 le comportement voulu (secret partagé pour toute la flotte).
  • -C/--copy-ini propage aussi l'exécutable
 (-b) : cela distribue du code exécutable à toute la
 flotte sans vérification d'intégrité (pas de somme de contrôle ni de
 signature). Ne lancer --copy-ini qu'à partir d'un binaire
 local en lequel on a confiance.
  • Pas de verrouillage distant : si deux exécutions concurrentes
 (ou une modification manuelle simultanée) touchent le même
 authorized_keys, la dernière écriture gagne. Ce
 programme n'est pas conçu pour un usage concurrent sur un même
 serveur.
  • Mot de passe rsyncd : jamais passé en clair sur la ligne de
 commande (visible via ps aux) ; toujours lu via
 --password-file. Le fichier doit être en 600, sinon le
 programme refuse de démarrer.
  • Détection du serveur hôte : basée sur les adresses IP locales
 et le nom d'hôte. Si un serveur de la flotte partage temporairement
 une IP avec l'hôte (ex. VIP flottante), il pourrait être exclu à
 tort.
  • Test de présence SSH : une simple connexion TCP réussie ne
 garantit pas que l'authentification SSH fonctionnerait réellement
 (pare-feu ouvrant le port sans service actif derrière, etc.). Le
 test sert uniquement à écarter les serveurs manifestement éteints ou
 injoignables.
  • Encodage : le commentaire de clé contient des caractères
 accentués UTF-8. Certains anciens clients SSH peuvent afficher ce
 commentaire de façon imparfaite ; cela n'affecte pas la validité
 cryptographique de la clé.