AuthKeySync

Synchronisez automatiquement les clés publiques SSH depuis des URLs distantes vers vos serveurs

📖 Documentation complète

Le problème

Gérer l'accès SSH sur plusieurs serveurs est pénible :

• Les membres de l'équipe arrivent ou partent, et vous devez mettre à jour authorized_keys sur chaque serveur
• Les développeurs changent leurs clés SSH, et vous avez maintenant 20 serveurs à mettre à jour
• Vous utilisez l'Infrastructure as Code, mais la gestion des clés SSH reste manuelle
• Les scripts bash maison pour la gestion des clés sont souvent mal écrits, peu sécurisés, ou contiennent des bugs subtils qui peuvent vous bloquer l'accès à vos serveurs
• Vous voulez utiliser les clés GitHub/GitLab, mais les copier partout est fastidieux

La solution

AuthKeySync est un CLI léger qui récupère les clés publiques SSH depuis des URLs (GitHub, GitLab, votre propre API) et les synchronise sur vos serveurs. Il est sûr, fiable et conçu pour l'automatisation.

# /etc/authkeysync/config.yaml
users:
  - username: "deploy"
    sources:
      - url: "https://github.com/your-username.keys"
      - url: "https://github.com/another-username.keys"

Exécutez authkeysync (manuellement ou via cron), et votre authorized_keys est mise à jour. C'est tout.

Fonctionnalités principales

• Binaire unique : Aucune dépendance, téléchargez et exécutez
• Sûr par défaut : Préserve les clés locales existantes, crée des sauvegardes, utilise des écritures atomiques
• Sécurisé : Si une source échoue, la mise à jour est annulée pour éviter les blocages
• Sources flexibles : GitHub, GitLab, ou toute URL renvoyant des clés SSH en texte brut
• Support API : Requêtes POST avec en-têtes personnalisées pour les API authentifiées
• Prêt pour l'IaC : Sans état, idempotent, parfait pour Ansible/Terraform/cloud-init
• Multi-plateforme : Fonctionne sur Linux et macOS (AMD64 et ARM64)

Démarrage rapide

1. Téléchargement

Obtenez le dernier binaire depuis la page des versions :

# Linux AMD64
curl -Lo authkeysync https://github.com/eduardolat/authkeysync/releases/latest/download/authkeysync-linux-amd64
chmod +x authkeysync
sudo mv authkeysync /usr/local/bin/

2. Configuration

Créez un fichier de configuration dans /etc/authkeysync/config.yaml :

policy:
  backup_enabled: true # Crée des sauvegardes avant les modifications (défaut : true)
  backup_retention_count: 10 # Nombre de sauvegardes à conserver (défaut : 10)
  preserve_local_keys: true # Conserve les clés absentes des sources distantes (défaut : true)

users:
  - username: "root"
    sources:
      - url: "https://github.com/your-username.keys"

3. Exécution

# Testez d'abord en mode dry-run
sudo authkeysync --dry-run

# Appliquez les modifications
sudo authkeysync

4. Automatisation

Configurez une tâche cron ou un timer systemd pour une exécution périodique :

# Toutes les 5 minutes (utilisez --quiet pour réduire le bruit dans les logs cron)
echo "*/5 * * * * root /usr/local/bin/authkeysync --quiet" | sudo tee /etc/cron.d/authkeysync

Options de configuration

Politique (toutes optionnelles)

Utilisateurs (obligatoire)

Sources

Exemple avec toutes les options

policy:
  backup_enabled: true
  backup_retention_count: 10
  preserve_local_keys: true

users:
  - username: "deploy"
    sources:
      # Clés GitHub simples
      - url: "https://github.com/your-username.keys"

      # API privée avec authentification
      - url: "https://keys.yourcompany.com/api/keys"
        method: "POST"
        headers:
          Authorization: "Bearer your-secret-token"
          Content-Type: "application/json"
        body: '{"environment": "production"}'
        timeout_seconds: 5

Options CLI

Codes de sortie

Fonctionnement

1. Récupération : Télécharge les clés SSH depuis les URLs configurées
2. Analyse : Valide et déduplique les clés de toutes les sources
3. Fusion : Conserve optionnellement les clés qui n'existent que localement
4. Écriture : Met à jour atomiquement authorized_keys avec les permissions appropriées
5. Sauvegarde : Crée des sauvegardes horodatées avant toute modification

Si une source échoue à la récupération, AuthKeySync annule la mise à jour pour cet utilisateur afin d'éviter les blocages. Votre accès existant reste intact.

Soutenir le projet

Si vous trouvez AuthKeySync utile, n'hésitez pas à lui donner une étoile sur GitHub et à me suivre sur X (Twitter) pour les mises à jour :

• Donnez une étoile sur GitHub
• Suivez @eduardoolat sur X

Licence

Licence MIT. Voir LICENSE pour les détails.