Поиск по сайту

Найдите нужный материал

Статьи, советы, уроки и обновления Битрикса. Введите хотя бы два символа.

Ищем…

Ничего не найдено

Попробуйте другой запрос или уберите лишние слова.

Показано результатов:

Все результаты Поиск по материалам BXMax
Telegram VK YouTube
transformer 26.0.0 Безопасность

Transformer 26.0.0: безопасная загрузка результатов и фоновые callback

3 мин чтения
Узнавайте о ломающих изменениях Битрикса раньше, чем они доедут до прода: свежие разборы — в канале @bxmax_updates

Обновление безопасности

Закрыта уязвимость или ослабленная проверка прав. Ставить в первую очередь.

Transformer 26.0.0 проверяет, что загруженный результат принадлежит текущей команде и одному из запрошенных форматов. Интеграторам надо обновить вызовы FileUploader::getUploadInfo(), multipart-загрузку частей файла и обработку ответа finish=y.

Новое

Проверяйте, нужен ли порталу результат

Command::isResultExpected() возвращает true для команд в статусе CREATE или SEND с действующим deadline. Контроллер может отправить check_result_expected=y до загрузки, а портал объявляет поддержку проверки через capability resultExpectationCheck.

Для отказа появились два кода: ERROR_CONTROLLER_RESULT_NO_LONGER_EXPECTED и ERROR_CONTROLLER_RESULT_EXPECTATION_CHECK_FAILED. Оба предлагают контроллеру повторить операцию позже.

Привязывайте файл к команде

Портал принимает только формат, который запрошен командой. Локальный файл должен лежать под временным корнем и называться <GUID команды>.<формат> в каталоге transformer. Проверка нормализует путь и вызывает realpath для существующей части, поэтому .. и симлинк не выводят загрузку за пределы временного каталога.

Облачное имя тоже должно принадлежать временному хранилищу команды. Перед callback портал разрешает каждый результат заново и передаёт только подходящие локальные или облачные файлы. После обработки они удаляются.

FileUploader::getUploadInfo() возвращает отказ через Bitrix\Main\Result, если формат не запрошен или имя файла не проходит проверку.

Что сломается

FileUploader::getUploadInfo() теперь принимает Command $command, mixed $format, int $fileSize вместо $commandId, $fileKey, $fileSize. Метод возвращает Bitrix\Main\Result вместо массива. Прямые вызовы со старой сигнатурой и чтение ключей результата как массива надо переписать.

Обработчик результата читает часть файла только из multipart-upload через HttpRequest::getFile(). Fallback на строку из POST удалён. Временный файл должен пройти is_uploaded_file(), существовать и читаться. Собственный контроллер с другим протоколом загрузки получит ошибку.

Завершение и ошибка команды запускают callback фоновым заданием. При finish=y контроллер сразу получает success: OK и не узнает об ошибке callback из HTTP-ответа. Lock освобождается после callback и очистки файлов, поэтому интеграции не должны считать синхронный ответ итогом обработки.

БД

Таблица b_transformer_command, её первичный ключ и индексы перенесены из SQL-файлов MySQL и PostgreSQL в install/migrations/tables.php. InstallDB() и UnInstallDB() теперь вызывают installMigrations() и uninstallMigrations().

Регистрация CommandTable::deleteOldAgent() и ExpiredCommandAgent::run() лежит в install/migrations/agents.php. migration_config.json связывает таблицу, компоненты и tools с декларативной установкой.

Мелочи и находки

  • При ошибке команды обработчик удаляет только файлы, которые прошли проверку принадлежности. При успехе те же файлы передаются callback абсолютными путями и удаляются в finally.
  • capabilities передаётся как JSON-объект с флагом resultExpectationCheck. Перед расчётом BX_HASH PHP-массивы в $post превращаются в строку Array; значение capabilities не меняется.

Новая версия вышла — разбор уже в Telegram

В канале @bxmax_updates публикуем каждый свежий разбор: что сломается, что устарело и что появилось в API. Узнаете до того, как обновите прод.

Подписаться

Читайте дальше

ui 26.750.0 Заметное Свежее

Ui 26.750.0: добавочное выделение блоков через Cmd и Ctrl

Ui 26.750.0 расширяет групповое выделение в `ui.block-diagram`. Блоки можно добавлять в выбранную группу через `Cmd` на macOS или `Ctrl` на остальных платформах, не сбрасывая прежний выбор. Без модификатора диаграмма работает как раньше.

1 мин
tasks 26.1100.0 Ломающее Свежее

Tasks 26.950.0–26.1100.0: регулярные задачи, строгие стадии и новые контракты

Версии Tasks 26.950.0, 26.1000.0 и 26.1100.0 принесли отдельный раздел регулярных задач, новые фильтры и более строгую проверку стадий. Интеграторам придётся обновить несколько вызовов V2-контроллеров, а разработчикам бизнес-процессов — учесть новый формат результатов `TasksGetInfoActivity`.

5 мин
main 26.1100.0 Ломающее Свежее

Main 26.1100.0: кеш ответов action и два удалённых polyfill-расширения

В Main 26.1100.0 результат action можно кешировать штатным фильтром, а правила фильтрации — задавать единообразно атрибутами или через `configureActions()`. Перед обновлением проверьте наследников `FieldFileUploaderController` и прямую загрузку `main.polyfill`: сигнатура `canUpload()` изменилась, дв…

1 мин
mail 26.1400.0 Ломающее Свежее

Mail 26.1400.0: перенос новой почты и точечные Pull-обновления

Mail 26.1400.0 переводит миграцию в новую почту на подписанные согласия, обновляет форму письма и сокращает лишние Pull-события. Перед обновлением проверьте вызовы `generationScopeFilter()`, наследников сервиса счётчика ящиков и настройки, которые включали миграционные сообщения старой опцией.

4 мин
Мы используем файлы cookie для улучшения работы сайта. Продолжая использовать сайт, вы соглашаетесь с нашей политикой конфиденциальности.
AI Домовой

AI Домовой История

на связи

пишет…

Можно закрыть чат и перейти на другую страницу. Когда ответ будет готов, на кнопке Домового появится отметка.

Нет истории чатов
AI Домовой

Нужна авторизация

Войдите, чтобы задавать вопросы AI Домовому.

Войти