Документация Enums

Установка коннектора 1С на компьютере клиента, активация по лицензионному ключу и выбор активной базы в интерфейсе

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

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

Как это работает

Коннектор на сервере клиента — специальный коннектор, который устанавливается на вашем сервере в локальной сети с 1С. После активации каждой базы коннектор регистрируется как служба Windows с автозапуском при старте операционной системы.
Связь с 1С — локально. Коннектор обращается к HTTP-сервису внутри 1С. Вы задаёте базовый адрес публикации базы (например http://localhost/buh) и корневой URL сервиса (по умолчанию mcp); фактический путь, по которому коннектор стучится в 1С, складывается как <адрес_базы>/hs/<корень> (например http://localhost/buh/hs/mcp). Способ входа в 1С обсуждается при настройке — поддерживается несколько вариантов.
Связь с облаком — исходящий туннель. Коннектор открывает защищённое WebSocket-соединение (WSS) в облако enumslab.
Активация по лицензии. Коннектор отправляет лицензионный ключ в сервис активации и в ответ получает идентификатор подключения (connection_id) и секрет для последующих переподключений. Без действующей лицензии коннектор не подключится.

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

Установка коннектора (на компьютере клиента)

Установка выполняется на сервере, где доступна 1С. Откройте PowerShell от имени администратора и запустите установщик. Команда скачивает установочный файл и запускает установку.

[Net.ServicePointManager]::SecurityProtocol = 3072
irm "https://enums-install.storage.yandexcloud.net/mcp/install.ps1" | iex

Первая строка включает TLS 1.2 (нужна на Windows Server 2016 и старше). В процессе установщик спросит:

Папку установки — по умолчанию C:\Enums\MCP (нажмите Enter, чтобы согласиться).
Добавить в PATH? — рекомендуется ответить Д.

Установщик разворачивает коннектор и необходимые компоненты. Если коннектор уже был установлен, установщик временно останавливает его службы и затем запускает снова.

Активация базы 1С (мастер)

После установки запустите активацию. Это интерактивный мастер, который привязывает конкретную базу 1С к вашей компании в enumslab.

C:\Enums\MCP\enums-mcp.exe --activate

Мастер по шагам спросит:

Лицензионный ключ — обязателен, без него активация не пройдёт.
URL базы 1С — адрес публикации базы, например http://localhost/buh.
Тип конфигурации 1С — определяет набор доступных инструментов. Допустимые значения: 8dot3bukh (1С:Бухгалтерия предприятия 3.0), 8dot3bukhbitappetitresto3 (1С:Бухгалтерия + Битапетит Ресто 3), 8dot3upravlavto2 (1С:Комплексная Автоматизация 2).
Режим пользователей — как коннектор аутентифицируется в базе 1С (см. ниже). По умолчанию — «один пользователь» (single).
Учётные данные 1С — имя пользователя и пароль (запрашиваются только в режиме «один пользователь»). На этом шаге выполняется проверка связи с 1С; при ошибке можно продолжить вручную.
ID экземпляра — короткий идентификатор подключения на этом сервере (например buh, sklad, zup). По умолчанию default.
Отображаемое имя — как подключение будет называться в интерфейсе enumslab (по умолчанию совпадает с ID экземпляра).
Корневой URL HTTP-сервиса 1С — по умолчанию mcp.
Порт Admin UI — только для режима «несколько пользователей» (по умолчанию 8088, далее по возрастанию для следующих экземпляров).
Поддерживать сессию 1С активной — опция «прогрева» сессии (по умолчанию выключена). Рекомендуется включать на серверах с ограниченными ресурсами, чтобы избежать задержек при первом обращении.

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

Режимы пользователей

Режим определяет, как коннектор подключается к базе 1С. Выбирается в мастере активации:

Без аутентификации (noauth). Для баз 1С без пользователей. Учётные данные не запрашиваются.
Один пользователь (single). Все обращения к 1С идут под одной учётной записью, заданной при активации (имя пользователя и пароль обязательны). Это режим по умолчанию.
Несколько пользователей (multi). Пользователи 1С управляются через отдельную локальную панель управления коннектора. Подходит, когда обращения к 1С должны идти под разными учётными записями.

Режим можно изменить позже без переустановки командой enums-mcp --reconfigure <id>. При перенастройке идентификатор подключения (connection_id) и лицензия сохраняются, меняются только настройки доступа к 1С (URL, тип конфигурации, режим, учётные данные).

Управление коннектором (команды)

Коннектор управляется из командной строки на сервере клиента. Основные команды:

enums-mcp --activate — добавить новую базу 1С (мастер активации).
enums-mcp --list — список всех подключений на сервере с их статусом (работает / остановлен / не установлен / на паузе).
enums-mcp --status <id> — подробности по подключению.
enums-mcp --test <id> — проверка связи с 1С.
enums-mcp --start <id> / --stop <id> / --restart <id> — управление службой одного подключения.
enums-mcp --start-all / --stop-all / --restart-all — те же операции сразу для всех подключений.
enums-mcp --reconfigure <id> — изменить настройки (URL, тип конфигурации, режим, учётные данные).
enums-mcp --deactivate <id> — отключить базу и удалить её конфигурацию.
enums-mcp --update — загрузить последнюю версию и перезапустить службы.
enums-mcp --version — версия коннектора.
enums-mcp --commands — справка по всем доступным командам.

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

Выбор активного подключения в интерфейсе

В веб-интерфейсе вы не создаёте подключение — оно появляется автоматически после активации коннектора. Дальше вы просто выбираете, с какой базой работать.

Список подключений подгружается автоматически и периодически обновляется в фоне (примерно раз в минуту), поэтому новое подключение появляется вскоре после активации без перезагрузки страницы.
Если подключений несколько, в верхней панели появляется переключатель базы (выпадающий список). В нём показывается отображаемое имя подключения и метка системы — например «Бухгалтерия · 1C». При смене базы система покажет уведомление «База данных изменена».
Если подключение одно, переключатель не показывается — оно выбрано автоматически.
Индикатор связи рядом с переключателем показывает состояние выбранного подключения. Зелёный — связь есть; иначе подсказка «Нет связи» (коннектор остановлен или база недоступна).
Выбор базы запоминается в браузере и восстанавливается при следующем входе. Если ранее выбранная база остановлена, система выбирает первую доступную.

Если активных подключений нет, в соответствующих разделах появляется сообщение «Нет активных подключений к 1С» с подсказкой убедиться, что коннектор 1С запущен и подключён к серверу.

Несколько баз 1С

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

Ограничения и важные замечания

Подключение 1С невозможно завести из веб-интерфейса — оно создаётся только через активацию коннектора на сервере клиента.
Для активации нужен действующий лицензионный ключ. При отзыве лицензии коннектор перестаёт подключаться.
Коннектор работает под Windows и устанавливается как служба; для установки нужны права администратора.
Если подписка компании приостановлена или заблокирована, интерфейс покажет соответствующее сообщение вместо рабочих экранов — даже при исправном подключении.
Подключение iiko — это облачное подключение и заводится иначе (без локального коннектора). Подробнее в разделе Подключение iiko.

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

Я активировал базу, но её нет в списке. Подождите до минуты (список обновляется фоном) или обновите страницу. Проверьте, что служба запущена: enums-mcp --list и при необходимости enums-mcp --start <id>.
Индикатор «Нет связи». Коннектор остановлен или 1С недоступна. Проверьте службу и связь с 1С командой enums-mcp --test <id>.
Нужно ли открывать порты наружу? Нет. Коннектор сам устанавливает исходящее соединение в облако; входящий доступ к 1С извне не требуется. Ваша база надёжно защищена — никто снаружи не может получить к ней прямой доступ.
Как поменять учётные данные или режим? Командой enums-mcp --reconfigure <id> — переустанавливать коннектор не нужно.

Подключение 1С

На этой странице