Сравнение страниц

Для того, чтобы платформа работала по протоколу HTTPS, необходимо установить сертификат на вашем сервере. Для этого выполните следующие шаги:

1. Поместите файл сертификата, ключа и, если есть, пароля (certificate.crt, privatekey.key, password.pass) в папку /var/lib/visiology/certs на вашем сервере.
   Приведённые выше имена названия файлов заданы по умолчанию, поэтому, если требуется их переименование, вы можете сделать это в соответствующей секции кода ниже.
   

2. В файле reverse-proxy.yml замените тело секции services.reverse-proxy.environment на код ниже:

1. Если для сертификата установлен пароль, необходимо раскомментировать 33-ю строку в файле /var/lib/visiology/scripts/extended-services/01-reverse-proxy-https.ym_ (расширение .ym_ не является ошибочным):

   Блок кода
   ssl_password_file /mnt/volume/password.pass

Если у вас есть файл пароля ключа, то необходимо раскомментировать строку ssl_password_file.

Если вы планируется встраивать в портал внешние ссылки, то для корректной работы нужно удалить 14 строчку

1. ;

Запуск платформы

При запуске run.sh требуется добавить аргумент --https true

/var/lib/visiology/scripts/run.sh --https true

Возможные неполадки и пути их устранения

Проблема: не удаётся зайти на платформу, когда она настроена для работы по HTTPS.

В этом случае, необходимо выполнить следующие шаги:

1. Проверьте, что сервис reverse-proxy запущен, выполнив следующую команду:
   docker service ls | grep reverse-proxy

2. Если он не запущен, просмотрите его логи:
   docker service logs visiology_reverse-proxy --since 5m

3. Если в логе присутствуют ошибки вида "Cannot load certificate..." или "Cannot load key...", то потребуется проверить соответствие названий файлов сертификатов на хосте и в файле reverse-proxy.yml.

В файле reverse-proxy.yml необходимо проверить следующее:

1. Убедитесь, что на хосте есть файл /var/lib/visiology/

Проблема: не работает один из компонентов платформы.

Платформа настроена для работы по HTTPS и один из ее компонентов не работает.

В этом случае, необходимо выполнить следующие шаги:

1. Проверьте, что сервис reverse-proxy запущен, выполнив следующую команду:
   docker service ls | grep reverse-proxy

2. Если он не запущен, просмотрите его логи:
   docker service logs visiology_reverse-proxy --since 5mscripts/extended-services/01-reverse-proxy-https.yml

3. Если в логе присутствуют ошибки вида "Cannot load certificate..." или "Cannot load key...", то потребуется проверить соответствие названий файлов сертификатов на хосте и в файле /var/lib/visiology/scripts/extended-services/01-reverse-proxy-https.yml.

4. В файле /var/lib/visiology/scripts/reverse-proxy.yml необходимо проверить следующее:

   • в секции services.reverse-proxy присутствует секция volumes со следующим содержимым:
     - /var/lib/visiology/certs:/mnt/volume;

   • на сервере расположены файлы сертификата, ключа и пароля (если требуется) в папке /var/lib/visiology/certs;

   • имена файлов сертификатов в папке /var/lib/visiology/certs соответствуют названиям в файле /var/lib/visiology/scripts/extended-services/01-reverse-proxy-https.yml в секции services.reverse-proxy.environment.HTTPS_SECTION_SERVER. Необходимо сравнить имена файлов (значение после последнего знака /).

Проблема: при входе на платформу возникает ошибка “Неверный redirect_uri”.

Также убедитесь, что сертификаты присутствуют в папке /var/lib/visiology/certs.

Выполните команду:

container_id=$(docker ps | grep visiology3_keycloak |  awk '{ print $1 }'); \
docker exec ${container_id} /opt/keycloak/bin/change-url.sh

Проблема: не открывается Grafana.

Если у вас используется самоподписанный сертификат, то его надо добавить в доверенные в Grafana. Для этого в файле создайте файл 50-grafana.yml в директории /var/lib/visiology/scripts/v3/monitoring.yml в секции services.grafana добавить строку в начало секции volumesextended-services с содержимым:

version: "3.8"

services:
  grafana:
    volumes:
      - /var/lib/visiology/certs/certificate.crt:/etc/ssl/certs/proxy.crt:ro

Смотрите также

📄 Разворачивание платформы