Как отправить расширение на аудит в 1С:Фреш

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

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

Что такое аудит расширений и зачем он нужен

Аудит — это автоматическая проверка файла расширения (.cfe) на соответствие требованиям безопасности сервиса 1С:Фреш. Проверяется, что расширение не использует небезопасный режим, не обращается к файловой системе сервера, не выполняет внешние компоненты и не содержит код, способный повлиять на других абонентов облака.

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

Требования к расширению перед отправкой

Прежде чем отправлять файл, убедитесь, что расширение разработано в безопасном режиме. В свойствах расширения в конфигураторе параметр «Безопасный режим» должен быть установлен, а флажки «Защита от опасных действий» и запрет привилегированного режима в критичных местах — соблюдены. Расширения, требующие отключения безопасного режима, аудит не пройдут.

Ключевые ограничения: нельзя использовать COM-объекты, OLE, внешние компоненты, запуск внешних приложений, прямой доступ к файловой системе сервера и запросы к произвольным интернет-ресурсам вне разрешённых механизмов. Также расширение должно быть совместимо с версией конфигурации, которая используется в сервисе, и не должно изменять состав данных, влияющий на обмен с другими абонентами.

Проверьте корректность метаданных расширения: уникальное имя, осмысленное представление, указанная версия и поставщик. Эти данные отображаются в кабинете и при публикации, исправить их после аудита без повторной отправки нельзя.

Подготовка и локальная проверка файла

Соберите расширение в конфигураторе той версии платформы, которая соответствует версии сервиса. Выгрузите расширение в файл через меню «Конфигурация — Расширения конфигурации» с сохранением в файл .cfe. Убедитесь, что расширение без ошибок применяется к копии типовой конфигурации: все заимствованные объекты актуальны, контроль ссылочной целостности пройден.

Полезно заранее прогнать проверку конфигурации с расширением встроенными средствами конфигуратора, включив проверки на безопасность и совместимость с режимом сервиса. Это отсеет большинство причин отказа ещё до отправки.

1. 1
   Обновите расширение до актуальной версии конфигурации и исправьте ошибки применения
2. 2
   Убедитесь, что включён безопасный режим и отсутствуют запрещённые вызовы
3. 3
   Заполните имя, версию, поставщика и представление расширения
4. 4
   Выгрузите расширение в файл .cfe
5. 5
   Проверьте применение файла на чистой копии типовой конфигурации

Регистрация в кабинете разработчика

Отправка выполняется через кабинет разработчика расширений на портале сервиса 1С:Фреш. Для доступа потребуется учётная запись портала 1С и регистрация в качестве разработчика расширений: указываются данные о компании или частном лице, которые будут отображаться как сведения о поставщике.

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

Отправка расширения на аудит: пошагово

В кабинете разработчика создайте карточку нового расширения или откройте существующую, если отправляете новую версию. Укажите назначение расширения, перечень поддерживаемых прикладных решений сервиса и их версий — от этого зависит, каким абонентам расширение будет доступно.

Загрузите файл .cfe через форму отправки и подтвердите отправку на проверку. Дальше файл проходит автоматический аудит: система анализирует код на запрещённые конструкции и соответствие требованиям. Время проверки зависит от загрузки сервиса и сложности расширения; статус отображается в кабинете.

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

1. 1
   Войдите в кабинет разработчика расширений на портале 1С:Фреш
2. 2
   Создайте карточку расширения или откройте существующую для новой версии
3. 3
   Заполните назначение и список поддерживаемых конфигураций
4. 4
   Загрузите файл .cfe и подтвердите отправку
5. 5
   Дождитесь изменения статуса проверки в кабинете
6. 6
   При отказе исправьте нарушения и отправьте файл повторно

Проверка результата и публикация абонентам

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

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

Контрольные точки

Как проверить результат

Статус в кабинете разработчика

Норма

Аудит пройден, версия доступна для использования

Тревожный признак

Отказ с перечнем нарушений или статус проверки не меняется длительное время

Подключение в абонентской области

Норма

Расширение устанавливается и применяется без ошибок

Тревожный признак

Ошибка применения или недоступность расширения в списке

Работа функциональности

Норма

Доработанные формы и процедуры работают как в локальной проверке

Тревожный признак

Ошибки прав доступа, не выполняются регламентные операции

Типичные ошибки и причины отказа

Чаще всего отказ связан с нарушением ограничений безопасного режима: попытка работы с файловой системой, внешними компонентами или небезопасными вызовами. Вторая распространённая причина — несовместимость с версией прикладного решения в сервисе, когда расширение собрано под устаревшую или, наоборот, ещё не развёрнутую версию конфигурации.

Также отказывают при некорректных метаданных: дублирующееся имя расширения, пустые сведения о поставщике, несоответствие заявленного назначения фактическому содержимому. Внимательно читайте протокол отказа — в нём перечислены конкретные нарушения, и исправлять нужно именно их, а не пересобирать файл вслепую.

Если аудит не пройден: что делать

Откройте протокол проверки в кабинете и сопоставьте каждое замечание с конкретным местом в коде. Замените запрещённые вызовы на допустимые аналоги: вместо записи файлов на сервер — хранение данных в информационной базе, вместо внешних компонентов — HTTP-взаимодействие через разрешённые средства платформы.

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

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

Частые вопросы

Сколько времени занимает аудит расширения?

Точный срок не фиксируется и зависит от загрузки сервиса проверки и объёма кода. Обычно автоматическая проверка занимает от нескольких часов до нескольких рабочих дней. Актуальный статус всегда виден в кабинете разработчика.

Можно ли обойти аудит для внутреннего расширения своей компании?

Нет. Проверку проходят все расширения независимо от того, кто их разработал и для кого они предназначены. Это единое требование безопасности облачного сервиса.

Нужно ли проходить аудит заново при обновлении расширения?

Да. Любая новая версия файла .cfe отправляется на проверку повторно, даже если изменения минимальны. Подменить проверенный файл на изменённый без аудита невозможно.

Что делать, если расширению нужен обмен файлами?

Прямой доступ к файловой системе сервера запрещён. Используйте разрешённые механизмы: хранение файлов в информационной базе, HTTP-сервисы, обмен через подключённые внешние хранилища штатными средствами прикладного решения.

Подходит ли расширение, написанное для коробочной версии, для 1С:Фреш?

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

Где посмотреть причину отказа в аудите?

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