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.

Vladimír NeporAutorIng. Vladimír Nepor
PublikovánoAktualizováno
Přihlášení přes SSH má dva kroky: nejdřív klíč z vašeho počítače, potom jednorázový kód z aplikace v telefonu. Server přihlášení heslem dál nepřijímá.1 · klíčváš počítač2 · kód482913aplikace v telefonuserverpublickey ✓keyboard-interactive ✓heslo ✕02 · TELEFONAplikace a tajný klíčQR kód a záchranné kódykapitola →03 · NASTAVENÍZapnutí 2FASSH, sudo a konzole podle volbykapitola →03 · VOLITELNÉsudo a konzolekód i pro správcovské příkazykapitola →04 · ZÁCHRANAZtráta telefonuzáchranné kódy a návrat zpětkapitola →
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.

Předpoklady

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.

Kde chcete kód vyžadovat?

Zaškrtněte vše, co chcete chránit. Ukážou se jen potřebné kroky.

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

Terminál
sudo apt update && sudo apt install libpam-google-authenticator

Krok 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á:

Terminál
timedatectl | grep -E 'synchronized|NTP service'
Výstup
System clock synchronized: yes
              NTP service: active

Je-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).

Terminál
google-authenticator    # as your user, without sudo

Otázky programu a co odpovědět:

OtázkaOdpověď
…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:

Terminál
sudo -iu <USER> google-authenticator
Uschovejte záchranné kódy

Pod 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

Mějte otevřená dvě okna

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

Vaše údaje: příkazy v návodu se podle nich doplní. Ukládají se jen ve vašem prohlížeči a použijí je i další návody Ubuntu.

Váš správcovský účet (se sudo), zadaný při instalaci Ubuntu. Ne root a ne běžná jména jako admin, ubuntu nebo user. Ta roboti zkoušejí jako první.

Neplatná hodnota, v příkazech zůstane zástupná.

IP adresa v lokální síti (najdete ji v routeru nebo příkazem ip -4 addr na serveru), případně adresa z Tailscale nebo doménové jméno.

Neplatná hodnota, v příkazech zůstane zástupná.

Název souboru klíče ve složce ~/.ssh. Jeden klíč na server (nebo skupinu serverů). Podle názvu ho snadno najdete i zneplatníte.

Neplatná hodnota, v příkazech zůstane zástupná.

Volitelná změna výchozího portu 22. Sníží šum v logu, skutečnou ochranu dává přihlášení klíčem a firewall. Rozsah 1024 až 49151.

Neplatná hodnota, v příkazech zůstane zástupná.

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:

Terminál
[ -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/sshd
Výstup
auth [success=1 default=ignore] pam_succeed_if.so quiet user notingroup ssh-password
auth substack common-auth
auth required pam_google_authenticator.so

Krok 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).

Terminál
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
Výstup
# Port <SSH_PORT>    (volitelné: odkomentujte a zadejte vlastní port)
PubkeyAuthentication yes
PasswordAuthentication no
KbdInteractiveAuthentication yes
PermitRootLogin no
AuthenticationMethods publickey,keyboard-interactive
AllowGroups ssh-users

Krok 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.

Ubuntu 22.04, 24.04, 26.04
sudo sshd -t && sudo systemctl restart ssh
Terminál
sudo sshd -T | grep -E '^(usepam|passwordauthentication|kbdinteractiveauthentication|authenticationmethods) '
Výstup
usepam yes
passwordauthentication no
kbdinteractiveauthentication yes
authenticationmethods publickey,keyboard-interactive
Terminál
ssh -i ~/.ssh/<KEY_NAME> -o IdentitiesOnly=yes -p 22 <ADMIN_USER>@<SERVER_IP>
Výstup
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:

Terminál
ssh -p 22 <USER>@<SERVER_IP>
Výstup
(<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.

Terminál
[ -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
Výstup
@include common-auth
auth required pam_google_authenticator.so
Terminál
sudo -k && sudo true    # in a second window: password, then Verification code

Pro 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.

Terminál
[ -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
Výstup
@include common-auth
auth required pam_google_authenticator.so

04 · 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-authenticator a načtěte nový tajný klíč do nového telefonu.
  • Nemáte nic: přihlaste se u konzole serveru heslem a spusťte google-authenticator pod 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í:

Terminál
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 ssh

Pro sudo

Terminál
sudo cp /etc/pam.d/sudo.bak /etc/pam.d/sudo

Pro přihlášení u konzole

Terminál
sudo cp /etc/pam.d/login.bak /etc/pam.d/login

05 · Problémy

Řešení problémů

Sledujte log SSH serveru v druhém okně a zkuste se přihlásit:

Terminál
sudo journalctl -u ssh -f    # on the server: watch the log while you try to log in
Hláška / stavPříč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óduž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é nefungujezá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):

Související

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 ].

SdíletXLinkedInFacebookGmail

Potřebujete bezpečně nastavit server?

Navrhneme, zabezpečíme a zdokumentujeme sítě i servery.

Servery a sítě