«Арете — сервер мессенджеров, Max edition»
Руководство по установке
Проверьте соответствие конфигурации техническим требованиям
- Версия платформы 1С:Предприятия 8.3.25 или выше
- Режим совместимости не установлен или не ниже 8.3.25
- Управляемые формы
Как узнать режим совместимости?
- Откройте 1С:Предприятие в режиме конфигуратора
- Нажмите "Конфигурация" -> "Открыть конфигурацию"
- Режим совместимости указан в значении свойств "Режим совместимости"
- Откройте свойства конфигурации
Что делать если формы "обычные"
На обычных формах решение пока не тестировалось, но скорее всего тоже запустится — через относительно небольшие доработки. Нам это тоже интересно. Обращайтесь в поддержку, разберёмся и вероятно запустим.
Проверьте доступность API Max-ботов
Если используется клиент-серверный вариант работы 1С:Предприятия (рекомендуется), то проверять доступность необходимо с рабочей машины сервера 1С:Предприятия. Для файлового варианта работы — с машины, на которой будет запускаться обмен.
- Откройте командную консоль — CMD, Bash или Powershell
- Выполните команду:
curl -i -X GET "https://platform-api2.max.ru/me" -H "Authorization: {access_token}"
Invoke-WebRequest -Uri "https://platform-api2.max.ru/me" -Method Get -Headers @{Authorization = "{access_token}"}
f9WHodD0cOIYXVjz8UGZWxS_38FqECtDyWJ-Xkftm-L-tswIncoJsGdhJgKj1aHGkuCN8ZMKBrCES-_QRbB2
Если связь установлена, то команда вернёт ответ. Если в ответе содержится код 200, то всё в порядке. Для команды CMD или Bash это будет строка вида "HTTP/1.1 200 OK". Для команды Powershell это будет строка вида "StatusCode: 200". Если ответ возвращает другой код, то связь есть, однако, нужно обратить внимание на код и тело ответа — в них содержится описание ошибки. Если же выполнение команды вообще ничего не вернуло, значит, с этой машины ресурс API Max-ботов недоступен и нужно устранять ошибку на уровне локальной сети и настроек безопасности (вероятно, через системного администратора)
Отдельно стоит ошибка проверки сертификата — сообщение вида
unable to get local issuer certificate или
SSL certificate problem. Это не сеть: на машине не добавлен корневой
сертификат Минцифры, смотрите следующий шаг.
Настройте доверие к сертификату Минцифры
API Max (platform-api2.max.ru) использует SSL-сертификат, выданный УЦ Минцифры.
Windows и Linux по умолчанию этому удостоверяющему центру не доверяют — пока его корневой
сертификат не добавлен в систему, 1С не сможет подключиться к Max по HTTPS.
На сервере 1С — нужно всегда (GET /updates и Webhook)
1С сама обращается к platform-api2.max.ru при любом способе работы:
запрашивает события через GET /updates, регистрирует вебхук через
POST /subscriptions, отправляет сообщения. Платформа проверяет сертификаты
через хранилище операционной системы, поэтому корневой сертификат Минцифры нужно
установить на ту машину, с которой 1С выходит в интернет:
- клиент-серверная база — на сервер 1С:Предприятия (на рабочие места пользователей и на отдельный веб-сервер ставить не нужно)
- файловая база — на компьютер, где запускается обмен
Скачайте корневой сертификат Russian Trusted Root CA на сайте
Госуслуг
(прямая ссылка на файл).
Промежуточный сертификат ставить не нужно — сервер Max передаёт его сам.
-
Windows: откройте скачанный файл
.crt→ «Установить сертификат» → «Локальный компьютер» → «Поместить все сертификаты в следующее хранилище» → «Доверенные корневые центры сертификации». Выбирайте именно «Локальный компьютер», иначе служба сервера 1С сертификат не увидит -
Linux (Debian, Ubuntu, Astra Linux): скопируйте файл
.crtв/usr/local/share/ca-certificates/и выполнитеsudo update-ca-certificates
После установки перезапустите службу сервера 1С:Предприятия, чтобы она подхватила
обновлённое хранилище. Если вы получаете события опросом (GET /updates),
больше ничего с сертификатами делать не нужно.
На веб-сервере — дополнительно для Webhook
При работе через Webhook уже сам Max подключается снаружи к опубликованному HTTP-сервису 1С и проверяет SSL-сертификат вашего домена. В 1С здесь ничего не настраивается: база всегда опубликована через Apache или IIS, а перед ними часто стоит nginx, поэтому сертификат домена ставится только на самый внешний веб-сервер:
- перед Apache или IIS стоит nginx — сертификат и закрытый ключ прописываются в nginx; внутри сети до Apache или IIS трафик идёт по обычному HTTP, сертификат им не нужен
-
nginx нет — сертификат настраивается напрямую в Apache
(
SSLCertificateFile/SSLCertificateKeyFile) или привязывается к сайту в IIS
Требования Max к HTTPS-адресу вебхука:
- только HTTPS на стандартном порту 443 (обычный HTTP и другие порты не поддерживаются)
- SSL-сертификат выдан на ваш домен любым доверенным УЦ (например, Let's Encrypt) или УЦ Минцифры — специально выпускать сертификат в Минцифры не нужно, Max просто принимает его наравне с обычными. Самоподписанный сертификат не подойдёт
-
веб-сервер отдаёт полную цепочку сертификатов вместе с промежуточным (для nginx в
ssl_certificateуказывается файлfullchain, а не только сертификат домена)
Создайте архивную копию базы перед установкой расширения
Действие, необходимое перед любыми изменениями конфигурации рабочей базы 1С
Установите расширение «Арете — сервер мессенджеров, Max edition»
Уведомление: расширение скорее всего не получится установить через
"Управление расширениями конфигурации" в режиме 1С:Предприятия, потому что этот способ
ожидает одинакового режима совместимости расширения и основной конфигурации, а это
встречается довольно редко.
- Откройте 1С:Предприятие в режиме конфигуратора
- Нажмите "Конфигурация" -> "Расширения конфигурации"
-
Нажмите "Добавить". Имя, синоним и префикс не меняйте,
позже они поменяются автоматически. В поле "Назначение"
укажите "Дополнение". Нажмите "ОК".
Добавление расширения -
Спозиционируйтесь на добавленном расширении, нажмите "Конфигурация" —>
"Загрузить конфигурацию из файла". Важно: не перепутайте пункт меню
"Конфигурация" расширения с пунктом меню "Конфигурация" основной конфигурации
Загрузка расширения -
После загрузки, нажмите "Конфигурация" -> "Обновить конфигурацию".
Исправьте возникшие "ошибки
режима совместимости" через "установить свойство из основной базы". Дождитесь обновления конфигурации, принимая через кнопку "Принять" все изменения. - Снимите безопасный режим у расширения: иначе исходящие HTTP-запросы к Max, скорее всего, не пройдут.
- Если Вы планируете разрабатывать во внешней обработке, то снимите также и защиту от опасных действий. Обращение ко внешней обработке действительно является потенциально опасным действием (код внешней обработки легко меняется недоверенными лицами)
- При желании, переназначьте добавленной подсистеме "АСМ" картинку с "АСМ_Подсистема16" на "АСМ_Подсистема32" — для интерфейсов с более крупными картинками
- При возникновении трудностей и сомнений при установке помните — поддержка рядом. Пишите, звоните, и получите квалифицированную помощь.
Назначьте роли выделенным пользователям
Роль АСМ — Администратор подсистемы — администратору подсистемы.
Роль АСМ — Чат-бот обеспечивает минимально необходимые права
для работоспособности бота пользователю, от имени которого работают вебхуки
или регламентные задания. Если бот будет менять основные объекты конфигурации,
добавляйте права на изменение в эту роль.
Введите выданный с покупкой лицензионный ключ
В режиме 1С:Предприятия откройте пункт меню "Лицензия" и введите лицензионный ключ — он обеспечит работоспособность решения.
Инициализируйте подсистему
В режиме 1С:Предприятия откройте пункт меню "Инициализация подсистемы" и везде последовательно нажмите "Заполнить" — заполнение метдов Max, заполнение справочников роутинга, справочника эмодзи. Создайте регламентное задание очистки журнала.
Возможные проблемы и способы их решения
- Нет исходящего HTTPS — расширение осталось в безопасном режиме. Выключите безопасный режим или создайте профиль безопасности, включив в него обращение к интернет-ресурсу по адресу https://platform-api2.max.ru
- Ошибка сертификата при соединении с Max — корневой сертификат Минцифры не добавлен в доверенные на той машине, которая обращается к API. Проверьте, что он лежит в «Доверенных корневых центрах» локального компьютера (Windows) или в системном хранилище (Linux), а затем перезапустите службу сервера 1С:Предприятия
-
Отсутствует раздел "АСМ" в режиме 1С:Предприятия
— пользователю не назначена роль
АСМ — Администратор подсистемы - Не выполняются никакие методы — не была выполнена инициализация подсистемы