Экранирование вывода и переход на 1.1.1
Версия 1.1.1 — выпуск про безопасность. Три изменения в нём закрывают дыры в поставочной вёрстке и в правилах профиля, и одно из них на работающем сайте требует ваших рук — не потому, что исправление неполное, а потому, что исправленные файлы принадлежат вам.
1.1.1 ещё не опубликована
Всё, что на этой странице, уже лежит в исходниках компонента и в core/components/pbauth/docs/changelog.txt, но пакет ещё не собран. В Установщике последняя версия по-прежнему 1.1.0. Читайте эту страницу, если планируете обновление; скачивать пока нечего.
Что изменилось
| Что | Где |
|---|---|
| Всё, что набрал посетитель, печатается экранированным | 21 из 22 поставочных шаблонов — все чанки форм, их модальные копии, кнопки соцсетей, оба письма учётной записи и обёртка auth |
| Адрес аватара ставит сервер, а не запрос | rules.profile, form.profile.tpl, ProfileController |
Правило username в профиле не принимает знаки разметки | rules.profile |
Главное здесь — первое. До 1.1.1 |escape не стоял ни в одном поставочном шаблоне, а сам Fenom не экранирует: PageBlocks поднимает движок без auto_escape. Значит имя, полное имя, почта или телефон со знаками разметки уезжали в страницу как разметка.
Почему это не просто self-XSS
Один профиль был бы делом самого посетителя. Делает это общим делом /impersonate/{id}: менеджер с флагом sudo входит под любым пользователем, и менеджер с фронтом делят одну PHP-сессию. То есть имя, набранное обычным посетителем, печатается в браузере администратора, на том же origin, в сессии, в которой лежит токен mgr-контекста. Это повышение прав, а не вред себе.
Почему исправление экранирования само не доезжает до работающего сайта
Страница рисуется из копии в core/App/elements/auth/, а не из той, что внутри компонента. Шаблоны зовутся через провайдер file:, заведённый на pageblocks_elements_path — по умолчанию {core_path}App/elements/. Каталог elements/ внутри компонента при рендере не читается никогда. Он источник для установщика и больше ничего.
А до 1.1.1 установщик не перезаписывал существующий файл в core/App/ вовсе: попав туда, файл принадлежал сайту. Обе половины по отдельности разумны, а вместе означали, что правки экранирования дойдут только до чистой установки — и ни до одного обновляемого сайта, то есть ровно до тех, ради которых затевались.
Что делает обновление теперь
Резолвер отличает свою нетронутую копию от правленого вами файла по хешам в core/App/.pbauth-installed.json. На каждый файл четыре исхода:
Состояние файла в core/App/ | Что делает обновление | Лог |
|---|---|---|
| файла нет | кладёт поставочный | в сводной строке INFO |
| есть и байт в байт совпадает с поставочным либо числится в манифесте с прежним хешем | заменяет поставочным | в сводной строке INFO |
| есть и правлен сайтом | оставляет точно как есть | строка WARN с именем файла |
| свой, но перезаписать не удалось | оставляет как есть | строка ERROR с именем файла |
Установка по-прежнему не перезаписывает ничего: там либо файла нет, либо он сайта.
Значит правки версии доезжают сами до всех файлов, которых вы не касались. А файлы, которые вы правили, остаются вашими — с прежней разметкой и прежней печатью имён сырыми.
Читайте лог обновления: строки WARN — это ваши файлы
Этот шаг — единственный обязательный. После обновления откройте в менеджере Система → Журнал ошибок или прочитайте core/cache/logs/error.log и найдите строки, начинающиеся с [pbAuth] App/:
[pbAuth] App/elements/auth/chunks/form.login.tpl правлен сайтом и оставлен
как есть — правки этой версии в него не попали. Сверьте его с
core/components/pbauth/elements/auth/chunks/form.login.tpl вручную.По строке на файл.
Зелёная консоль установщика не значит, что вы закончили
Консоль говорит, что пакет установился. О том, какие из ваших файлов были пропущены, она не говорит ничего. Если в лог не посмотреть, правленый form.login.tpl останется с дырой, и об этом никто не узнает.
Каждый файл, названный строкой WARN, надо сверить руками с поставочным по тому же пути внутри core/components/pbauth/. Строка ERROR означает то же самое по другой причине — файл компонента, но записать его не удалось. Проверьте права на файл и повторите обновление.
Что дописать в чанк, который вы правили
Поставьте |escape на каждую печать значения. Списка исключений нет: намеренной разметки в pbAuth нет нигде — ни готового HTML из PHP, ни тегов в надписях ни на одном из четырёх языков. Печатает значение — экранируется.
Три группы, которые надо обойти в каждом чанке:
<!-- набранное, вернувшееся после ошибки проверки -->
value="{$old_input.email|escape}"
<!-- тексты ошибок и сообщений -->
<span class="invalid-feedback" data-error="email">{$errors.email|escape}</span>
<p class="form-message" pb-message>{$success_message|escape}</p>
<!-- текущие значения, аватар, имя в окне менеджера -->
<img src="{$avatar|escape}" alt="{$modx->user->username|escape}">Скобки у ?: — не вопрос стиля
Модификатор Fenom цепляется только к последнему операнду. Форма профиля печатает текущее значение с запасным, и записанное очевидным образом исправление не делает ничего:
<!-- НЕВЕРНО: экранирует запасное значение, присланное печатает сырым -->
value="{$old_input.fullname ?: $up->fullname|escape}"
<!-- ВЕРНО: завёрнуто всё выражение -->
value="{($old_input.fullname ?: $up->fullname)|escape}"Неверный вариант при этом выглядит исправленным. Все четыре таких печати в поставочном form.profile.tpl завёрнуты целиком, и это замерено на движке, а не выведено рассуждением.
Надписи в том же положении
core/App/lang/{ru,en,uk,de}/auth.php раскладывает тот же резолвер, поэтому правленый файл надписей пропускается так же и получает свою строку WARN. У этой версии отсюда есть видимое следствие: 1.1.1 добавляет один новый ключ — сообщение для правила username.
lang() читает core/App/lang/<локаль>/auth.php и больше ничего: отката к копии компонента нет, а ненайденный ключ печатается сам собой. То есть на сайте с правленым файлом надписей посетителю, набравшему < в имени, ответят так:
auth.username_forbidden_charsДописать ключ руками — в каждый язык, который используется на сайте:
// ru
'username_forbidden_chars' => 'Имя не может содержать знаки < > " \' &',
// en
'username_forbidden_chars' => 'The name cannot contain the characters < > " \' &',Поставочные формулировки для всех четырёх языков — в core/components/pbauth/lang/{ru,en,uk,de}/auth.php.
Аватар: форма присылает намерение, а не путь
До 1.1.1 в rules.profile стояло 'photo' => 'nullable|string', а форма возвращала текущий путь скрытым полем — иначе «Удалить фото» нечем было бы его обнулить. Из этой пары и складывалась дыра: путь к аватару можно было просто прислать, и fromArray() писал в профиль любую присланную строку. Загрузка перезаписывала значение только когда файл действительно пришёл, то есть запрос без файла проходил насквозь.
Экранирование это не закрывало и не могло: из атрибута такое значение не выходит, но сама картинка остаётся выбранной тем, кто отправил запрос. На сайте с форумом она при этом печатается рядом с чужими сообщениями и уезжает в обработчик превью.
Теперь путь ставит исключительно сервер — из store() при загрузке или пустым при удалении, — а форма отвечает на один вопрос: удалять картинку или нет.
Если вы правили form.profile.tpl, в нём теперь неверны две вещи:
<!-- УБРАТЬ: путь в форме больше не ездит -->
<input type="hidden" name="photo" value="{$photo|escape}">
<!-- ДОБАВИТЬ: намерение -->
<input type="hidden" name="delete_photo" value="">и кнопка удаления должна поднимать отметку, а не стирать путь:
document.querySelector('#auth-profile [name=delete_photo]').value = '1'Интеграции: photo теперь лежит в $validated только при изменении
Правила у photo больше нет вовсе, а Validator::validated() собирает результат обходом правил, а не присланного. Поэтому «не трогать аватар» выражается простым отсутствием ключа — это и есть нужное поведение, и это изменение для любого слушателя USER_SAVING или AFTER_PROFILE_UPDATE, читавшего $validated['photo'] безусловно. Текущее значение по-прежнему доступно: в те же события передаётся сам объект $profile.
Правило username в профиле
Регистрация была строгой и раньше (alpha_dash:ascii), а профиль — нет, там стояло required|unique. Эта асимметрия и была дырой: зарегистрироваться как <img src=x onerror=…> нельзя, а переименоваться — можно. Теперь запрет стоит и на правиле профиля, и это намеренно запрет на пять знаков, а не белый список.
Само правило и соображения за ним — в справочнике правил: «Правило username в профиле».
Правило — второй рубеж, а не защита
XSS закрыт экранированием в шаблонах, его сторожит tests/templates-escaping.php в исходниках компонента. Правило стоит, чтобы имя не ломало разметку там, где его напечатают без |escape: в вашем шаблоне сайта, в письме, в окне менеджера. Поэтому и полагаться на него вместо экранирования своих чанков не стоит.
Как проверить, закрыт ли ваш сайт
Из корня сайта, три вопроса:
# 1. Какие из ваших файлов обновление пропустило? (или прочитайте лог)
grep -r '\[pbAuth\] App/' core/cache/logs/error.log
# 2. Остался ли в чанках хоть один неэкранированный вывод?
grep -rn '{\$old_input\|{\$errors\.' core/App/elements/auth/ | grep -v escape
# 3. Присылает ли форма профиля путь к аватару?
grep -rn 'name="photo"' core/App/elements/auth/Второй и третий должны не найти ничего. Первый покажет ровно те файлы, которые надо сверить руками.
Куда идти дальше
- Справочник → Обновление и удаление — манифест, что стирается при удалении, переход с версий до 1.1.0.
- Свои поля в формах — правила проверки, включая правило
usernameи поля аватара. - События и свой код — что приходит слушателю в
$validated.
Вопросы по конкретному обновлению: help@pageblocks.pro или телеграм @boshnik.