Repository navigation
Description
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):
- Chiedere
Import public SSH keys to allow incoming connections to this machine? [y/N], con default No. - 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
ghsolo se già disponibile, senza imporre login/token. - Scaricare via HTTPS la lista di chiavi pubbliche (es. endpoint
https://github.com/<username>.keys; per GitLab endpoint documentato e testato). - Mostrare destinazione reale, tipo/fingerprint delle chiavi, numero di nuove chiavi e di chiavi già presenti, nonché eventuali problemi/assenza di chiavi.
- 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~/.sshcon permessi0700e file0600, 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), tramiteMatch Group administratorsinsshd_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
SYSTEMeAdministrators) senza concedere accesso generico. - Non modificare
sshd_config, non installare/avviaresshd, non aprire firewall, non confondere chiavi client in~/.sshcon 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 --yese.\install.ps1 -Forcenon devono autorizzare automaticamente accessi SSH. Valutare switch separati--import-ssh-keys/-ImportSshKeysper 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-rune-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,-Synce 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 modulilib//windows/per la logica comune di importazione. - Invocazione leggera da
install.sh/install.ps1, separata dalla fase di installazione pacchetti e dal logingh. - Documentare in
README.md,docs/linux.md,docs/macos.md,docs/windows.mde aggiornareFUTURE_IDEAS.mdquando 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 --yeso-Force. - Permessi Unix verificati; su Windows test separati per utente normale, membro Administrators e
sshd_configpersonalizzato, 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
alsd4git commentedon Nov 9, 2026
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.
alsd4git commentedon Nov 9, 2026
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.