Dvoufaktorové ověření (2FA) na Ubuntu Serveru přes Google Authenticator
Jednorázový kód z telefonu pro SSH, sudo i konzoli. Navazuje na návod SSH klíče.
Zaškrtnete, kde chcete kód vyžadovat (SSH, sudo, přihlášení u konzole), vygenerujete tajný klíč do telefonu a zapnete ho. Heslem se přes SSH dál přihlásit nejde; uživatelům bez klíče ho můžete povolit, ale jen s kódem.
Obsah
01 · Začínáme
Než začnete
Ke klíči SSH přidáte jednorázový kód z aplikace v telefonu. Kdo by získal váš klíč i s jeho heslem, bez telefonu se na server stejně nedostane.
Server se správným časem (kód platí 30 sekund). Pro SSH navíc hotový návod SSH klíče. Pro server dostupný z internetu je 2FA doporučené, při přístupu z domácí sítě nebo přes Tailscale volitelné, viz Zabezpečení přístupu.
02 · Telefon
Aplikace a tajné klíče
Do telefonu nainstalujte aplikaci pro jednorázové kódy, např. Google Authenticator, Microsoft Authenticator, 2FAS nebo Aegis. Další kroky jsou na serveru.
Krok 1: Nainstalujte modul pro PAM
sudo apt update && sudo apt install libpam-google-authenticatorKrok 2: Ověřte, že server má přesný čas
Kód se počítá z času. Při odchylce server správné kódy odmítá:
timedatectl | grep -E 'synchronized|NTP service'System clock synchronized: yes
NTP service: activeJe-li výsledek no, nastavte synchronizaci času.
Krok 3: Vygenerujte tajný klíč a načtěte ho do telefonu
Pod svým uživatelem, bez sudo. Zobrazený QR kód naskenujte aplikací a opište kód, který ukáže. Na otázky odpovězte y, y, y, n, y (tabulka níže).
google-authenticator # as your user, without sudoOtázky programu a co odpovědět:
| Otázka | Odpověď |
|---|---|
| …tokens to be time-based? | y: kódy podle času |
| …update your "~/.google_authenticator" file? | y: uloží tajný klíč |
| …disallow multiple uses of the same authentication token? | y: každý kód jde použít jen jednou |
| …increase the window from its default size…? | n: s přesným časem větší tolerance není potřeba |
| …enable rate-limiting? | y: nejvýš 3 pokusy za 30 sekund |
Krok 4: Máte další uživatele? Tajný klíč i pro ně
Jen pokud server používají i další lidé. Kód pro to, co jste zaškrtli nahoře, pak potřebuje každý z nich, a to ještě před zapnutím, jinak se nepřihlásí. Platí i pro uživatele bez klíče ze skupiny ssh-password. Každý má vlastní tajný klíč; QR kód naskenuje jeho telefon:
sudo -iu <USER> google-authenticatorPod QR kódem je pět záchranných kódů. Uložte je mimo telefon (správce hesel, papír v trezoru). Při ztrátě telefonu vás pustí dovnitř.
03 · Nastavení
Zapnutí 2FA
Změny stávající připojení neodpojí. Novou konfiguraci ověřte v dalším okně a první zavřete, až když přihlášení s kódem funguje.
Pro SSH
Krok 5: SSH: kód místo hesla
Soubor /etc/pam.d/sshd určuje, na co se SSH ptá. Po klíči bude chtít kód. Heslo jen po členech skupiny ssh-password, kteří se přihlašují bez klíče (návod SSH klíče). Výpis má odpovídat druhému bloku:
[ -f /etc/pam.d/sshd.bak ] || sudo cp /etc/pam.d/sshd /etc/pam.d/sshd.bak
sudo groupadd -f ssh-password
grep -q pam_google_authenticator /etc/pam.d/sshd || sudo sed -i 's/^@include common-auth$/auth [success=1 default=ignore] pam_succeed_if.so quiet user notingroup ssh-password\nauth substack common-auth\nauth required pam_google_authenticator.so/' /etc/pam.d/sshd
grep -A2 pam_succeed_if /etc/pam.d/sshdauth [success=1 default=ignore] pam_succeed_if.so quiet user notingroup ssh-password
auth substack common-auth
auth required pam_google_authenticator.soKrok 6: V 00-hardening.conf povolte druhý krok přihlášení
Soubor z návodu SSH klíče. Změní se dva řádky, ostatní včetně portu zůstanou: KbdInteractiveAuthentication na yes (SSH smí položit otázku na kód) a AuthenticationMethods na publickey,keyboard-interactive (nejdřív klíč, potom kód).
sudo sed -i -E 's/^KbdInteractiveAuthentication .*/KbdInteractiveAuthentication yes/; s/^AuthenticationMethods .*/AuthenticationMethods publickey,keyboard-interactive/' /etc/ssh/sshd_config.d/00-hardening.conf
cat /etc/ssh/sshd_config.d/00-hardening.conf# Port <SSH_PORT> (volitelné: odkomentujte a zadejte vlastní port)
PubkeyAuthentication yes
PasswordAuthentication no
KbdInteractiveAuthentication yes
PermitRootLogin no
AuthenticationMethods publickey,keyboard-interactive
AllowGroups ssh-usersKrok 7: Použijte nastavení a v novém okně se přihlaste
Restart SSH, kontrola výsledného nastavení a přihlášení: heslo klíče, potom kód.
sudo sshd -t && sudo systemctl restart sshsudo sshd -T | grep -E '^(usepam|passwordauthentication|kbdinteractiveauthentication|authenticationmethods) 'usepam yes
passwordauthentication no
kbdinteractiveauthentication yes
authenticationmethods publickey,keyboard-interactivessh -i ~/.ssh/<KEY_NAME> -o IdentitiesOnly=yes -p 22 <ADMIN_USER>@<SERVER_IP>Enter passphrase for key '…<KEY_NAME>':
(<ADMIN_USER>@<SERVER_IP>) Verification code:Uživatel bez klíče (skupina ssh-password) se přihlásí heslem a kódem:
ssh -p 22 <USER>@<SERVER_IP>(<USER>@<SERVER_IP>) Password:
(<USER>@<SERVER_IP>) Verification code:Pro sudo
Krok 8: sudo: heslo a kód
V jednom okně si nechte otevřenou správcovskou relaci (sudo -i), dokud v jiném okně sudo s kódem nefunguje.
[ -f /etc/pam.d/sudo.bak ] || sudo cp /etc/pam.d/sudo /etc/pam.d/sudo.bak
grep -q pam_google_authenticator /etc/pam.d/sudo || sudo sed -i '/^@include common-auth/a auth required pam_google_authenticator.so' /etc/pam.d/sudo
grep -E 'common-auth|google_authenticator' /etc/pam.d/sudo@include common-auth
auth required pam_google_authenticator.sosudo -k && sudo true # in a second window: password, then Verification codePro přihlášení u konzole
Krok 9: Přihlášení u konzole: heslo a kód
Pak už ani u serveru osobně nepomůže samotné heslo: bez záchranných kódů a telefonu se nedostanete dovnitř. Na Ubuntu Desktop stejný příkaz spusťte i se souborem /etc/pam.d/gdm-password (grafické přihlášení). Ověřte v jiné konzoli (Ctrl+Alt+F3), dokud máte otevřené SSH nebo přihlášenou současnou konzoli.
[ -f /etc/pam.d/login.bak ] || sudo cp /etc/pam.d/login /etc/pam.d/login.bak
grep -q pam_google_authenticator /etc/pam.d/login || sudo sed -i '/^@include common-auth/a auth required pam_google_authenticator.so' /etc/pam.d/login
grep -A1 '^@include common-auth' /etc/pam.d/login@include common-auth
auth required pam_google_authenticator.so04 · Záchrana
Ztráta telefonu a návrat zpět
Ztráta telefonu
- Máte záchranný kód: zadejte ho místo kódu z aplikace (každý platí jednou). Pak spusťte znovu
google-authenticatora načtěte nový tajný klíč do nového telefonu. - Nemáte nic: přihlaste se u konzole serveru heslem a spusťte
google-authenticatorpod svým uživatelem. Funguje, pokud nemáte zaškrtnuté přihlášení u konzole; jinak chce kód i konzole.
Návrat zpět
Pro SSH
Obnoví PAM pro SSH ze zálohy a v 00-hardening.conf vrátí oba řádky. Uživatelé bez klíče se pak nepřihlásí:
sudo cp /etc/pam.d/sshd.bak /etc/pam.d/sshd
sudo sed -i -E 's/^KbdInteractiveAuthentication .*/KbdInteractiveAuthentication no/; s/^AuthenticationMethods .*/AuthenticationMethods publickey/' /etc/ssh/sshd_config.d/00-hardening.conf
sudo sshd -t && sudo systemctl restart sshPro sudo
sudo cp /etc/pam.d/sudo.bak /etc/pam.d/sudoPro přihlášení u konzole
sudo cp /etc/pam.d/login.bak /etc/pam.d/login05 · Problémy
Řešení problémů
Sledujte log SSH serveru v druhém okně a zkuste se přihlásit:
sudo journalctl -u ssh -f # on the server: watch the log while you try to log in| Hláška / stav | Příčina a řešení |
|---|---|
| Správný kód je odmítnut | čas serveru nesedí, viz krok 2 |
| Na kód se vůbec neptá | v 00-hardening.conf chybí změna z kroku 6 |
| Po klíči se ptá na heslo i na kód | uživatel je ve skupině ssh-password, nebo chybí změna z kroku 5 |
| Permission denied (keyboard-interactive) | uživatel nemá ~/.google_authenticator (krok 4) |
| Stejný kód podruhé nefunguje | záměr: každý kód platí jen jednou, počkejte na další |
Zdroje
Oficiální dokumentace a další čtení
Návod vychází z dokumentace modulu a OpenSSH (ověřeno k 29. 10. 2026):
- google-authenticator-libpamModul PAM, volby nullok, rate limiting, okno kódů.
- Ubuntu: Configure SSH to use two-factor authenticationOficiální tutoriál Ubuntu.
- sshd_config(5)AuthenticationMethods, KbdInteractiveAuthentication, Match.
Související
- SSH klíče a zabezpečení SSH serveruPředchozí krok: přihlášení jen klíčem.
- Zabezpečení přístupu krok za krokemKapitola, jejíž součástí je tento návod.
- Synchronizace časuKódy 2FA potřebují přesný čas serveru.
- Fail2BanBlokování opakovaných pokusů o přihlášení.
Jak citovat tuto publikaci (ČSN ISO 690:2022)NEPOR, Vladimír. Dvoufaktorové ověření (2FA) přes Google Authenticator na Ubuntu Serveru. Online. Vrealmatic, 2024. Aktualizováno 2. 10. 2026. Dostupné z: https://vrealmatic.com/ubuntu-navody/2fa-google-authenticator. [citováno ].
Potřebujete bezpečně nastavit server?
Navrhneme, zabezpečíme a zdokumentujeme sítě i servery.