SSH
Praktický přehled práce s SSH od vytvoření klíče přes konfiguraci klienta
a zabezpečení serveru až po diagnostiku. Návod předpokládá OpenSSH (Linux,
macOS, Windows 10/11). Zástupné hodnoty (uzivatel, server.example.com,
nazev) nahraďte vlastními.
1. Generování nového SSH klíče
Používejte moderní algoritmus ed25519 a klíč pojmenujte podle jeho
účelu, ne výchozím univerzálním názvem.
ssh-keygen -t ed25519 -C "vas.email@example.com" -f ~/.ssh/id_ed25519_nazev
Vzniknou dva soubory: tajný klíč id_ed25519_nazev a veřejný klíč
id_ed25519_nazev.pub.
| Situace | Co udělat |
|---|---|
| Klíč pro ruční práci | Zadejte silnou passphrase. Pokud klíč někdo zcizí z disku, bez passphrase ho nepoužije. |
| Klíč pro automatizaci (cron, skripty) | Vygenerujte ho bez passphrase parametrem -N "" a omezte jeho použití (viz oddíl 9). |
Tip: Přepínač
-Cje jen komentář (popisek klíče). Neovlivňuje bezpečnost, pouze usnadňuje orientaci.
2. Zkopírování klíče na server
Veřejný klíč se uloží do souboru ~/.ssh/authorized_keys na serveru:
ssh-copy-id -i ~/.ssh/id_ed25519_nazev.pub uzivatel@server.example.com
Pokud přihlášení klíčem nefunguje, zkontrolujte na serveru práva:
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
Pozor: Domovský adresář uživatele na serveru nesmí být zapisovatelný pro skupinu ani ostatní, jinak SSH server klíč ignoruje.
3. Konfigurace SSH klienta (~/.ssh/config)
Pokud nepoužíváte výchozí názvy klíčů, klient neví, který klíč použít pro
kterou službu. Vytvořte (nebo upravte) soubor ~/.ssh/config na svém
počítači:
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519_github
IdentitiesOnly yes
Host skola
HostName server.example.com
User vas_login
IdentityFile ~/.ssh/id_ed25519_skola
IdentitiesOnly yes
Pak se stačí připojit zkráceně: ssh skola.
| Volba | Význam |
|---|---|
Host |
Zkratka (alias), kterou píšete do příkazu ssh |
HostName |
Skutečná adresa serveru |
User |
Přihlašovací jméno |
IdentityFile |
Cesta k tajnému klíči |
IdentitiesOnly yes |
Použije se jen zde uvedený klíč, ne všechny klíče z agenta |
Port |
Port serveru, pokud není výchozí 22 |
Soubor má mít práva chmod 600 ~/.ssh/config.
Pozor: SSH čte
configshora dolů a pro každou volbu platí první nalezená hodnota. Konkrétní bloky proto patří nahoru, obecný blokHost *s výchozími hodnotami na konec souboru.
4. Správa passphrase pomocí ssh-agent
Pokud klíč chráníte passphrase, nechcete ji psát při každém připojení.
Tuto práci převezme ssh-agent.
1) Ověřte, zda agent běží:
ssh-add -l
Výpis „The agent has no identities“ znamená, že agent běží, ale je prázdný. Chyba „Could not open a connection to your authentication agent“ znamená, že neběží.
2) Spusťte agenta (pokud neběží):
eval "$(ssh-agent -s)"
3) Přidejte klíč do agenta:
ssh-add ~/.ssh/id_ed25519_nazev
4) Volitelně: přidávejte klíče do agenta automaticky při prvním
použití. Na konec ~/.ssh/config přidejte:
Host *
AddKeysToAgent yes
Tip: Na Linuxu s desktopem GNOME běží agent obvykle automaticky (GNOME Keyring nebo
gcr-ssh-agent) a passphrase si může zapamatovat po přihlášení do desktopu. Konkrétní chování se mezi distribucemi mírně liší.
5. Údržba klíčů
| Úkol | Příkaz |
|---|---|
| Změnit nebo přidat passphrase | ssh-keygen -p -f ~/.ssh/id_ed25519_nazev |
| Obnovit veřejný klíč z tajného | ssh-keygen -y -f ~/.ssh/id_ed25519_nazev > ~/.ssh/id_ed25519_nazev.pub |
| Zobrazit otisk (fingerprint) klíče | ssh-keygen -l -f ~/.ssh/id_ed25519_nazev.pub |
| Odebrat klíč z agenta | ssh-add -d ~/.ssh/id_ed25519_nazev |
| Odebrat všechny klíče z agenta | ssh-add -D |
Rotace a odvolání: Při podezření na únik nebo při vyřazení zařízení smažte příslušný řádek z
~/.ssh/authorized_keysna všech serverech, odeberte veřejný klíč z GitHubu/GitLabu a vygenerujte nový pár.
6. Přidání klíče na GitHub / GitLab
- Zobrazte veřejný klíč:
cat ~/.ssh/id_ed25519_github.pub - V nastavení účtu otevřete SSH and GPG keys → New SSH key (GitLab: Preferences → SSH Keys) a vložte celý řádek.
- Ověřte spojení:
ssh -T git@github.com
7. Zabezpečení serveru (/etc/ssh/sshd_config)
Až budete mít přihlášení klíčem ověřené, vypněte přihlašování heslem:
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no
PubkeyAuthentication yes
Konfiguraci otestujte a načtěte:
sudo sshd -t # kontrola syntaxe, bez výpisu = v pořádku
sudo systemctl reload ssh # Debian/Ubuntu; jinde služba sshd
sudo sshd -T | grep -i passwordauthentication # skutečně platná hodnota
Pozor: Soubory v
/etc/ssh/sshd_config.d/*.confse načítají na začátku hlavního konfiguračního souboru a i zde platí první nalezená hodnota. Například50-cloud-init.confna cloudových serverech sPasswordAuthentication yesvaše nastavení přebije. Upravte proto i tyto soubory, nebo vlastní nastavení vložte do souboru s nižším číslem, např./etc/ssh/sshd_config.d/10-zabezpeceni.conf.
Pozor: Nejdříve vyzkoušejte přihlášení klíčem v druhém terminálu a teprve pak vypněte hesla. Stávající relaci nechte otevřenou, dokud změnu neověříte, jinak se můžete zamknout.
Proti opakovaným pokusům o přihlášení pomůže fail2ban.
8. Skok přes jiný server (bastion / ProxyJump)
Když je cílový server dostupný jen přes mezilehlý stroj, použijte
ProxyJump. Je bezpečnější než přeposílání agenta.
Host vnitrni-server
HostName 10.0.0.15
User uzivatel
ProxyJump uzivatel@bastion.example.com
IdentityFile ~/.ssh/id_ed25519_prace
IdentitiesOnly yes
Nebo jednorázově: ssh -J uzivatel@bastion.example.com uzivatel@10.0.0.15
Pozor: Přeposílání agenta (
ForwardAgent yes/ssh -A) zapínejte jen u serverů, kterým plně důvěřujete. Správce cizího serveru by mohl váš agent zneužít.
9. Volby v authorized_keys (omezení klíče)
Každý řádek v ~/.ssh/authorized_keys je jeden povolený klíč. Volby se
píší před typ klíče, oddělují se čárkou a bez mezer (mezery smí
být jen uvnitř uvozovek):
volba1,volba2="hodnota" ssh-ed25519 AAAAC3Nza... komentar
Bez voleb má klíč plná práva uživatele. Pro automatizaci je to zbytečně mnoho.
| Volba | Co dělá |
|---|---|
from="seznam" |
Klíč funguje jen z uvedených IP adres, rozsahů CIDR nebo jmen počítačů. Povoluje hvězdičky, vykřičník (!) vyloučí výjimku. |
command="příkaz" |
Ať klient zadá cokoli, spustí se jen tento příkaz. Původní požadavek je v proměnné SSH_ORIGINAL_COMMAND. |
restrict |
Vypne vše naráz: přesměrování portů, agenta, X11, pty i ~/.ssh/rc. Doporučuje se uvádět vždy (OpenSSH 7.2+). |
no-port-forwarding |
Zakáže tunelování portů. |
no-agent-forwarding |
Zakáže přeposílání agenta. |
no-X11-forwarding |
Zakáže grafické aplikace přes SSH. |
no-pty |
Zakáže interaktivní terminál. |
port-forwarding, pty |
Po restrict znovu povolí jednotlivou vlastnost. |
permitopen="host:port" |
Omezí, kam smí klíč tunelovat (při povoleném přesměrování portů). |
expiry-time="20271231" |
Po uvedeném datu klíč přestane platit (OpenSSH 8.2+). |
cert-authority |
Klíč na řádku je certifikační autorita, ne běžný uživatel (SSH certifikáty, pokročilé téma). |
Příklady:
# Záloha z jednoho serveru, jen čtení jedné složky
restrict,from="203.0.113.10",command="/usr/bin/rrsync -ro /srv/data" ssh-ed25519 AAAA... zaloha-cron
# Klíč, který umí jen restartovat jednu službu
restrict,from="192.168.1.20",command="sudo systemctl restart myapp" ssh-ed25519 AAAA... restart-myapp
# Přístup jen k databázi přes tunel
restrict,port-forwarding,permitopen="10.0.0.5:5432" ssh-ed25519 AAAA... db-tunel
# Dočasný přístup, který sám vyprší
restrict,pty,expiry-time="20271231" ssh-ed25519 AAAA... kolega-externista
Na co si dát pozor:
- U
from=může dynamická IP adresa nebo NAT odmítnout i vás. Skutečnou zdrojovou adresu zjistíte na serveru příkazemecho $SSH_CLIENT.SSH_ORIGINAL_COMMANDje nedůvěryhodný vstup. Vždy ho validujte a nikdy ho nespouštějte přeseval.- Příkaz se
sudovyžaduje pravidlo v sudoers bez hesla omezené přesně na tento příkaz (sudo visudo -f /etc/sudoers.d/myapp).- Skript
rrsyncje součástí balíčku rsync (od verze 3.2.4 jako/usr/bin/rrsync, ve starších verzích v/usr/share/doc/rsync/scripts/).- Vnitřní uvozovky v hodnotě escapujte (
\").- Po úpravě otestujte přihlášení z nové relace a stávající nechte otevřenou.
- Podpora voleb závisí na verzi OpenSSH. Přesnou syntaxi najdete v
man sshd(sekce AUTHORIZED_KEYS FILE FORMAT).
10. Jeden klíč pro více serverů
Cíl: připojovat se na více serverů jedním klíčem, a to jak krátkým
názvem (ssh um), tak plným (ssh um.mendelu.cz). Servery z příkladu:
- MENDELU:
um,math4u,jupyter(plné názvy*.mendelu.cz) - VŠB:
math4u-latex.vsb.cz,msr-latex.vsb.cz
# --- Krátké aliasy (doplní plný název serveru) ---
Host um
HostName um.mendelu.cz
Host math4u
HostName math4u.mendelu.cz
Host jupyter
HostName jupyter.mendelu.cz
Host math4u-latex
HostName math4u-latex.vsb.cz
Host msr-latex
HostName msr-latex.vsb.cz
# --- Společné nastavení pro MENDELU ---
Host um math4u jupyter *.mendelu.cz
User vas_login
IdentityFile ~/.ssh/id_ed25519_skola
IdentitiesOnly yes
Jak to funguje:
- SSH prochází všechny bloky, jejichž
Hostodpovídá zadanému jménu, a pro každou volbu použije první nalezenou hodnotu. Alias tak převezmeHostNameze svého bloku aUseraIdentityFileze společného bloku. Hostpřijímá více vzorů najednou, oddělených mezerou. Pokrývá tak krátký i plný název.- Zástupný znak
*.mendelu.czpokryje všechny servery v doméně, i ty, které přidáte později. Userje rozdělený do dvou bloků, protože instituce mají obvykle různá přihlašovací jména. Pokud je máte stejná, spojte bloky do jednoho.
Použití:
ssh um
ssh jupyter.mendelu.cz
ssh math4u
Nasazení veřejného klíče na všechny servery (po jednom, přihlásíte se heslem):
for s in um math4u jupyter math4u-latex msr-latex; do
ssh-copy-id -i ~/.ssh/id_ed25519_skola.pub "$s"
done
ssh-copy-id použije User i HostName z configu, takže stačí alias.
Jeden klíč, nebo dva? Pro obě instituce můžete použít jeden klíč, pokud jde o stejný účel i stejného majitele. Pokud chcete oddělit rizika (únik klíče nezasáhne obě instituce), vytvořte
id_ed25519_mendeluaid_ed25519_vsba v každém bloku uveďte jinýIdentityFile.
11. Diagnostika a užitečné testy
Přihlášení s konkrétním klíčem v podrobném režimu (ukáže, které klíče se zkoušejí a kde přihlášení selhává):
ssh -v -i ~/.ssh/id_ed25519_nazev uzivatel@server.example.com
Více v (-vv, -vvv) znamená podrobnější výpis.
Vynucení přihlášení heslem (test, zda server heslo povoluje):
ssh -o PubkeyAuthentication=no uzivatel@server.example.com
Výpis výsledné konfigurace klienta pro daný alias:
ssh -G skola | grep -Ei '^(hostname|user|identityfile|port) '
Test GitHubu:
ssh -T git@github.com
12. Řešení častých chyb
| Chyba | Příčina a řešení |
|---|---|
Permission denied (publickey) |
Server klíč nepřijal. Zkontrolujte authorized_keys, práva (700/600) a spusťte ssh -v. Na serveru pomůže sudo journalctl -u ssh. |
WARNING: UNPROTECTED PRIVATE KEY FILE! |
Tajný klíč má příliš volná práva. Spusťte chmod 600 ~/.ssh/id_ed25519_nazev. |
Too many authentication failures |
Agent nabízí příliš mnoho klíčů. Použijte IdentitiesOnly yes a IdentityFile v configu. |
REMOTE HOST IDENTIFICATION HAS CHANGED! |
Změnil se otisk serveru (přeinstalace, nebo útok). Pokud jste si jisti, že jde o legitimní změnu, odstraňte starý záznam: ssh-keygen -R server.example.com. |
Host key verification failed |
Záznam v ~/.ssh/known_hosts nesouhlasí nebo chybí a nelze se zeptat. Postup je stejný jako u předchozí chyby. |
Tip: Při prvním připojení SSH zobrazí otisk serveru. U důležitého serveru ho před potvrzením
yesporovnejte s údajem od správce.
13. Zálohování klíčů
- Tajné klíče zálohujte pouze šifrovaně (správce hesel, šifrovaný disk nebo kontejner).
- Klíč chráněný passphrase je při záloze bezpečnější, passphrase si uložte zvlášť.
- Klíče, které snadno nahradíte, nemusíte zálohovat vůbec. Při ztrátě vygenerujte nový.
- Zvažte hardwarový klíč (YubiKey apod.,
ssh-keygen -t ed25519-sk). Tajná část pak neopustí zařízení.
14. Zlatá pravidla bezpečnosti
- Jeden účel = jeden klíč. Nemíchejte osobní klíč pro GitHub, firemní server a školní počítač.
- Tajný klíč (soubor bez přípony
.pub) nikdy nikomu nedávejte a nezálohujte ho na nezabezpečená místa. Veřejný klíč (.pub) sdílet můžete. - Automatizace: Pro cron a skripty používejte výhradně dedikovaný
klíč bez passphrase, omezený na danou úlohu a server (volby
restrict,from="…"acommand="…"vauthorized_keys). - Práva souborů: Tajné klíče mají mít
chmod 600, adresář~/.sshchmod 700. - Na serveru po ověření klíčů vypněte přihlašování heslem a rootem.
Další zdroje
- Manuálové stránky:
man ssh,man ssh_config,man sshd_config,man sshd - Dokumentace OpenSSH: https://www.openssh.com/manual.html
- GitHub – připojení přes SSH: https://docs.github.com/en/authentication/connecting-to-github-with-ssh