INFO::pcMakeAndSendSshKey modifié par Claude
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 :
- Lecture du fichier ini listant les couples
host:port
(le port est celui du démon rsyncd distant,873ou874— jamais le port SSH).
- Exclusion du serveur hôte (la machine locale) de cette liste, par
comparaison des adresses IP locales (getifaddrs) et du
nom d'hôte.
- 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.
- 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).
- Pour chaque serveur actif : récupération de
/root/.ssh/authorized_keysvia rsync (démon, moduleRaCiNe, 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 |
lecture |
/root/.config/pcMakeAndSendSshKey/rsyncd.secret
|
Mot de passe d'authentification auprès du démon rsyncd distant
(utilisateur
|
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
|
— | 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 |
— | 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 |
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 |
— | pcMakeAndSendSshKey --copy-ini
|
-b, --bin <chemin>
|
Exécutable local à propager vers la flotte avec
|
/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 syntaxersync://user@host:port/module(celle utilisée par ce programme) tente alors l'IPv6 et reste bloquée malgré--contimeout, alors que la syntaxe historiquehost::moduleréussit instantanément (elle semble préférer l'IPv4). Solution :-4/--ipv4est 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 dansClassRsyncAuthorizedKeysSync.cppetClassRsyncPathPusher.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--timeoutqui ne couvre que les I/O une fois connecté) et un timeout global de 30 s dansClassProcessRunnerqui 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-inipropage le mot de passe
rsyncd : le répertoire copié contientrsyncd.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-inipropage 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-iniqu'à 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 viaps 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é.