Как исправить ошибку установки внешней компоненты Директ-Банк (VPN-key-TLS) для Сбербанка в 1С?

Программист 1С v8.3 (Управляемые формы) 1C:Бухгалтерия Бухгалтерский учет Финансы и профессиональные услуги
← На главную

При настройке прямого обмена с банками по технологии 1С:ДиректБанк (поможет обработка автоматического разнесения данных банковской выписки) пользователи Сбербанка часто сталкиваются с необходимостью использования внешней компоненты криптографии VPN-key-TLS. На современных версиях платформы 1С:Предприятие 8.3 при попытке загрузить или обновить эту компоненту может возникнуть критическая ошибка: «Требуется файл MANIFEST.XML при загрузке компоненты». Попытки создать этот файл вручную «на коленке» по стандартным шаблонам часто приводят к другой ошибке: «Метод НачатьПодключениеВнешнейКомпоненты вернул Ложь».

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

---

Анализ проблемы: почему возникает ошибка MANIFEST.XML?

Начиная с версии платформы 1С:Предприятие 8.3.10, механизмы безопасности и работы с внешним программным кодом были существенно ужесточены. Теперь платформа требует, чтобы любая внешняя компонента поставлялась в виде единого ZIP-архива, внутри которого обязательно должен находиться декларативный файл-описание — MANIFEST.XML.

Этот файл сообщает платформе, какие именно библиотеки (для Windows, Linux, macOS, 32-разрядных или 64-разрядных систем) находятся внутри архива, под какими именами они зарегистрированы и к какому программному объекту (ProgID) должна обращаться конфигурация.

Проанализируем типичную ошибку из практики (описанную в Сообщении 5 темы): пользователь взял шаблон манифеста из стандартной документации 1С и упаковал его вместе с оригинальными библиотеками Сбербанка. В результате 1С успешно импортировала архив в справочник ВнешниеКомпоненты, но при попытке получить выписку (удобно через автоматическая загрузка выписок без Директ-Банка) выдала системную ошибку:

«Установка внешней компоненты не выполнена. Возможно, отсутствует компонента для используемого клиентского приложения» и далее по стеку: «Метод НачатьПодключениеВнешнейКомпоненты вернул Ложь».

Выясним причину этой ошибки. Платформа 1С строго сопоставляет содержимое архива с тем, что написано в MANIFEST.XML. Если в манифесте задекларированы абстрактные имена файлов, такие как AddInNative.dll, а внутри архива фактически лежат файлы Сбербанка (например, 1CSBRFServiceProxyWin32_12.dll и 1CSBRFServiceProxyWin64_12.dll), то платформа просто не может найти нужную библиотеку под целевую разрядность операционной системы и возвращает отказ подключения.

---

Как правильно составить MANIFEST.XML для компоненты Сбербанка

Для того чтобы компонента криптографии Сбербанка корректно инициализировалась на стороне клиента, файл манифеста должен строго отражать реальную структуру архива и использовать корректные программные идентификаторы. Разберем по шагам правильную структуру MANIFEST.XML для компоненты Сбербанка (SBRFServiceProxy):


<?xml version="1.0" encoding="UTF-8" ?>
<bundle xmlns="http://v8.1c.ru/8.2/addin/bundle" name="1CSBRFServiceProxy">
  <component os="Windows" path="1CSBRFServiceProxyWin32_12.dll" type="native" arch="i386" />
  <component os="Windows" path="1CSBRFServiceProxyWin64_12.dll" type="native" arch="x86_64" />
</bundle>

Рассмотрим подробнее ключевые атрибуты этого XML-файла:

Что касается файла extcomp.key: В старых версиях платформы данный файл использовался в папке ExtCompT как вспомогательный ключ авторизации/регистрации компоненты. В современной архитектуре манифеста описывать этот файл внутри MANIFEST.XML не требуется. Платформа 1С самостоятельно разархивирует его из общего ZIP-пакета вместе с исполняемыми библиотеками.

---

Инструкция по ручной сборке рабочего архива

Если у вас на руках имеются оригинальные DLL-библиотеки Сбербанка, но отсутствует корректный архив с манифестом, выполним процедуру сборки самостоятельно:

  1. Создайте на компьютере новую временную папку.
  2. Поместите в эту папку библиотеки компоненты Сбербанка. Обычно это файлы 1CSBRFServiceProxyWin32_12.dll и 1CSBRFServiceProxyWin64_12.dll. Также положите туда файл лицензии/подписи extcomp.key (при его наличии).
  3. Создайте в этой же папке обычный текстовый файл, переименуйте его в MANIFEST.XML и откройте в текстовом редакторе (например, Notepad++).
  4. Вставьте в созданный файл XML-код манифеста, приведенный в предыдущем разделе, и сохраните изменения в кодировке UTF-8 (это критично для корректного чтения платформой).
  5. Выделите все файлы внутри папки (но не саму папку!) и добавьте их в ZIP-архив. Назовите архив, например, extcomp.zip.
  6. Перейдите в 1С:Предприятие. Откройте справочник «Внешние компоненты» (через «Все функции» / «Функции для технического специалиста» -> «Справочники»).
  7. Загрузите созданный архив extcomp.zip в справочник. Теперь платформа распознает компоненту, и ошибка с отсутствием манифеста пропадет.

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

---

Глобальное решение проблемы: Переход на современный Sber API

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

Сбербанк официально объявил о выводе из эксплуатации устаревшего шлюза интеграции — Универсального платежного шлюза (УПШ), который как раз и требовал использования внешних компонент шифрования, токенов и библиотек VPN-key-TLS. Поэтапное отключение шлюза УПШ стартовало 15 мая 2026 года, а в третьем квартале 2026 года поддержка старого протокола обмена будет полностью прекращена на стороне банка.

На смену устаревшей технологии пришел современный стандарт прямого обмена — Sber API (SberAPI) — для этого подойдёт автоматическая загрузка выписок через Sber API.

Главное преимущество Sber API: При переходе на эту технологию внешняя компонента VPN-key-TLS больше вообще не требуется! Взаимодействие и шифрование трафика происходят по новым безопасным веб-протоколам напрямую из платформы 1С без использования сторонних нестабильных библиотек.

Посмотрим на алгоритм перехода на технологию Sber API:

  1. Обновите конфигурацию 1С: Поддержка нового формата обмена Sber API добавлена в актуальные релизы программных продуктов (например, для конфигурации «1С:Бухгалтерия предприятия» начиная с версий 3.0.189.xx и выше). Убедитесь, что ваша база обновлена.
  2. Получите настройки в банке: Авторизуйтесь в личном кабинете «СберБизнес». Перейдите в раздел интеграции с 1С (услуга 1С:ДиректБанк / Sber API), включите интеграцию и скачайте готовый файл настроек в формате .json. Также задайте и сохраните пароль для TLS-сертификата шифрования, который предоставит банк.
  3. Настройте 1С: В программе 1С перейдите в раздел «Администрирование» -> «Настройки обмена с банками». Создайте новую настройку обмена, выберите вариант «Загрузить из файла» и укажите скачанный ранее файл .json.
  4. Авторизуйтесь: При первом сеансе связи система попросит ввести пароль от TLS-сертификата и подтвердить операцию СМС-кодом, отправленным на телефон ответственного лица. При этом физический USB-токен СберБизнеса может использоваться стандартным образом, но никаких дополнительных внешних компонент в 1С устанавливать не потребуется.

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

← На главную