Двухфакторная аутентификация SSH: настройка 2FA на сервере

Двухфакторная аутентификация добавляет к входу по SSH одноразовый код из приложения на телефоне. Даже если пароль или приватный ключ попадут в чужие руки, без второго фактора войти на сервер не получится. Настройка занимает около десяти минут.
Как это работает
Сервер и приложение-аутентификатор хранят общий секрет и по нему вычисляют шестизначный код, который меняется каждые 30 секунд (стандарт TOTP). Подойдёт любое совместимое приложение: Google Authenticator, Aegis, 2FAS, Bitwarden. Интернет для генерации кода не нужен, но часы на сервере и телефоне должны идти точно.
Шаг 1. Установка модуля
Ubuntu и Debian:
sudo apt update
sudo apt install libpam-google-authenticator
AlmaLinux, Rocky Linux:
sudo dnf install epel-release
sudo dnf install google-authenticator qrencode
Шаг 2. Создание секрета
Выполните команду от имени пользователя, под которым входите на сервер. Секрет создаётся для каждого пользователя отдельно:
google-authenticator
Ответьте на вопросы:
- Do you want authentication tokens to be time-based? —
y. - На экране появится QR-код. Отсканируйте его приложением-аутентификатором и введите код из приложения для проверки.
- Сохраните резервные коды в надёжном месте. Каждый из них действует один раз и позволит войти, если телефон потерян.
- Update your .google_authenticator file? —
y. - Disallow multiple uses of the same token? —
y: защита от повторного использования перехваченного кода. - Increase the window? —
n, если часы на сервере и телефоне синхронизированы. - Enable rate-limiting? —
y: не более трёх попыток входа за 30 секунд.
Шаг 3. Настройка PAM
Откройте файл:
sudo nano /etc/pam.d/sshd
Добавьте в конец строку:
auth required pam_google_authenticator.so
Если на сервере несколько пользователей и не все ещё настроили приложение, временно используйте вариант с nullok — пользователи без секрета смогут входить по-прежнему:
auth required pam_google_authenticator.so nullok
Шаг 4. Настройка SSH
Дальнейшие шаги зависят от того, как вы входите на сервер.
Вариант А: SSH-ключ и код (рекомендуется)
Откройте /etc/ssh/sshd_config и задайте параметры:
KbdInteractiveAuthentication yes
UsePAM yes
PasswordAuthentication no
AuthenticationMethods publickey,keyboard-interactive
Чтобы после ключа сервер запрашивал только код, а не пароль, в файле /etc/pam.d/sshd закомментируйте строку подключения стандартной проверки пароля:
#@include common-auth
В AlmaLinux и Rocky Linux вместо неё закомментируйте строку auth substack password-auth.
Вариант Б: пароль и код
KbdInteractiveAuthentication yes
UsePAM yes
Файл /etc/pam.d/sshd оставьте без изменений, кроме строки из шага 3. При входе сервер запросит пароль, затем код.
Проверьте файлы в sshd_config.d
В Ubuntu и Debian настройки из каталога /etc/ssh/sshd_config.d/ имеют приоритет над основным файлом. Убедитесь, что они не переопределяют ваши параметры:
grep -rE "KbdInteractive|ChallengeResponse|PasswordAuthentication|AuthenticationMethods" /etc/ssh/sshd_config.d/
Если нашлись противоречащие строки, исправьте их или закомментируйте.
Шаг 5. Применение настроек
Проверьте конфигурацию и перезапустите службу:
sudo sshd -t
sudo systemctl restart ssh # Ubuntu, Debian
sudo systemctl restart sshd # AlmaLinux, Rocky Linux
Шаг 6. Проверка
Не закрывая текущую сессию, откройте новое окно терминала и подключитесь:
ssh user@203.0.113.10
Сервер запросит Verification code: — введите код из приложения. Если вход прошёл, настройка завершена.
Если что-то пошло не так
- Код не принимается. Чаще всего расходятся часы. Проверьте время на сервере командой
timedatectlи включите синхронизацию:sudo timedatectl set-ntp true. - Сервер не спрашивает код. Проверьте, что
KbdInteractiveAuthentication yesне переопределён вsshd_config.dи служба перезапущена. - Потерян телефон. Используйте один из резервных кодов вместо одноразового.
- Вход невозможен совсем. Зайдите через консоль в панели управления, удалите строку
pam_google_authenticator.soиз/etc/pam.d/sshdи перезапустите SSH. Подробности — в журнале:journalctl -u ssh -n 50.
Исключения для автоматизации
Скрипты резервного копирования и системы развёртывания не умеют вводить коды. Для них можно разрешить вход по ключу без второго фактора с определённого адреса. Добавьте в конец sshd_config:
Match User backup Address 198.51.100.7
AuthenticationMethods publickey
Перенос на новый телефон
Секрет хранится в файле ~/.google_authenticator на сервере. Чтобы подключить новое устройство, запустите google-authenticator заново и отсканируйте новый QR-код — старый секрет перестанет действовать.
Дополнительные меры
Двухфакторная аутентификация — последний рубеж, а не единственный. На сервере её стоит сочетать со сменой порта SSH, Fail2Ban и уведомлениями о входе в Telegram.


