Skip to content

feat(ssh): optional cross-platform import of SSH authorized keys from GitHub/GitLab #5

Open

Description

@alsd4git

Obiettivo

Aggiungere al bootstrap dei dotfiles uno step esplicitamente opzionale, multipiattaforma e ri-eseguibile per importare le chiavi SSH pubbliche di uno o più account GitHub/GitLab in authorized_keys, così da autorizzare l'accesso in ingresso alla macchina senza copiare manualmente le chiavi.

Questo non è equivalente a gh auth login o gh ssh-key add (già menzionati da lib/installer-toolchains.sh): quei flussi riguardano autenticazione a GitHub e chiavi usate in uscita. Collegare questa issue alla voce Security & Keys di FUTURE_IDEAS.md, ma mantenerla implementativamente distinta dalla generazione di chiavi locali/GPG.

UX proposta

Nell'installazione interattiva normale (install.sh, install.ps1):

  1. Chiedere Import public SSH keys to allow incoming connections to this machine? [y/N], con default No.
  2. Chiedere il provider (GitHub, GitLab.com; istanze GitLab self-hosted eventualmente in una fase successiva) e lo username, senza hardcodare l'account personale. Eventuale username suggerito da gh solo se già disponibile, senza imporre login/token.
  3. Scaricare via HTTPS la lista di chiavi pubbliche (es. endpoint https://github.com/<username>.keys; per GitLab endpoint documentato e testato).
  4. Mostrare destinazione reale, tipo/fingerprint delle chiavi, numero di nuove chiavi e di chiavi già presenti, nonché eventuali problemi/assenza di chiavi.
  5. Chiedere un'ulteriore conferma esplicita prima di scrivere; nessuna modifica in caso di errore o risposta negativa.

La funzionalità deve anche essere invocabile indipendentemente dal bootstrap, ad esempio tramite scripts/import-ssh-keys.sh e scripts/import-ssh-keys.ps1 (nomi da allineare alle convenzioni della repo). Non introdurre una dipendenza obbligatoria da ssh-import-id, gh o Python: sfruttare gli strumenti di base già disponibili (curl/client HTTPS su Unix; PowerShell/.NET su Windows).

Percorsi e peculiarità di piattaforma

  • Linux/macOS: lavorare sull'account effettivo che invoca il comando, ~/.ssh/authorized_keys; creare ~/.ssh con permessi 0700 e file 0600, senza alterare chiavi preesistenti. Non abilitare automaticamente il server SSH.
  • Windows, utente non amministratore: destinazione ordinaria %USERPROFILE%\.ssh\authorized_keys, con ACL compatibili con OpenSSH.
  • Windows, account nel gruppo Administrators: la configurazione predefinita di Windows OpenSSH Server spesso usa %ProgramData%\ssh\administrators_authorized_keys (file condiviso tra amministratori, non un file per singolo admin), tramite Match Group administrators in sshd_config. Rilevare membership usando il SID del gruppo, non nomi localizzati; verificare la configurazione effettiva prima di scegliere il percorso e, se non determinabile, spiegare il dubbio/lasciare scegliere in modo esplicito, senza inventare la destinazione.
  • Windows admin file: avvisare chiaramente dell'ambito condiviso e della richiesta di elevazione; non elevare né creare/modificare il file silenziosamente. Preservare/applicare ACL corrette (in genere SYSTEM e Administrators) senza concedere accesso generico.
  • Non modificare sshd_config, non installare/avviare sshd, non aprire firewall, non confondere chiavi client in ~/.ssh con quelle autorizzate sul server. Se OpenSSH Server non è presente, presentare soltanto un avviso informativo.

Sicurezza, idempotenza e modalità dell'installer

  • Default deny: nessuna scrittura senza opt-in specifico. Soprattutto ./install.sh --all --yes e .\install.ps1 -Force non devono autorizzare automaticamente accessi SSH. Valutare switch separati --import-ssh-keys / -ImportSshKeys per l'automazione, sempre con scelte di provider/username esplicite; definire il comportamento non-interattivo in modo sicuro.
  • Dry-run: anteprima di destinazione e chiavi da aggiungere senza scritture; integrarsi con la semantica già presente di --dry-run e -DryRun.
  • Idempotenza: riconoscere duplicati confrontando tipo + payload base64 (ignorare commenti); preservare intatti chiavi, commenti e righe manuali già presenti. Nessun duplicato ai successivi run.
  • Verificare HTTPS, risposta HTTP, input username e righe di chiave SSH; non trattare il contenuto scaricato come codice/shell, non eseguire pipeline remote e non importare risposte vuote/HTML/errori.
  • Scrittura protetta (preparazione completa, backup ragionevole e operazione atomica dove possibile); fallimento download/parsing/permessi ⇒ nessuna modifica parziale.
  • Mostrare chiaramente che rimuovere una chiave da GitHub/GitLab non la revoca dai server già configurati. Nessuna sincronizzazione distruttiva o cancellazione automatica; documentare revoca manuale e provenienza delle chiavi senza introdurre commenti invasivi.
  • Rispettare --minimal, --sync, --uninstall, -Minimal, -Sync e gli altri mode guard senza cambiare semantiche esistenti. Non rimuovere chiavi in uninstall in assenza di un meccanismo di ownership sicuro.

Collocazione suggerita

  • Helper Bash e PowerShell indipendenti sotto scripts/ o moduli lib//windows/ per la logica comune di importazione.
  • Invocazione leggera da install.sh / install.ps1, separata dalla fase di installazione pacchetti e dal login gh.
  • Documentare in README.md, docs/linux.md, docs/macos.md, docs/windows.md e aggiornare FUTURE_IDEAS.md quando consegnata.

Acceptance criteria / test

  • Import GitHub e GitLab su Linux, macOS e Windows con username scelto a runtime.
  • Nessun pacchetto extra obbligatorio; nessun login GitHub richiesto per chiavi pubbliche.
  • Primo import, seconda esecuzione idempotente, preservazione di righe già presenti e import da più utenti.
  • 404/timeout/TLS/risposta vuota/chiave malformata non corrompono il file esistente.
  • Dry-run e modalità non interattive sicure, senza import implicito con --all --yes o -Force.
  • Permessi Unix verificati; su Windows test separati per utente normale, membro Administrators e sshd_config personalizzato, con ACL appropriate.
  • Test isolati con endpoint HTTP mock e HOME/profili temporanei; integrare CI/test shell e PowerShell esistenti.
  • Documentazione con esempi, limitazioni Windows, differenza tra SSH client/server e procedura di revoca.

Priorità proposta: P2 · enhancement / security & onboarding.

Activity

  1. alsd4git commented on Nov 9, 2026

    @alsd4git
    OwnerAuthor

    La PR #9 implementa l'import opzionale e i test isolati. Sandbox: import GitHub utente e amministratori, dry-run e idempotenza PASS. La verifica live GitLab resta aperta: da questa rete l'endpoint restituisce HTTP 403.

  2. alsd4git commented on Nov 9, 2026

    @alsd4git
    OwnerAuthor

    La PR #9 è integrata in main (c5beb38): import opt-in, conferma e anteprima delle chiavi, backup, documentazione e test. CI e prima review automatica verdi. Mantengo aperta la issue per la prova GitLab live (HTTP 403 dalla rete di test), le verifiche su configurazioni sshd personalizzate e le altre combinazioni reali ancora non coperte.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions