Как обеспечить работу расширения 1С в безопасном режиме для прохождения аудита в 1С:Fresh?

← На главную

При разработке расширений для облачного сервиса 1С:Fresh программисты часто сталкиваются с тем, что расширение, идеально работающее в локальной базе, перестает функционировать при включении флажка Безопасный режим. Это связано с тем, что аудит 1С:Fresh предъявляет жесткие требования к безопасности кода, ограничивая доступ к файловой системе, COM-объектам и некоторым методам исполнения кода. Разберем подробно, почему так происходит и как адаптировать ваше расширение для успешного прохождения проверки.

Понимаем специфику безопасного режима во Fresh

Безопасный режим в облаке — это не просто формальное ограничение. На серверах 1С:Fresh он работает в тесной связке с профилями безопасности кластера серверов. Когда мы устанавливаем для расширения признак безопасного режима, система автоматически накладывает следующие ограничения:

Запрет на использование методов Выполнить() и Вычислить().
Ограничение доступа к файловой системе (разрешена работа только с временными файлами через специализированные методы).
Запрет на использование внешних компонент и COM-объектов.
Ограничение серверных вызовов: если расширение пытается вызвать метод из общего модуля, который не помечен как Вызов сервера или не входит в доверенный перечень, выполнение будет заблокировано.

Важно помнить, что в безопасном режиме расширение имеет доступ только к тем типам данных и объектам, которые разрешены в базовой конфигурации. Если ваше расширение пытается изменить данные в объектах, на которые не получено явное разрешение в профиле безопасности, код просто не сработает.

Почему расширение «не срабатывает» при установке галочки

Проанализируем ситуацию: в файловой базе при включении безопасного режима 1С начинает эмулировать серверные ограничения. Если вы используете аннотацию &Вместо для замены серверной функции в общем модуле (например, в ОбменСКонтрагентамиВнутренний), система может игнорировать этот вызов, если нарушаются условия контекста. В безопасном режиме нельзя просто так переопределять функции, которые работают с критически важными данными, без соблюдения правил расширения типов.

Настройка локальной среды для тестирования (Имитация Fresh)

Для того чтобы ваша локальная разработка была максимально приближена к условиям облака, недостаточно просто поставить галочку в свойствах расширения. Рассмотрим пошагово, как правильно имитировать среду 1С:Fresh:

Запустите конфигурацию 1С с параметром командной строки /SimulateServerSafeMode. Это заставит платформу проверять код на соответствие правилам безопасного режима сервера даже в файловом варианте.
Проверьте свойство расширения Назначение. Для Fresh обычно используется значение Адаптация.
Убедитесь, что в свойствах расширения установлен флаг Безопасный режим и выбран соответствующий профиль (если применимо).

Использование правильных аннотаций и методов

Одной из главных причин отказа в аудите является злоупотребление аннотацией &Вместо. Полная замена типового кода делает систему нестабильной при обновлениях. Рассмотрим, как правильно модифицировать логику формирования XML для ЭДО:

Вместо полной подмены функции, попробуем использовать аннотации &Перед или &После. Если же без &Вместо не обойтись, обязательно используйте метод ПродолжитьВызов(). Это гарантирует, что основной код конфигурации будет выполнен, а вы лишь добавите или скорректируете нужные данные.

Пример правильной структуры переопределения функции в общем модуле:


&Вместо("СформироватьДанныеДляУПД")
Процедура Расш1_СформироватьДанныеДляУПД(Параметры, Результат)
    // Выполняем типовую логику
    ПродолжитьВызов(Параметры, Результат);
    
    // Добавляем свои дозаполнения в структуру XML
    Если Параметры.Свойство("ДополнительныеПоля") Тогда
        Результат.Вставить("НовоеПоле", "Значение");
    КонецЕсли;
КонецПроцедуры

Особенности работы с ЭДО и Библиотекой электронных документов (БЭД)

При модификации XML-файлов (УПД, Акты) в конфигурации Бухгалтерия предприятия 3.0, мы должны учитывать архитектуру БЭД. Система часто использует так называемые «переопределяемые модули». Выясним, нет ли возможности внедрить свой код через штатные механизмы:

Проверьте наличие функций в модулях с суффиксом Переопределяемый.
Используйте механизмы подписки на события, если это предусмотрено логикой обмена.

Если вы все же меняете функции в ОбменСКонтрагентамиВнутренний, убедитесь, что ваш код не нарушает XSD-схему документа. Аудит 1С:Fresh проводит автоматизированную проверку сформированных файлов. Любое отклонение от стандарта приведет к отклонению расширения.

Что делать, если серверные функции все равно блокируются

Разберем альтернативный подход, предложенный опытными разработчиками. Если серверная функция общего модуля упорно не хочет работать в безопасном режиме, можно попробовать перенести часть логики на сторону клиента, изменив команду вызова. Рассмотрим этот вариант:

Замените клиентскую команду (например, кнопку отправки документа).
В коде команды соберите необходимые данные на клиенте.
Передайте их в свою серверную функцию расширения, которая уже будет вызывать типовые механизмы с нужными параметрами.

Этот путь более трудозатратный, но он позволяет обойти жесткие ограничения на модификацию «ядра» системы в безопасном режиме, сохраняя при этом работоспособность расширения в облаке.