Мастер конфигурации

Платформа Navixy предлагает мастер настройки, который пользователи могут использовать для первоначальной конфигурации платформы или изменения некоторых общих настроек. Хотя все описанные ниже параметры можно применить напрямую к конфигурациям базы данных и сервисов, это может быть рискованно при неправильном обращении. Чтобы избежать потенциальных рисков, настоятельно рекомендуется использовать конфигуратор.

Мастер настройки конфигурации можно использовать только для экземпляров Navixy, развернутых с помощью скрипта установки на Ubuntu. Этот мастер неприменим для других методов развертывания.

Запуск мастера настройки

Чтобы запустить мастер, перейдите в директорию /navixy-package и выполните ./configure.sh

Вас поприветствует главное меню:

On-Premise - мастер настройки

Ниже приведено объяснение каждого меню и подменю:

1. Настройки доменного имени и SSL

1.1. Доменные имена

Единственная опция здесь — изменить доменные имена и SSL.

Доменные имена и SSL-сертификаты задаются во время начальной установки. Однако могут возникнуть ситуации, когда необходимо изменить некоторые из них для уже существующей платформы.

Мастер конфигурации позволяет выполнить настройку либо с одним доменным именем для всей платформы, либо с тремя доменными именами — отдельными для API, для панели администратора и для пользовательского интерфейса.

В случае одного доменного именивам достаточно указать домен для вашего сервиса на первом шаге, оставив два других домена пустыми. В этом случае API и панель администратора будут настроены как подкаталоги (это выполняется автоматически). Примеры:

• my.domain.com/api

• my.domain.com/panel

Если вы выполняете настройку с тремя доменами вам необходимо указать последовательно:

• Домен сервиса (используется для пользовательского интерфейса и активации устройств). Напр.: my.domain.com

• Домен API (используется для всех операций API). Напр.: api.domain.com

• Домен панели администратора (используется для доступа к панели администратора). Напр.: panel.domain.com

On-Premise - Настройки домена

On-Premise - Настройки API

On-Premise - Настройки панели

После указания всех доменов мастер покажет вам результаты конфигурации. Если необходимо внести изменения, запустите мастер снова

On-Premise - Завершение конфигурации

Вы можете узнать дополнительную информацию о доменных именах на этой странице: Домены

1.2. SSL-сертификаты

После настройки доменных имен вы увидите меню установки SSL-сертификатов.

On-Premise - SSL-сертификаты

Если вы вообще не собираетесь использовать SSL, просто выберите Нет и скрипт завершится, сохранив только конфигурацию доменных имен.

Если вы выберете Да, ваша платформа будет настроена на использование HTTPS.

Далее скрипт спросит вас, собираетесь ли вы использовать бесплатные SSL-сертификаты Let's Encrypt или хотите использовать собственные сертификаты.

On-Premise - Обновление SSL-сертификатов

Бесплатный сертификат Let's Encrypt

Выберите Да чтобы установить бесплатные SSL-сертификаты Let's Encrypt для ваших доменов. Это также настроит автоматическое обновление сертификатов, чтобы вам не приходилось обновлять их вручную.

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

Вам будет предложено указать адрес электронной почты. Это не обязательно, но рекомендуется.

On-Premise - Let's Encrypt

Скрипт автоматически распознает доменные имена (беря их из конфигураций), сгенерирует и установит сертификаты. После этого скрипт завершит работу.

Теперь вы настроили доменные имена, и ваш сайт защищен SSL.

Собственный SSL-сертификат

Выбор Нет опции в ответ на вопрос о сертификатах Let's Encrypt приведет вас в меню установки собственных SSL-сертификатов. Для продолжения у вас должен быть действительный full-chain сертификат, а также его приватный ключ. Разместите их где-нибудь на вашем сервере. Стандартное расположение — /etc/nginx/ssl.

Сначала вам нужно указать путь к файлу сертификата:

On-Premise - Собственный сертификат

Далее укажите путь к файлу приватного ключа вашего SSL-сертификата:

On-Premise - Ключ собственного сертификата

Пути к вашим сертификатам будут вставлены в конфигурацию Nginx.

Сертификаты установлены, и ваши домены защищены SSL.

2. Настройки SMS

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

On-Premise - SMS-шлюз

2.1. Настройка SMS-шлюза

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

Другие опции позволяют применить настройки для конкретного поставщика услуг SMS-шлюза.

Последняя опция позволяет подключить SMS-шлюз через протокол SMPP. Эта опция также подходит, если вашего поставщика нет в списке, но он поддерживает SMPP.

On-Premise - Конфигурация SMS-шлюза

Вы можете узнать больше о SMS-шлюзах на странице Шлюзы сообщений.

Настроить "from name" и "номер телефона отправителя"

В этом меню при необходимости вы можете указать номер и имя отправителя сервисных SMS-сообщений.

On-Premise - Номер телефона SMS-шлюза

On-Premise - Идентификатор SMS-шлюза

3. Настройки почтового шлюза

Здесь вы можете настроить только параметры обратной связи по электронной почте. Обратите внимание: Основные настройки почтового шлюза настраиваются из панели администратора (Шлюзы сообщений).

Скрипт запросит указать адрес электронной почты для получения отзывов пользователей из раздела помощи (адрес TO).

On-Premise - Почтовый шлюз

Затем вас спросят о подстановке письма от имени пользователя.

On-Premise - Конфигурация почтового шлюза

Выберите ДА чтобы использовать адрес электронной почты пользователя для отправки запросов обратной связи.

Выберите НЕТ чтобы заменить адрес отправителя на конкретный. В этом случае скрипт попросит указать этот адрес электронной почты (адрес FROM).

On-Premise - Обратная связь по почте

4. Настройки Google Maps API

Здесь вы можете указать ключ Google Maps API, если вы не приобрели пакет Premium GIS у Navixy, а предпочли использовать ключ, купленный самостоятельно (GIS)

On-Premise - Ключи Google Maps API

Сначала необходимо указать JavaScript-ключ Google API (требуется для отображения карт).

On-Premise - Ключ JavaScript для Google Maps API

Далее примените серверный ключ Google API (требуется для операций геокодирования).

On-Premise - Ключи Google Maps API

5. Лицензионный ключ Navixy

Этот раздел содержит две опции.

On-Premise - Лицензионный ключ Navixy

5.1. Изменить лицензионный ключ

Здесь вы можете указать лицензионный ключ для вашего On-Premise экземпляра. Лицензионный ключ применяется во время начальной установки платформы или если он был потерян или поврежден по какой-либо причине (обычно как следствие вмешательства в базу данных). Лицензионный ключ выдается и предоставляется службой технической поддержки.

После выбора этой опции вы увидите предупреждение, что небрежная смена лицензионного ключа может привести к неработоспособности платформы.

On-Premise - Изменение лицензионного ключа

После этого вам нужно применить полученный лицензионный ключ. Это довольно длинная комбинация символов, поэтому ввод вручную может быть затруднителен. Вы можете вставить ключ из буфера обмена, используя сочетание клавиш Shift+Insert В качестве альтернативы вы можете удерживать Shift и использовать кнопку правой кнопки мыши.

On-Premise - Ввод лицензионного ключа

Ключ будет внесен в базу данных, и ваш экземпляр получит действительную лицензию.

5.2. Запросить пробный ключ

Эту опцию можно использовать только для получения одноразового пробного ключа. Ключ действует 30 дней. Не используйте эту опцию, если у вас уже есть действующий ключ.

On-Premise - Запрос пробного ключа

• Вы не сможете перевыпустить или продлить пробный ключ таким способом.

• Вы не сможете восстановить утерянный ключ таким способом.

• Вы не сможете восстановить отключенную лицензию таким способом.

После истечения пробного периода и если вы хотите продолжить использование On-Premise экземпляра, пожалуйста, свяжитесь с нашей командой по успеху клиентов для получения коммерческого лицензионного ключа.

6. Настройки плагинов

Плагины позволяют изменять или включать различные функции платформы. Поскольку конфигуратор предназначен для базовой настройки платформы, в этом меню вы найдете только три плагина.

On-Premise - Настройки плагинов

6.1. Настройки кода активации

Здесь вы можете включить или отключить использование обязательных кодов активации для регистрации устройств. Если опция «Обязательно» включена, пользователи не смогут зарегистрировать устройство без кода активации.

On-Premise - Настройки кодов активации

6.2. Настройки пользовательского логотипа

Здесь вы можете настроить специальный логотип для отдельного пользователя.

Обратите внимание: логотип для всей платформы настраивается в панели администратора.

Мастер конфигурации попросит вас указать ID пользователя (он может быть найден в панели администратора или в пользовательском интерфейсе)

On-Premise - Настройки логотипа

Далее вам необходимо указать ссылку на логотип пользователя. Он может находиться на внешнем ресурсе или локально на сервере в каталоге веб-сайта. Логотип должен быть в формате PNG, рекомендованный размер — 400x400.

On-Premise - Логотип

Логотип будет применен в пользовательском интерфейсе и в отчетах.

6.3. Настройки раздела помощи

Здесь вы можете выбрать, скрывать или показывать раздел помощи в пользовательском интерфейсе (по умолчанию он отображается). Раздел помощи ведет на сайт Navixy, поэтому его отключение может быть полезно для белого брендинга.

On-Premise - Настройки раздела помощи

7. Настройки хранилища файлов

Этот раздел позволяет включать и отключать хранилище файлов.

On-Premise - Настройки хранилища файлов

Оно используется для хранения приложенных к формам задач и работам по обслуживанию файлов и изображений. Каталог по умолчанию для хранения файлов — /home/java/api-server/files.