Как это работает
Передача файлов и резервные копии
Как входы SFTP запираются в jail, чтобы ни один аккаунт не видел другого, почему FTPS поставляется выключенным, что забирают копии и что не перепроверяется.
Передачу файлов обслуживает штатный OpenSSH хоста, а не написанный в этом проекте демон.
Каждый вход заперт, и jail настоящий
Вход помещается в chroot, принадлежащий root jail, внутрь которого примонтирован настоящий домашний каталог аккаунта. Отсюда два следствия, и оба задуманы намеренно:
- Чтобы jail заработал, не пришлось менять владельца домашнего каталога, поэтому аккаунт по-прежнему владеет своими файлами ровно так же, как раньше.
- Изнутри не становится виден ни один другой аккаунт. Jail не просто каталог, в котором клиента просят оставаться: другого каталога там просто нет.
Вход несёт собственный uid аккаунта, поэтому загруженный файл принадлежит аккаунту ровно так же, как
созданный им самим. Ему выдаётся internal-sftp и никакого шелла. Проверяется это тем,
что настоящей сессии отказывают в команде, а не наличием директивы в файле.
Проброс портов выключен. Учётные данные для передачи файлов, умеющие пробрасывать порты, превращаются в туннель в приватную сеть сервера.
Сброс или удаление входа завершает его открытые сеансы
Пароль и открытые ключи входа проверяются при установке соединения и больше не проверяются для сеанса, который сервер уже принял. Поэтому смена учётных данных сама по себе не отключила бы того, кто уже подключён по старым. Когда вы сбрасываете пароль входа, панель завершает все открытые сеансы этого входа, а при удалении входа делает это до его удаления. Загрузка, которая идёт в этот момент, обрывается на том байте, до которого дошла, и неполный файл остаётся. Завершаются только сеансы этого входа; другие входы аккаунта не затрагиваются. Если сервер не смог подтвердить завершение сеансов, удаление отклоняется и его можно повторить, а сброс всё равно возвращает новый пароль, но записывает сбой в журнал аудита как Завершены сеансы SFTP, чтобы вы знали: старые сеансы могут быть ещё открыты.
Открытые ключи лежат вне jail
Тот же блок указывает, откуда читаются открытые ключи входа SFTP:
/etc/ssh/maran-sftp-keys/<вход>, по одному принадлежащему root файлу на вход. Ключ, который клиент
положит в свой домашний каталог, никогда не читается: файл, который решает, кто может войти, клиент
записать не может.
Агент сервера пишет этот файл из проверенного списка и ни из чего больше. Принимаются только
Ed25519, ECDSA и RSA от 2048 бит (и две формы аппаратных ключей); ключ с опцией вроде command="…"
отклоняется, а не чистится, и каждая строка пишется с restrict, так что ключ умеет передавать
файлы и ничего больше. Ключи приостановленного аккаунта убираются в сторону и возвращаются при
возобновлении: одного заблокированного пароля недостаточно, чтобы остановить вход по ключу.
На хостах, установленных до этого изменения, установщик нужно запустить ещё раз, чтобы появились строка и каталог. Добавление ключей с экрана SFTP в панели в этот выпуск ещё не входит.
FTPS поставляется установленным и выключенным
Установщик ставит vsftpd, и FTPS работает целиком. Поставляется он выключенным: ничего не слушает, конфигурация не рендерится, а штатная служба дистрибутива замаскирована, пока администратор не включит FTPS из панели.
Включение FTPS ждёт ответа vsftpd до 10 секунд, прежде чем оценивать результат. Если демон так и не ответил, изменение откатывается: после неудачного первого включения конфигурации не остаётся, поэтому повторная попытка начинается с чистого листа, а не сообщает об успехе при остановленном демоне.
Строка шифрования говорит о том, что измерено
В состоянии FTPS-сервера есть строка Шифрование, прочитанная из конфигурации демона на хосте, а не из собственной настройки панели. У неё три состояния:
- TLS обязателен для входа и передачи: демон отклоняет вход или передачу, которые не зашифрованы.
- TLS необязателен: вход и передача могут идти без шифрования: демон принимает и то и другое, поэтому клиент, не запрашивающий TLS, отправляет пароль открытым текстом. Исправьте это, прежде чем открывать сервер для пользователей.
- Не проверено: настройки не удалось прочитать: агент не смог прочитать конфигурацию демона, поэтому панель не утверждает ни того, ни другого. Это не предупреждение о том, что TLS выключен; проверьте, что агент запущен, и обновите страницу.
Для интеграций GET /api/v1/ftps-server передаёт это как tlsEnforcement: enforced, notEnforced или
notObserved. Оно заменяет forcedTls, которое умело говорить только «да» или «нет», поэтому нечитаемую
конфигурацию показывало как «нет».
Сказано прямо, потому что прежняя заметка о выпуске утверждала обратное (будто FTP-демон вообще не устанавливается), а оператор, который в это верит, не пойдёт искать его на своём хосте.
Резервные копии
Плановые копии аккаунтов с политиками хранения запускаются из панели. Одного они не делают: не покрывают удаление базы. См. базы данных, где удаление окончательно, а путь удаления ни к чему не обращается.
Когда плановая копия не удалась, администратор получает письмо
Раньше каждый из этих случаев проходил молча, теперь каждый отправляет одно оповещение на адрес из Исходящая почта → Отправлять оповещения на, на английском, русском или армянском:
- Плановый запуск не удался: он закончился без архива. Прежние копии аккаунта сохраняются.
- Место хранения отказало: место хранения расписания нельзя было использовать, поэтому запуск не начинался.
- Запуск пропущен: расписание стартовало больше чем через 30 минут после назначенного часа, обычно потому, что панель в тот час не работала. Панель, выключенная несколько ночей, догоняет одним запуском и отправляет одно оповещение с первым пропущенным часом.
Каждое оповещение записывается в журнал аудита как «Сработало оповещение», а если адрес для оповещений не задан, рядом записывается «Письмо не отправлено: нет настроек SMTP». Ручные копии писем не отправляют: тот, кто запустил копию, следит за её задачей. Пока не покрыто: проверка каждого архива после записи. До тех пор повреждённый архив обнаруживается при восстановлении, которое проверяет каждый дамп базы перед загрузкой.
Что ничто не перепроверяет
Установщик пишет тот единственный блок Match Group, который превращает SFTP-аккаунт в запертый
вход, и делает это идемпотентно. Потом туда никто не смотрит. Правленный руками sshd_config
или сброшенный обновлением дистрибутива, потерявший этот блок, дал бы каждому клиенту передачи
файлов полноценную сессию с шеллом, а панель продолжала бы показывать все входы здоровыми.
Если вы правите sshd_config на хосте с Maran, проверьте, что блок на месте.