1. Блог
  2. Мануалы

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

Двухфакторная аутентификация 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

Ответьте на вопросы:

  1. Do you want authentication tokens to be time-based? — y.
  2. На экране появится QR-код. Отсканируйте его приложением-аутентификатором и введите код из приложения для проверки.
  3. Сохраните резервные коды в надёжном месте. Каждый из них действует один раз и позволит войти, если телефон потерян.
  4. Update your .google_authenticator file? — y.
  5. Disallow multiple uses of the same token? — y: защита от повторного использования перехваченного кода.
  6. Increase the window? — n, если часы на сервере и телефоне синхронизированы.
  7. 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.