Как исправить подключение по HTTPS если сломался сертификат
В случае невнимательных действий с конфигурацией сервера вы можете «сломать» подключение по HTTPS. Если пользователи используют клиентские приложения, то поломка HTTPS соединения практически не нарушит работу инфраструктуры, но принесёт некоторые неудобства:
- будут не доступны панель управления сервером, личный кабинет и планировщик конференции во всех клиентских приложениях;
- перестанут работать конференции по WebRTC (участие через браузер);
- остановится выполнение скриптов, где задействовано API TrueConf Server.
Причины поломки HTTPS
Наиболее вероятные причины поломки HTTPS:
- При переносе TrueConf Server с одной машины на другую может сломаться подключение по HTTPS, если администратор сервера забыл перенести необходимые файлы. В таком случае авторизация в панели управления будет недоступна.
- При изменении внешнего имени сервера вы заранее не позаботились выписать сертификат. В данном случае гостевая страница сервера будет недоступна и браузер отобразит ошибку
NET::ERR_CERT_AUTHORITY_INVALID
. - В организации используются сертификаты, подписанные локальным удостоверяющим центром. В случае неправильной конфигурации сертификата соединение по HTTPS может не работать и браузер отобразит ошибку
ERR_SSL_KEY_USAGE_INCOMPATIBLE
.
Общее решение проблемы
Независимо от причины, способ решения проблемы общий. Для решения проблемы вам необходимо перенести корректный сертификат и его приватный ключ на целевую машину или выписать новый сертификат, если есть такая возможность. Пример получения бесплатного TLS-сертификата описан в наших статьях:
- Создание сертификата «Let’s Encrypt» на Windows;
- Создание сертификата «Let’s Encrypt» на Linux;
- Как получить TLS-сертификат безопасности на портале “Госуслуги”.
Если у вас сервер установлен в операционной системе с поддержкой графического интерфейса, то:
- Получите к ней физический доступ или доступ с помощью RDP, xRDP или VNC (конечно, он заранее должен был быть настроен).
- С помощью штатного браузера перейдите по адресу
localhost
. - На гостевой странице нажмите кнопку Вход для администратора.
- В настройках HTTPS загрузите корректный сертификат и его приватный ключ.
Нет доступа с localhost / ОС без GUI
В большинстве случаев служба безопасности компании требует закрыть беспарольный доступ к панели управления с localhost
. В таком случае, а также когда у вас установлен сервер в ОС без графического интерфейса, перейдите к инструкции ниже.
Для решения проблемы мы перенесём файлы на целевую машину с помощью SSH. Но перед этим задайте файлам правильные имена:
- сертификата — custom.crt
- ключ — custom.key
Перенос сертификатов с Windows на Windows
- Запустите PowerShell от имени администратора.
- Перейдите в папку с сертификатом и ключом:
1cd /targer-dir/ - Из-за особенностей интерпретации путей на Windows, для переноса файлов мы будем использовать SFTP, вместо SCP. Подключитесь к целевой машине:
1sftp admin@10.110.2.242 - Перейдите в папку с настройками HTTPS:
1cd 'C:/Program Files/TrueConf Server/httpconf/ssl/' - Выполните перенос двух файлов с помощью команды:
12put custom.crtput custom.key
Перенос сертификатов с Linux на Linux
- Запустите терминал.
- Перейдите в папку с сертификатом и ключом:
1cd /targer-dir/ - С помощью SCP перенесите сертификат и ключ на целевую машину в папку с настройками HTTPS:
1scp custom.crt custom.key admin@10.110.2.242:/opt/trueconf/server/etc/webmanager/ssl/ - Далее необходимо подключиться по SSH к целевой машине и задать перенесенным выше файлам права read и владельца trueconf с помощью команд:
12sudo chmod 400 /opt/trueconf/server/etc/webmanager/ssl/custom.crt /opt/trueconf/server/etc/webmanager/ssl/custom.keysudo chown trueconf /opt/trueconf/server/etc/webmanager/ssl/custom.crt /opt/trueconf/server/etc/webmanager/ssl/custom.key
Резервное решение проблемы
Если у вас нет нового сертификата, вам необходимо отключить использование HTTPS.
Windows
- Удалите файлы:
12C:\Program Files\TrueConf Server\httpconf\opt\listen.confC:\Program Files\TrueConf Server\httpconf\opt\config.ssl - Перезагрузите службу TrueConf Web Manager.
Linux
- Удалите файлы:
12/opt/trueconf/server/etc/webmanager/opt/listen.conf/opt/trueconf/server/etc/webmanager/opt/config.ssl - Перезагрузите службу trueconf-web.