AuthKeySync

Sincronizza automaticamente le chiavi pubbliche SSH da URL remote ai tuoi server

📖 Documentazione Completa

Il Problema

Gestire l'accesso SSH su più server è doloroso:

• I membri del team entrano o escono e devi aggiornare authorized_keys su ogni server
• Gli sviluppatori ruotano le loro chiavi SSH e ora hai 20 server da aggiornare
• Stai usando Infrastructure as Code, ma la gestione delle chiavi SSH è ancora manuale
• Script bash fatti in casa per la gestione delle chiavi sono spesso scritti male, insicuri o hanno bug sottili che possono bloccarti l'accesso ai server
• Vuoi usare le chiavi di GitHub/GitLab, ma copiarle ovunque è noioso

La Soluzione

AuthKeySync è un CLI leggero che recupera le chiavi pubbliche SSH da URL (GitHub, GitLab, la tua API) e le sincronizza sui tuoi server. È sicuro, affidabile e progettato per l'automazione.

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

Esegui authkeysync (manualmente o tramite cron) e il tuo authorized_keys viene aggiornato. Tutto qui.

Caratteristiche Principali

• Singolo binario: Nessuna dipendenza, basta scaricarlo ed eseguirlo
• Sicuro per impostazione predefinita: Preserva le chiavi locali esistenti, crea backup, usa scritture atomiche
• Fail-safe: Se una sorgente fallisce, l'aggiornamento viene interrotto per prevenire blocchi
• Sorgenti flessibili: GitHub, GitLab o qualsiasi URL che restituisca chiavi SSH in testo semplice
• Supporto API: Richieste POST con intestazioni personalizzate per API autenticate
• Pronto per IaC: Stateless, idempotente, perfetto per Ansible/Terraform/cloud-init
• Multi-piattaforma: Funziona su Linux e macOS (AMD64 e ARM64)

Inizio Rapido

1. Scarica

Ottieni l'ultimo binario dalla pagina delle release:

# 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. Configura

Crea un file di configurazione in /etc/authkeysync/config.yaml:

policy:
  backup_enabled: true # Crea backup prima delle modifiche (default: true)
  backup_retention_count: 10 # Numero di backup da conservare (default: 10)
  preserve_local_keys: true # Mantieni le chiavi non presenti nelle sorgenti remote (default: true)

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

3. Esegui

# Prima testa con dry-run
sudo authkeysync --dry-run

# Applica le modifiche
sudo authkeysync

4. Automatizza

Imposta un cron job o un timer systemd per eseguirlo periodicamente:

# Ogni 5 minuti (usa --quiet per ridurre il rumore nei log di cron)
echo "*/5 * * * * root /usr/local/bin/authkeysync --quiet" | sudo tee /etc/cron.d/authkeysync

Opzioni di Configurazione

Policy (tutte opzionali)

Utenti (richiesti)

Sorgenti

Esempio con tutte le opzioni

policy:
  backup_enabled: true
  backup_retention_count: 10
  preserve_local_keys: true

users:
  - username: "deploy"
    sources:
      # Chiavi GitHub semplici
      - url: "https://github.com/your-username.keys"

      # API privata con autenticazione
      - 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

Opzioni CLI

Codici di Uscita

Come Funziona

1. Recupera: Scarica le chiavi SSH dagli URL configurati
2. Analizza: Valida e deduplica le chiavi da tutte le sorgenti
3. Unisci: Opzionalmente mantiene le chiavi che esistono solo localmente
4. Scrivi: Aggiorna atomicamente authorized_keys con i permessi corretti
5. Backup: Crea backup con timestamp prima di qualsiasi modifica

Se una sorgente non riesce a recuperare i dati, AuthKeySync interrompe l'aggiornamento per quell'utente per prevenire blocchi. Il tuo accesso esistente rimane intatto.

Supporta il Progetto

Se trovi utile AuthKeySync, considera di dargli una stella su GitHub e seguirmi su X (Twitter) per aggiornamenti:

• Stella su GitHub
• Segui @eduardoolat su X

Licenza

Licenza MIT. Vedi LICENSE per i dettagli.