Как установить агент для коробочной 1С

Если ваша 1С стоит на своём сервере («коробка»), публиковать её в интернет не нужно. Рядом с 1С запускается маленькая программа-агент: она читает базу на том же компьютере и сама отправляет данные в AudAIter по защищённому соединению. Входящих подключений агент не принимает и порты не открывает.

Что важно понимать

Агент работает только на чтение: он умеет отправить в 1С единственный вид запроса — на получение данных, и не может ничего создать, изменить или удалить. Весь код открыт — файл можно прочитать целиком перед запуском.

Ставится агент на тот компьютер (или сервер), где работает 1С, или на любой другой в вашей сети, откуда 1С видна по адресу вида http://ваш-сервер/база.

Шаг 1. Заведите пользователя 1С только для чтения

Так же, как для обычного подключения: в 1С в режиме «Конфигуратор» — Администрирование → Пользователи → Добавить. Имя, например, AudAIter, обязательно с паролем. На вкладке «Прочие» отметьте роль «Удаленный доступ OData» и роль на чтение данных. Административные права выдавать не нужно.

Включите состав REST-сервиса: Администрирование → Настройка автоматического REST-сервиса. Обязательно отметьте регистр бухгалтерии «Хозрасчетный» и справочник «Контрагенты», желательно — документы, кадровые документы и регистры основных средств (чем больше отмечено, тем полнее проверка).

Шаг 2. Получите код привязки в кабинете

В личном кабинете нажмите «Подключить коробочную 1С (агент)». Сервис покажет одноразовый код привязки вида XXXX-XXXX-XXXX. Код действует сутки и срабатывает один раз.

Шаг 3. Скачайте агент и запустите один раз

Скачайте файл AudAIter-Agent.ps1 и положите его, например, в папку C:\AudAIter. Откройте «Windows PowerShell» и выполните одну команду, подставив свои значения (адрес базы, логин и пароль того пользователя из шага 1 и код из шага 2):

.\AudAIter-Agent.ps1 -Base "http://localhost/базa/odata/standard.odata" -User "AudAIter" -Password "пароль" -Code "XXXX-XXXX-XXXX"

Агент привяжется к базе, прочитает данные и отправит их. Результат проверки появится в кабинете. Пароль и код после первого запуска сохраняются локально в защищённом файле — при следующих запусках их вводить не нужно, достаточно команды .\AudAIter-Agent.ps1.

Шаг 4. Настройте ежедневный запуск (по желанию)

Чтобы проверка обновлялась сама, добавьте задание в «Планировщик заданий» Windows: действие «Запуск программы», программа powershell.exe, аргументы:

-ExecutionPolicy Bypass -File "C:\AudAIter\AudAIter-Agent.ps1"

Задайте удобное время, например ночью — к утру отчёт будет свежим.

Если что-то пошло не так

Агент пишет понятным языком, что именно не так: не выдана роль, неверный пароль, недоступен адрес базы или потеряна привязка. По каждой ошибке в тексте сказано, что проверить. Если сообщение непонятно — напишите нам на support@audaiter.ru, приложив текст ошибки.

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

В любой момент можно отозвать привязку агента в кабинете и отключить пользователя OData в 1С — после этого агент перестанет иметь доступ к базе.