AllowGroups
AllowGroups это директива сервера OpenSSH (sshd_config), которая разрешает вход по SSH только пользователям, чья основная или дополнительная группа совпадает с перечисленным именем группы. Если она задана, остальным отказывают, а в логе появляется строка «none of user's groups are listed in AllowGroups». Доступом тогда управляют через членство в группе, а не правкой конфига.
Что делает AllowGroups и как сопоставляются группы
В руководстве sshd_config сказано: если задан AllowGroups, вход разрешён только пользователям, чья основная группа или список дополнительных групп совпадает с одним из шаблонов, а по умолчанию вход разрешён для всех групп. Элементы разделяются пробелами и подчиняются правилам шаблонов из ssh_config(5), поэтому * и ? работают. Допустимы только имена групп: числовой идентификатор группы не распознаётся.
Ключевое слово можно указывать несколько раз, и каждое вхождение дополняет список. Руководство также уточняет, что AllowGroups не учитывается для групп, совпавших с DenyGroups. Типичная настройка создаёт одну группу и перечисляет её:
sudo groupadd sshusers
sudo usermod -aG sshusers deploy
echo 'AllowGroups sshusers' | sudo tee /etc/ssh/sshd_config.d/20-allowgroups.conf
Это групповой аналог AllowUsers. Командам он обычно удобнее: доступ выдаётся командой usermod, а не правкой конфига. Добавьте в группу свою учётную запись до перезагрузки sshd.
Ошибка «none of user's groups are listed in AllowGroups»
Когда AllowGroups задан, а учётная запись не состоит ни в одной из перечисленных групп, sshd отказывает во входе ещё до проверки ключа или пароля. Клиент видит только общее Permission denied (publickey,password), поэтому причину нужно искать в логе сервера. Мы запустили OpenSSH 9.6p1 на Ubuntu 24.04.5 с AllowGroups sshusers, и пользователь вне группы дал такую строку:
User bob from 127.0.0.1 not allowed because none of user's groups are listed in AllowGroups
Найти её можно командой sudo journalctl -u ssh --since "10 min ago" | grep "not allowed" в Debian и Ubuntu (в семействе Fedora юнит называется sshd) либо в /var/log/auth.log, если его пишет rsyslog. Обычные причины:
- пользователя не добавили в группу или добавили в группу с похожим именем;
- в файле опечатка в имени группы, либо такой группы нет;
- группы приходят из службы каталогов, например LDAP или SSSD, и запрос не проходит; это покажет команда
id.
Как исправить и не потерять доступ
Проверяйте то, что говорит система, а не то, что, как вам кажется, вы задали:
getent group sshusers
id bob
sudo sshd -T | grep -i '^allowgroups '
Первая команда показывает группу и её участников, вторая группы, которые на самом деле есть у учётной записи, третья действующий список. Если группы у пользователя нет, добавьте её:
sudo usermod -aG sshusers bob
Не опускайте -a: без него usermod заменяет дополнительные группы пользователя. В нашем тесте пользователь вошёл при следующей попытке без перезагрузки, потому что sshd читает список групп при каждом входе. Уже открытые сеансы сохраняют те группы, с которыми начались. Когда вы меняете саму директиву:
- Держите открытым один сеанс и подготовьте консоль провайдера.
- Сначала добавьте в группу свою учётную запись.
- Выполните
sudo sshd -t, затем перезагрузите sshd. - Войдите из нового терминала, прежде чем закрывать старый.
Если вы уже заблокированы, воспользуйтесь консолью и руководством по восстановлению доступа по SSH.
Взаимодействие с AllowUsers, DenyGroups и drop-in файлами
Вход должен пройти каждый настроенный список. В нашем тесте при AllowGroups sshusers вместе с AllowUsers alice участник sshusers, не являвшийся alice, получил отказ «not allowed because not listed in AllowUsers». Исходный код OpenSSH проверяет DenyUsers, затем AllowUsers, затем DenyGroups, затем AllowGroups. Пользователь из группы, названной в DenyGroups, получает отказ «not allowed because a group is listed in DenyGroups», даже если эта же группа есть в AllowGroups.
На практике важны две ловушки. Во-первых, каждая строка AllowGroups дополняет список, в том числе из разных файлов: при sshusers в drop-in и wheel в основном файле sshd -T вывел обе группы, поэтому забытая строка может пустить группу, которую вы не планировали. Во-вторых, sshd -t принимает несуществующую группу, так что опечатка проходит проверку и потом не совпадает ни с кем.
Списки действуют на все учётные записи, включая root и служебных пользователей, поэтому заранее решите, кто входит в группу. Остальной базовый набор описан в статьях PermitRootLogin, MaxAuthTries и в руководстве по защите SSH.
Связанные термины: sshd_config, AllowUsers, PermitRootLogin, Принцип минимальных привилегий, MaxAuthTries.
Часто задаваемые вопросы
Что делает AllowGroups в sshd_config?
Разрешает вход по SSH только пользователям, чья основная или дополнительная группа совпадает с одним из перечисленных имён. Если директива не задана, вход по группам не ограничивается.
Что значит «not allowed because none of user's groups are listed in AllowGroups»?
AllowGroups задан, а учётная запись не состоит ни в одной из перечисленных групп, поэтому sshd отказал во входе. Проверьте учётную запись командой id, список командой sshd -T и добавьте пользователя в группу.
Нужно ли перезапускать sshd после добавления пользователя в разрешённую группу?
Нет. В нашем тесте пользователь вошёл при следующей попытке после usermod -aG, без перезагрузки. Перезагрузка нужна только после изменения конфигурации sshd.
AllowGroups сопоставляет основную группу или только дополнительные?
Обе. Руководство говорит об основной группе и списке дополнительных, а пользователь, у которого разрешённая группа была основной, в нашем тесте вошёл успешно.
Ловит ли sshd -t опечатку в имени группы в AllowGroups?
Нет. sshd -t проверяет только синтаксис, поэтому имя несуществующей группы проходит и просто не совпадает ни с кем. Проверьте настоящие группы командой getent group и прочитайте результат через sshd -T.
Хотите увидеть, в каком состоянии ваш сервер?
Запустите бесплатную read-only проверку сервера или откройте Security Lab и посмотрите цикл обнаружение, сдерживание, восстановление, проверка в действии.
Получить бесплатную проверку сервераОткрыть Security Lab