Веб-версия приложения

Участники вашей команды могут работать в Compass в браузере, без установки приложения для компьютера.

Веб-версия Compass в браузере

Чтобы начать работу, откройте в браузере адрес https://<ваше доменное имя>/web/ и войдите в свой аккаунт Compass. Также перейти в веб-версию можно со страницы авторизации.

Переход в веб-версию со страницы авторизации

Настройка веб-версии

Compass On-premise поддерживает веб-версию начиная с версии 6.9.0. Веб-версия работает на основном домене приложения, отдельный домен и SSL-сертификат для нее не требуются.

После обновления сервера до версии 6.9.0 и выше веб-версия включается автоматически: в файле configs/global.yaml появятся параметры web.is_enabled и web.service.external_port, будет запущен контейнер веб-версии, а в конфигурацию nginx добавлен адрес /web/. Веб-версия станет доступна по адресу https://<ваше доменное имя>/web/ без каких-либо дополнительных действий.

# Веб-версия приложения
#
# Позволяет работать в Compass из браузера без установки приложения.
# После включения веб-версия будет доступна по адресу: https://<domain>/web/
#
# Тип данных: булево значение, true\false
web.is_enabled: true

# Внешний порт для контейнера с веб-версией.
# Запросы к веб-версии будут пересылаться на этот порт.
#
# Тип данных: число
# Пример: web.service.external_port: 31107
web.service.external_port: 31107

Перед обновлением сервера убедитесь, что порт 31107, который займёт веб-версия, свободен:

sudo ss -tlnp | grep 31107

Если порт свободен, после обновления веб-версия запустится на нём автоматически.

Если порт занят, освободите его перед обновлением или смените порт после обновления в параметре web.service.external_port файла configs/global.yaml и повторно выполните обновление серверной части:

sudo python3 script/update.py

Порт из параметра web.service.external_port используется только для внутреннего трафика между nginx и контейнером веб-версии. Ограничьте прямой доступ к нему из внешней сети:

sudo iptables -C DOCKER-USER -p tcp -m conntrack --ctorigdstport 31107 -j DROP 2>/dev/null \
   || sudo iptables -I DOCKER-USER -p tcp -m conntrack --ctorigdstport 31107 -j DROP

Если вы изменили web.service.external_port, замените 31107 в команде на выбранный порт.

Отключение веб-версии

Если веб-версия не нужна, отключите её:

  1. Откройте файл configs/global.yaml любым текстовым редактором.

  2. Установите значение false в параметре web.is_enabled:

    web.is_enabled: false

  3. Сохраните файл и выполните обновление серверной части:

    sudo python3 script/update.py

Напишите нам в пространстве поддержки On-premise, Telegram или на почту support@getcompass.ru, чтобы получить индивидуальную демонстрацию функционала и помощь по вопросам интеграции мессенджера в вашей компании.