SSHper Svogliati
Lo usi tutti i giorni, scrivi ssh utente@server, metti la password e via. Poi un giorno compare un avviso enorme in maiuscolo che parla di attacchi, oppure cambi una riga nella configurazione e il server non ti fa più entrare, e scopri che di SSH sapevi solo quel comando. Chiavi, tunnel, salti tra server e come blindarlo senza chiudersi fuori: tutto quello che c'è dopo la password.
"Ho messo PasswordAuthentication no e riavviato." — "E la chiave l'avevi copiata?" — "…"
Cos'è, e cosa ha sostituito
Un tubo cifrato tra il tuo computer e un altro. Dentro ci passa un terminale, dei file, o qualsiasi altro traffico tu voglia.
Prima di SSH ci si collegava ai server con telnet, rlogin e FTP. Funzionavano benissimo, con un difetto: tutto viaggiava in chiaro, password comprese. Chiunque fosse sulla stessa rete, o su un router lungo la strada, poteva leggerle. SSH (Secure Shell) fa le stesse cose dentro una connessione cifrata, e in più verifica che dall'altra parte ci sia davvero il server che pensi.
Terminale remoto
Il suo mestiere principale: una shell su un'altra macchina, come se fossi lì.
Copiare file
scp, sftp e rsync passano tutti dentro SSH. Anche git, quando usi indirizzi git@….
Tunnel
Porta il traffico di un altro programma dentro la connessione cifrata: un database, un pannello web, una navigazione intera.
ssh è il client, quello che usi tu. sshd è il server, il servizio che aspetta connessioni sulla porta 22. Quasi tutti usano OpenSSH per entrambi: è su ogni Linux, su macOS, e dal 2018 anche dentro Windows 10 e 11.
Da un attacco in un'università finlandese alla backdoor di xz
Trent'anni da strumento di nicchia a pezzo di Internet senza cui nessun server si gestisce.
Tatu Ylönen e la porta 22
All'università di tecnologia di Helsinki qualcuno intercetta le password che passano sulla rete. Un ricercatore, Tatu Ylönen, scrive in pochi mesi un sostituto cifrato di telnet e lo pubblica gratis. Chiede all'ente che assegna le porte un numero tra quella di telnet (23) e quella di FTP (21): ottiene la 22. In pochi mesi lo usano decine di migliaia di persone.
OpenSSH
SSH diventa un prodotto commerciale con una licenza sempre più restrittiva. Gli sviluppatori di OpenBSD prendono l'ultima versione libera e la riscrivono: nasce OpenSSH. Da allora è lo standard di fatto, ed è ancora mantenuto da quel progetto.
SSH-2 diventa uno standard
La seconda versione del protocollo, più sicura, è pubblicata come standard ufficiale (RFC 4251–4254). La prima versione, con difetti noti, viene abbandonata.
Chiavi su hardware e crittografia post-quantistica
OpenSSH supporta le chiavi FIDO2: la chiave privata sta su una chiavetta tipo YubiKey e non esce mai. Nel 2022 diventa predefinito uno scambio di chiavi pensato per resistere ai futuri computer quantistici, e da OpenSSH 10 (2025) uno basato sul nuovo standard ML-KEM.
La backdoor di xz
Un ingegnere nota che i login SSH sulla sua Debian di test ci mettono mezzo secondo in più. Indaga, e scopre una backdoor nella libreria di compressione xz, inserita in due anni di lavoro paziente da un finto collaboratore: tramite systemd, avrebbe permesso a chi la controllava di entrare in qualsiasi server con sshd. È stata trovata prima di arrivare nelle versioni stabili delle distribuzioni. Per mezzo secondo.
regreSSHion
Una vulnerabilità di sshd che permetteva di eseguire codice come root da remoto, senza password, sui sistemi Linux con glibc. Era un bug già corretto nel 2006 e reintrodotto per sbaglio nel 2020, da cui il nome. Corretta in pochi giorni; da allora OpenSSH rallenta da solo gli indirizzi che si comportano male (PerSourcePenalties).
Il concetto chiave: due chiavi, due domande
Ogni connessione SSH risponde a due domande diverse. Confonderle è l'origine di quasi tutti i dubbi su SSH.
🏠 La chiave dell'host: "sei davvero tu, server?"
Ogni server ha una sua coppia di chiavi, generata all'installazione (/etc/ssh/ssh_host_*_key). Alla prima connessione il tuo client ti mostra l'impronta e, se accetti, la ricorda in ~/.ssh/known_hosts. Le volte dopo controlla che sia la stessa. Se cambia, ti avvisa in maiuscolo.
👤 La chiave dell'utente: "sei davvero tu, utente?"
La tua coppia di chiavi: la privata resta sul tuo computer, la pubblica la copi sul server in ~/.ssh/authorized_keys. Al login il server ti sfida, tu rispondi firmando con la privata, lui verifica con la pubblica. La privata non viaggia mai.
Arrivi in albergo. Prima controlli che sia l'albergo giusto: insegna, indirizzo, quello che ricordavi dall'ultima volta (la chiave dell'host). Se l'insegna è diversa, ti fermi: potrebbe essere un albergo finto messo lì per rubarti la valigia. Poi l'albergo controlla te: mostri un documento che solo tu hai (la chiave dell'utente). Due controlli, in due direzioni. La password è un documento che chiunque può fotocopiare; la chiave no.
# quello che vedi alla prima connessione
The authenticity of host 'server.esempio.it (203.0.113.10)' can't be established.
ED25519 key fingerprint is SHA256:mQk7...Xy9w.
Are you sure you want to continue connecting (yes/no/[fingerprint])?
# sul server (dalla console del provider, o da una sessione già fidata):
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
# se le due impronte coincidono, scrivi yes. Altrimenti non entrare.
VerifyHostKeyDNS yes): come si fa è in DNS per Svogliati.
Le chiavi: crearle, copiarle, proteggerle
Cinque minuti una volta sola, e non scrivi più password. E sei anche più al sicuro.
# 1. crea la coppia di chiavi (ed25519: corta, veloce, moderna)
ssh-keygen -t ed25519 -C "renzo@portatile"
# → ~/.ssh/id_ed25519 (privata) e ~/.ssh/id_ed25519.pub (pubblica)
# la passphrase: mettila. Con l'agent (sezione 5) la scrivi una volta al giorno
# 2. copia la pubblica sul server (l'ultima volta che scrivi la password)
ssh-copy-id -i ~/.ssh/id_ed25519.pub renzo@server.esempio.it
# 3. prova
ssh renzo@server.esempio.it
| Tipo | Quando |
|---|---|
ed25519 | Sempre, oggi. Chiave corta, firma veloce, nessun parametro da sbagliare |
ed25519-sk | Con una chiavetta FIDO2: la privata non esce mai dalla chiavetta (sezione 5) |
rsa (almeno 3072 bit) | Solo per server o dispositivi vecchi che non conoscono ed25519 |
dsa | Mai più: rimossa da OpenSSH 10 |
ecdsa | Funziona, ma non ha vantaggi su ed25519 |
UNPROTECTED PRIVATE KEY FILE!), e il server ignora un authorized_keys scrivibile da altri. Le regole: ~/.ssh a 700, la chiave privata e authorized_keys a 600, la home non scrivibile dal gruppo. Copiare chiavi con permessi sbagliati è la causa numero uno di "ma la chiave c'è!".
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519 ~/.ssh/authorized_keys
chmod 644 ~/.ssh/id_ed25519.pub
ssh-agent e le chiavi su hardware
La passphrase una volta sola, e la chiave privata che nessun malware può copiare.
L'agent è un piccolo programma che tiene in memoria le tue chiavi sbloccate: scrivi la passphrase una volta e lui firma per te per tutta la sessione. Su macOS è integrato con il Portachiavi, su molti desktop Linux parte da solo.
ssh-add ~/.ssh/id_ed25519 # sblocca e aggiungi la chiave
ssh-add -l # quali chiavi ha l'agent
ssh-add -t 8h ~/.ssh/id_ed25519 # solo per 8 ore, poi la dimentica
ssh-add -D # dimentica tutto
# macOS: passphrase nel Portachiavi, la chiave si sblocca da sola
ssh-add --apple-use-keychain ~/.ssh/id_ed25519
ssh -A (agent forwarding)Inoltra il tuo agent al server, così da lì puoi saltare su un altro server con le tue chiavi. Comodo. Ma per tutta la durata della connessione, chiunque sia root su quel server può usare il tuo agent per entrare ovunque tu possa entrare. Per saltare da un server all'altro usa ProxyJump (sezione 8), che non ha questo problema.
Chiavi FIDO2: la privata non esce mai
Con una chiavetta FIDO2 (YubiKey e simili) la chiave privata viene generata dentro la chiavetta e non si può estrarre. Sul computer resta solo un riferimento inutile senza la chiavetta. Per ogni login la tocchi: un malware sul tuo portatile può rubare un file, non un oggetto fisico.
ssh-keygen -t ed25519-sk -O resident -O verify-required -C "renzo@yubikey"
# resident: la chiave si può recuperare dalla chiavetta su un altro computer (ssh-keygen -K)
# verify-required: oltre al tocco, chiede il PIN della chiavetta
ssh-copy-id -i ~/.ssh/id_ed25519_sk.pub renzo@server.esempio.it
~/.ssh/config: il file che ti cambia la vita
Smetti di ricordare indirizzi, porte, utenti e chiavi. Scrivi ssh web1 e basta.
# i blocchi più specifici prima: vince il primo valore trovato
Host web1
HostName 203.0.113.10
User renzo
Port 2222
IdentityFile ~/.ssh/id_ed25519
Host pi-* # tutti i Raspberry: pi-cucina, pi-garage…
User pi
HostName %h.lan
Host vecchio-switch # un dispositivo che conosce solo algoritmi vecchi
HostName 192.168.1.2
HostKeyAlgorithms +ssh-rsa
PubkeyAcceptedAlgorithms +ssh-rsa
# valori predefiniti per tutti, in fondo
Host *
IdentitiesOnly yes # prova solo la chiave indicata, non tutte
ServerAliveInterval 30 # niente sessioni che muoiono da sole
AddKeysToAgent yes
ControlMaster auto # riusa la stessa connessione:
ControlPath ~/.ssh/cm-%r@%h:%p # la seconda finestra si apre all'istante
ControlPersist 10m
~.Una sessione SSH bloccata (rete caduta, server spento) non risponde più a niente, nemmeno a Ctrl+C. Premi Invio, poi ~ e .: il client chiude la connessione all'istante. ~? mostra gli altri comandi.
Il file vale per tutti gli strumenti che usano SSH: scp web1:file ., rsync, git, e anche molti client grafici lo leggono.
I tunnel: portare altro traffico dentro SSH
Un database che ascolta solo in locale, un pannello web non esposto, una rete Wi-Fi di cui non ti fidi. SSH ci fa passare tutto.
| Tipo | Comando | Cosa fa | Esempio |
|---|---|---|---|
Locale (-L) | ssh -L 5433:localhost:5432 db1 | Una porta sul tuo computer porta a una porta vista dal server | Il PostgreSQL del server, che ascolta solo su localhost, diventa localhost:5433 sul tuo portatile |
Remoto (-R) | ssh -R 8080:localhost:3000 vps | Una porta sul server porta a una porta del tuo computer | Mostri a un collega l'app che gira sul tuo PC, tramite il VPS |
Dinamico (-D) | ssh -D 1080 vps | Un proxy SOCKS: tutto il traffico del browser esce dal server | Navighi da un Wi-Fi pubblico come se fossi a casa |
# -N: niente shell, solo tunnel -f: vai in background
ssh -fN -L 8443:127.0.0.1:443 web1
# ora https://localhost:8443 è il pannello del server, che verso Internet non è esposto
# nel config, per non riscriverlo ogni volta
Host web1-pannello
HostName 203.0.113.10
LocalForward 8443 127.0.0.1:443
AllowTcpForwarding no). Per collegare stabilmente reti e dispositivi, invece di tunnel SSH sempre accesi è meglio una VPN: vedi VPN per Svogliati.
Jump host e bastion: arrivare dove non si arriva
I server interni non sono raggiungibili da Internet, e va bene così. Ci si arriva passando da un server solo, ben protetto.
Il bastion (o jump host) è l'unico server esposto, con SSH blindato e i log sotto controllo. Gli altri accettano SSH solo da lui. Con ProxyJump il tuo client si collega al bastion e da lì apre un tunnel verso il server interno: la connessione cifrata resta tra te e il server finale, il bastion fa solo da tubo e non vede le tue chiavi.
# da riga di comando
ssh -J renzo@bastion.esempio.it renzo@10.0.0.20
# nel config: poi basta "ssh db-interno"
Host bastion
HostName bastion.esempio.it
User renzo
Host db-interno
HostName 10.0.0.20
ProxyJump bastion
Blindare sshd, senza chiudersi fuori
Poche righe fanno quasi tutto il lavoro. L'ordine in cui le applichi decide se stasera dormi o chiami il supporto del provider.
Prima la chiave, poi via le password
Copia la chiave, verifica di entrare con la chiave da una nuova finestra, e solo allora spegni le password.
Non chiudere la sessione aperta
Dopo ogni modifica, tieni aperta la sessione che hai e prova da un'altra finestra. Se la nuova non entra, la vecchia è la tua scialuppa.
sshd -t prima di ricaricare
Controlla la sintassi. Un errore nel file e sshd non riparte: niente nuove connessioni, per nessuno.
# un file a parte nella cartella .d: gli aggiornamenti non lo toccano
PermitRootLogin no # root solo via sudo da un utente normale
PasswordAuthentication no # solo chiavi
KbdInteractiveAuthentication no
AllowUsers renzo deploy # solo questi utenti possono entrare
MaxAuthTries 3
LoginGraceTime 30
X11Forwarding no
AllowAgentForwarding no
AllowTcpForwarding no # se non usi tunnel su questo server
sudo sshd -t # nessun output = sintassi corretta
sudo sshd -T | grep -iE 'passwordauth|permitroot|allowusers' # la configurazione effettiva
sudo systemctl reload ssh # "ssh" su Debian e Ubuntu, "sshd" su Red Hat
# ora, DA UN'ALTRA FINESTRA, prova a entrare. Solo dopo chiudi la prima.
| Misura | Quanto aiuta |
|---|---|
| Solo chiavi, niente password | Tantissimo. I tentativi automatici diventano inutili |
Niente root diretto, AllowUsers | Tanto: meno bersagli, e sai chi entra |
| SSH solo da VPN o da IP noti (firewall) | Tantissimo: la porta non risponde agli sconosciuti |
| Aggiornamenti di sicurezza automatici | Tanto: regreSSHion insegna |
| Cambiare porta (2222 invece di 22) | Poco: meno rumore nei log, zero sicurezza in più contro chi ti cerca davvero |
ssh.socket: è systemd ad ascoltare sulla porta. Se cambi Port e ricarichi solo il servizio, continua ad ascoltare sulla vecchia. Dopo la modifica: sudo systemctl daemon-reload && sudo systemctl restart ssh.socket. E apri la porta nuova nel firewall prima. Per valutare la configurazione degli algoritmi c'è anche l'audit SSH di NetForge.
fail2ban, e come non bannarsi da soli
Legge i log, conta i tentativi falliti, blocca l'indirizzo nel firewall. Funziona benissimo. Anche contro di te.
[DEFAULT]
ignoreip = 127.0.0.1/8 ::1 10.8.0.0/24 # la tua VPN o il tuo IP fisso: mai bannati
bantime = 1h
findtime = 10m
maxretry = 5
[sshd]
enabled = true
backend = systemd # legge dal journal (Debian 12 e successive)
sudo fail2ban-client status sshd
sudo fail2ban-client set sshd unbanip 198.51.100.7
ignoreip. Per non ricaderci: IdentitiesOnly yes nel config, così il client prova solo la chiave giusta.
Da OpenSSH 9.8 c'è anche un freno interno, PerSourcePenalties, attivo di default: rallenta gli indirizzi che falliscono troppo o che fanno crashare il processo. Non sostituisce fail2ban (che blocca nel firewall), ma toglie già molto rumore.
Certificati SSH: quando i server sono tanti
Con tre server, copiare chiavi a mano va bene. Con cinquanta server e dieci persone, ogni arrivo e ogni partenza diventa un giro di authorized_keys.
I certificati SSH risolvono il problema con un'autorità: una chiave speciale (la CA) firma la chiave pubblica di un utente, con un nome, una scadenza e gli account su cui vale. I server si fidano della CA, non delle singole chiavi. Quando qualcuno arriva gli firmi la chiave per sei mesi; quando se ne va, il certificato scade da solo. Funziona anche al contrario: i server presentano un certificato dell'host, e i client smettono di chiedere "sei sicuro?" alla prima connessione.
# 1. la CA (tienila al sicuro: chi ha questa chiave entra ovunque)
ssh-keygen -t ed25519 -f ca_utenti -C "CA utenti"
# 2. firma la chiave di Renzo: valida 26 settimane, per gli account renzo e deploy
ssh-keygen -s ca_utenti -I renzo -n renzo,deploy -V +26w id_ed25519.pub
# → id_ed25519-cert.pub, da rimettere accanto alla chiave di Renzo
# 3. su ogni server, una volta: fidati della CA
# /etc/ssh/sshd_config.d/20-ca.conf → TrustedUserCAKeys /etc/ssh/ca_utenti.pub
# 4. leggere un certificato
ssh-keygen -Lf id_ed25519-cert.pub
Il ragionamento è lo stesso dei certificati TLS dei siti, in versione più semplice: le idee di fondo sono in Certificati e PKI per Svogliati.
Copiare file: scp, sftp, rsync
Tre strumenti, tutti dentro SSH. Si sceglie in base a quanta roba devi spostare e quante volte.
# scp: un file al volo (dalla 9.0 usa il protocollo SFTP sotto)
scp backup.tar.gz web1:/srv/backup/
scp web1:/var/log/nginx/error.log .
# sftp: sessione interattiva, comoda per curiosare (ls, get, put)
sftp web1
# rsync: cartelle intere, copia solo le differenze, riprende se si interrompe
rsync -avz --progress ./sito/ web1:/var/www/sito/
rsync -avz --delete --dry-run ./sito/ web1:/var/www/sito/ # prova prima di cancellare
rsync ./sito/ dest/ copia il contenuto di sito dentro dest. rsync ./sito dest/ copia la cartella sito dentro dest. Con --delete, sbagliare la barra può cancellare quello che non volevi. Usa sempre --dry-run la prima volta. Per i backup veri: Backup per Svogliati.
Client grafici
Il terminale basta e avanza. Ma quando i server sono trenta e i tunnel dieci, una finestra con l'elenco aiuta.
| Client | Sistema | Note |
|---|---|---|
| FireLogin ⭐ | macOS, Windows, Linux | Gratuito, circa 4 MB, nativo. Usa l'OpenSSH del sistema e le tue chiavi in ~/.ssh, senza un database suo né un cloud. Host e gruppi, controllo di raggiungibilità, tunnel con un clic, X11 |
| OpenSSH da terminale | Tutti, Windows compreso | Il riferimento. Su Windows c'è già, nel Prompt dei comandi o in PowerShell |
| PuTTY | Windows (anche Linux) | Il classico storico, gratuito. Ha un formato di chiavi tutto suo (.ppk): PuTTYgen le converte |
| MobaXterm | Windows | Tutto in uno: SSH, SFTP grafico, X11. Gratis per uso personale |
| Termius | Tutti, anche telefono | Sincronizza i server tra dispositivi, tramite il loro cloud |
ssh di questa guida, con le stesse chiavi e lo stesso ~/.ssh/config. Niente account, niente cloud, niente chiavi copiate in un database: se un giorno lo togli, i tuoi file restano dove erano. Gratuito per macOS, Windows e Linux su firelogin.netforge.it. (È un progetto di chi scrive questa guida.)
ssh -v. Nove volte su dieci il messaggio c'è: una chiave dell'host cambiata, una chiave rifiutata, un IP bannato. Il programma grafico, semplicemente, non te lo mostrava.
Errori tradotti
Il primo strumento è sempre lo stesso: ssh -v (o -vvv) racconta passo per passo cosa succede.
| Cosa vedi | Cosa vuol dire | Cosa fare |
|---|---|---|
WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! | La chiave dell'host non è quella che ricordavi. O il server è stato reinstallato, o qualcuno si sta mettendo in mezzo | Se sai che è stato reinstallato: verifica la nuova impronta (sezione 3), poi ssh-keygen -R server. Se non lo sai: fermati e chiedi |
Host key verification failed. | Il client ha rifiutato la chiave dell'host (per il motivo sopra, o perché hai risposto no) | Come sopra |
Permission denied (publickey). | Il server accetta solo chiavi e nessuna delle tue va bene | Utente giusto? Chiave giusta (ssh -v dice quale prova)? Permessi di ~/.ssh sul server? Il log del server (journalctl -u ssh) dice il motivo vero |
Too many authentication failures | L'agent ha offerto troppe chiavi sbagliate prima di quella giusta, e il server ha chiuso | IdentitiesOnly yes e IdentityFile nel config |
Connection refused | L'indirizzo risponde, ma nessuno ascolta su quella porta | sshd non è avviato, o ascolta su un'altra porta |
Connection timed out | Nessuna risposta: firewall, indirizzo sbagliato, server spento, o sei bannato | Prova da un'altra rete; controlla firewall e fail2ban dalla console del provider |
kex_exchange_identification: read: Connection reset by peer | Il server ha chiuso subito: troppe connessioni, IP penalizzato, o un blocco (TCP wrapper, firewall) | Aspetta qualche minuto; controlla MaxStartups, fail2ban, i log del server |
no matching host key type found. Their offer: ssh-rsa | Server vecchio che conosce solo un algoritmo disattivato dal 2021 (ssh-rsa con SHA-1) | Per quel solo host: HostKeyAlgorithms +ssh-rsa nel config. Meglio ancora: aggiorna il dispositivo |
no matching key exchange method found | Lo stesso problema, sullo scambio di chiavi | KexAlgorithms +diffie-hellman-group14-sha1 solo per quell'host |
UNPROTECTED PRIVATE KEY FILE! | La chiave privata è leggibile da altri | chmod 600 ~/.ssh/id_ed25519 |
client_loop: send disconnect: Broken pipe | La connessione è caduta: inattività, router che chiude le connessioni ferme, Wi-Fi | ServerAliveInterval 30 nel config |
sign_and_send_pubkey: signing failed ... agent refused operation | L'agent non ha potuto firmare: chiave FIDO non toccata, chiave non sbloccata | Tocca la chiavetta quando lampeggia; ssh-add di nuovo |
Load key ...: invalid format | Il file non è una chiave OpenSSH (spesso una chiave PuTTY .ppk, o un copia-incolla rovinato) | Convertila con PuTTYgen, o controlla di aver copiato tutte le righe |
Cheat sheet
I comandi da tenere a portata di mano.
| Comando | Cosa fa |
|---|---|
ssh-keygen -t ed25519 | Crea una coppia di chiavi |
ssh-copy-id utente@server | Copia la chiave pubblica sul server |
ssh-add, ssh-add -l | Aggiunge la chiave all'agent; elenca le chiavi caricate |
ssh -v utente@server | Collegamento con il racconto di ogni passo |
ssh -J bastion server | Salta attraverso un bastion |
ssh -L 5433:localhost:5432 server | Tunnel locale |
ssh -D 1080 server | Proxy SOCKS |
ssh-keygen -R server | Dimentica la chiave dell'host (dopo una reinstallazione) |
ssh-keygen -lf chiave.pub | Impronta di una chiave |
ssh-keyscan server | Legge le chiavi pubbliche dell'host senza collegarsi |
sudo sshd -t, sudo sshd -T | Controlla la sintassi; mostra la configurazione effettiva |
journalctl -u ssh -f | I log del server SSH in diretta (sshd su Red Hat) |
| Invio ~ . | Chiude una sessione bloccata |
~/.ssh/config ordinato, le password spente sui server e la porta 22 non esposta a Internet. Quattro cose, un pomeriggio, e smetti di pensare a SSH per anni. Quando poi compare quell'avviso in maiuscolo, non scrivere ssh-keygen -R di riflesso: prima chiediti perché.