Skip to content

Экранирование вывода и переход на 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, ни тегов в надписях ни на одном из четырёх языков. Печатает значение — экранируется.

Три группы, которые надо обойти в каждом чанке:

html
<!-- набранное, вернувшееся после ошибки проверки -->
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 цепляется только к последнему операнду. Форма профиля печатает текущее значение с запасным, и записанное очевидным образом исправление не делает ничего:

html
<!-- НЕВЕРНО: экранирует запасное значение, присланное печатает сырым -->
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

Дописать ключ руками — в каждый язык, который используется на сайте:

php
// 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, в нём теперь неверны две вещи:

html
<!-- УБРАТЬ: путь в форме больше не ездит -->
<input type="hidden" name="photo" value="{$photo|escape}">

<!-- ДОБАВИТЬ: намерение -->
<input type="hidden" name="delete_photo" value="">

и кнопка удаления должна поднимать отметку, а не стирать путь:

js
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: в вашем шаблоне сайта, в письме, в окне менеджера. Поэтому и полагаться на него вместо экранирования своих чанков не стоит.

Как проверить, закрыт ли ваш сайт ​

Из корня сайта, три вопроса:

bash
# 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/

Второй и третий должны не найти ничего. Первый покажет ровно те файлы, которые надо сверить руками.

Куда идти дальше ​

Вопросы по конкретному обновлению: help@pageblocks.pro или телеграм @boshnik.

pbAuth — вход, регистрация и профиль для PageBlocks