Установка коннектора Сведуна

Коннектор Сведуна устанавливается рядом с 1С за 15 минут: это один исполняемый файл, который сам подключается к шлюзу исходящим соединением на порт 443. Входящие порты не нужны, пароль 1С остаётся в вашей сети.

Проверьте требования

База опубликована по стандартному интерфейсу OData и есть пользователь только на чтение, как описано в настройке OData. Сервер в той же сети: Windows Server 2016 и новее x64 или Linux x64. С него открывается адрес публикации 1С и разрешён исходящий HTTPS на домен шлюза. Токен коннектора вида svd_conn_… выдаёт администратор шлюза.

Заполните конфиг

Файл svedun-connector.json:

{
  "gateway_url": "wss://connect.svedun.ru",
  "token": "svd_conn_…",
  "onec_url": "http://srv-1c/ut11",
  "onec_login": "svedun_readonly",
  "onec_password": "…",
  "max_concurrency": 4,
  "log_file": ""
}

Адрес onec_url указывается без /odata/standard.odata. Пароль можно не хранить в файле, а передать переменной окружения SVEDUN_ONEC_PASSWORD. Доступ к файлу оставьте только администраторам и учётной записи службы.

Для проверки запустите коннектор вручную: в выводе должно появиться сообщение «подключён к шлюзу».

svedun-connector.exe svedun-connector.json

Установите службу в Windows

Положите в папку C:\Program Files\Svedun\` файлы `svedun-connector.exe, svedun-connector.json, обёртку службы WinSW под именем svedun-connector-service.exe и её конфиг svedun-connector-service.xml. В PowerShell от администратора выполните в этой папке:

.\svedun-connector-service.exe install
.\svedun-connector-service.exe start

Служба «SvedunConnector» работает под NT AUTHORITY\LocalService, стартует автоматически и перезапускается при сбое. Журнал лежит рядом с ней.

Установите службу в Linux

Создайте системного пользователя, разложите файлы и включите юнит systemd:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin svedun
sudo install -D -m 0755 svedun-connector /opt/svedun/svedun-connector
sudo install -D -m 0640 -o root -g svedun svedun-connector.json /etc/svedun/connector.json
sudo cp svedun-connector.service /etc/systemd/system/
sudo systemctl daemon-reload && sudo systemctl enable --now svedun-connector

Состояние: systemctl status svedun-connector, журнал: journalctl -u svedun-connector -f.

Проверьте связь со стороны шлюза

Попросите ассистента проверить подключение или вызовите инструмент connection_status через REST API. Ожидается status: ok и mode: connector.

Как отключить

Частые проблемы

Коды ошибок инструментов описаны в отдельной таблице.