SERVICES Подключение

Установка Сервисов

Для локальной установки вам необходим доступ к репозиторию github/totumonline/totum-services. Что бы получить приглашение, у вас должна быть действующая оплаченная лицензия PRO-версии.

Установка осуществляется на чистую Ubuntu 24.04. Это должен быть отдельный от установки Totum сервер!

Требования к серверу зависят от нагрузки, но мы рекомендуем не менее 2C 2Gb.

sudo curl -O https://raw.githubusercontent.com/totumonline/totum-mit/master/totum/moduls/install/totum_services_autoinstall.sh && sudo bash totum_services_autoinstall.sh

В процессе установки вам нужно будет ввести данные (имя пользователя и email) вашего пользователя GitHub (имеющего доступ к репозиторию сервисов). Установщик сгенерирует SSH-ключ сервера, который необходимо добавить в https://github.com/settings/keys на GitHub от соответствующего пользователя.

Вид ключа:

ssh-ed25519 AAAAC3NzaC1JSDYSGJDAAAII1xBM65sdrDUEll6AeQwd2Cszn80IoA9Bpk8g5 some@email.com

Конфигурация сервера осуществляется через ansible, поэтому при наличии ошибок в процессе установки (например отсутсвия сети между севером и репозиториями) вы можете запустить скрипт установки повторно, вам будет предложено продолжить установку.

Totum V4 возможно подключить только к установке с доменом и SSL-сертификатом (получается автоматически скриптом установки при наличии валидного домена).

Totum V5 может работать как с сервисами по SSL так и без, по ip. Если Сервисы установлены по ip (без домена), вам нужно отключить проверку сертификата со стороны Totum.

nano /home/totum/totum-mit/Conf.php

Добавьте строку после protected $execSSHOn:

protected $checkSSLservices = false;

Вы можете сначала установить без домена и потом переключить на установку с доменом. Для того адресуйте домен на ip сервера, проверьте наличие ping и повторно запустите установщик из той папки из которой он был запущен изначально, вам будет предложено ввести домен и получить сертификат.

Подключаем Тотум к сервисам

Для добавления сервера в доступные на сервере Сервисов необходимо заполнить services_list:

nano /home/totum/totum-services/services_list

{"number":"3922029074","key":"kIUTdlkUGSdvjadhfKJGSYUdgdfsdf","back_url":"https://live.ttmapp.ru","check_back_url_certificate":true}

number — произвольный номер. Каждый подключенный host должен иметь свой уникальный номер! Журналы доступа записываются с использованием этого номера. Необходимо добавить его в схему Totum в таблицу ttm__services, в поле h_services_number.
key — ключ доступа. Сгенерируйте случайный набор цифр и букв и добавьте его в схему Totum в таблицу ttm__services, в поле h_services_key.
back_url — HOST вашего сервера Totum с протоколом http:// или https://.
check_back_url_certificate — true | false. Если false, проверка действительности SSL-сертификата для вашего Totum будет отключена. Это необходимо в случаях, когда Totum установлен без сертификата.

Вы можете добавить несколько настроек серверов Totum на один сервер Сервисов. Для этого добавьте строку конфигурации сервера в аналогичном формате с новой строки.

Если вы хотите отключить сервер, закомментируйте строку.

Обязательно СОХРАНИТЕ файл, перед тем как переходить к настройкам в Totum!

Настройка в Totum:

В Totum заполняются поля в таблице ttm__services.

h_services_url — https://SERVICES_HOST или http://SERVICES_IP (доступно только в V5)
h_services_number — номер сервиса, который вы указали в services_list.
h_services_key — ключ сервиса, который вы указали в services_list.
h_check_service_server — проверка подключения. ответ должен быть number: OK

Логи

Лог сервисов записывается в services_log и раз в сутки очищается (оставляются последние 1000 строк).

Посмотреть:

tail -f /home/totum/totum-services/services_log

⟵ сюда туда ⟶