Битрикс24 в облаке и Битрикс на своём сервере
Битрикс24 существует в двух видах: облачный портал на домене вида my-company.bitrix24.ru и Битрикс, развёрнутый на собственном сервере компании. Для UnSpot это разные условия: часть интеграции работает в обоих вариантах, часть — только с облаком. Статья собирает различия в одном месте, чтобы их не пришлось выяснять на этапе внедрения.
Что поддерживается в каждом варианте
| Возможность | Битрикс24 в облаке | Битрикс на своём сервере |
|---|---|---|
| Приложение UnSpot внутри портала | Да, устанавливается из магазина приложений Битрикс24 | Нет — магазина приложений у собственной установки нет |
| Вход в UnSpot через Битрикс24 (SSO) | Да | Нет |
| Синхронизация календарей переговорных | Да, через входящий и исходящий вебхуки портала | Да, тем же способом — при выполнении требований ниже |
Коротко: календари синхронизируются в обоих вариантах, вход через Битрикс24 — только с облачным порталом. Если компания живёт на собственном Битриксе и нужен единый вход, его настраивают через другого поставщика — например, по OAuth 2.0 через Keycloak или AD FS.
Почему вход через Битрикс24 работает только с облаком
Причина не в настройках, а в устройстве самого Битрикса: подтверждение авторизации приложение получает через централизованный сервис авторизации Битрикс24, общий для всех облачных порталов. У установки на своём сервере такого сервиса нет, поэтому обменять подтверждение входа на доступ не получится.
Практическое следствие: поле «Портал Bitrix24» в карточке настройки принимает только адреса вида my-company.bitrix24.ru или my-company.bitrix24.com. Адрес собственного сервера форма не примет.
Требования к своему серверу для синхронизации календарей
Синхронизация календарей построена на вебхуках, а они не зависят от облачного сервиса авторизации — поэтому с собственным Битриксом она работает. Условия такие:
| Требование | Почему |
|---|---|
| Портал доступен по HTTPS на 443-м порту | UnSpot обращается к вебхуку только по защищённому протоколу и только на стандартном порту: из адреса вебхука берётся лишь имя хоста, номер порта отбрасывается. Установка на другом порту или без HTTPS не подойдёт |
| Портал доступен из сети, где работает UnSpot | Обращения идут в обе стороны: UnSpot читает календари портала, портал сообщает об изменениях событий |
| Сертификат сервера действителен | Иначе обращения к порталу будут отклоняться на этапе установки соединения |
| Модуль календаря включён, есть календари-локации | Интеграция работает только с ними — обычные и личные календари для привязки к переговорным не подходят |
| Входящий вебхук создан от учётной записи с административными правами | UnSpot ищет участников встреч по всему порталу; прав рядового сотрудника для этого недостаточно |
Дальше настройка ничем не отличается от облачной: тот же входящий вебхук, тот же исходящий, тот же порядок действий в UnSpot. Единственная разница — в поле подключения указывается адрес вашего сервера вместо адреса на bitrix24.ru.
Отдельно: UnSpot на своём сервере
Не путайте два разных «своих сервера». Всё выше — про то, где развёрнут Битрикс. У UnSpot тоже есть вариант установки в инфраструктуре компании, и на интеграцию он влияет по-своему:
- Синхронизация календарей работает без дополнительных условий — нужен только доступ до портала Битрикс.
- Вход через Битрикс24 и приложение в портале требуют, чтобы установка UnSpot была зарегистрирована на стороне Битрикс24 и имела исходящий доступ к сервису авторизации Битрикс24. Если этого нет, карточка Bitrix24 в правилах авторизации не заработает — вопрос решается через поставщика, а не настройками в консоли.
Карточка Bitrix24 в разделах интеграций отображается только в российском контуре UnSpot. Если её нет ни в правилах авторизации, ни в блоке синхронизации календарей, обратитесь к поставщику: скорее всего, установка собрана без российских сервисов.
