Сертификат HTTPS

Установка TLS-сертификата веб-интерфейса через Nginx

bg-dots
bg-dots

На Vinteo Server 40.x во веб-интерфейсе нет вкладки SSL. Сертификат HTTPS для веб-сервера задаётся файлами, на которые ссылается Nginx.

По умолчанию в /etc/nginx/conf.d/vinteo.conf указаны пути:

ssl_certificate     "/etc/ssl/certs/vcs-web.crt";
ssl_certificate_key "/etc/ssl/private/vcs-web.key";

Те же пути используются в /etc/nginx/conf.d/localhost.conf. Если пути переопределены, сверьте актуальные значения директив ssl_certificate и ssl_certificate_key в конфигурации Nginx.

Внимание!
Выполняйте замену от root. Перед изменением сохраните копии текущих файлов сертификата и ключа.

Подготовка файлов

Необходимы два файла в формате PEM:

  • vcs-web.crt — сертификат сервера и промежуточные УЦ в одном файле;
  • vcs-web.key — закрытый ключ сервера.

Корневой УЦ публичных центров (Let’s Encrypt, GlobalSign) в vcs-web.crt обычно не включают: достаточно сервера и промежуточных УЦ. Для сертификатов НУЦ Минцифры (DV/OV через Госуслуги) на сервере действует та же схема файлов; доверие корня в браузерах клиентов может отличаться (Яндекс.Браузер и др. vs Chrome / Firefox / Safari без установленного корня Минцифры).

Сборка vcs-web.crt из отдельных файлов

УЦ часто выдаёт несколько PEM-файлов. Их нужно объединить в один vcs-web.crt в таком порядке:

  1. сертификат сервера (для вашего домена / FQDN);
  2. промежуточный УЦ (если файлов несколько — в порядке от ближайшего к серверу к вышестоящему);
  3. корневой УЦ — только если поддержка или документация УЦ явно требует его в цепочке для Nginx.

Пример: есть server.crt, один промежуточный intermediate.crt и ключ server.key.

cat server.crt intermediate.crt > vcs-web.crt
cp server.key vcs-web.key

Если промежуточных УЦ два:

cat server.crt intermediate1.crt intermediate2.crt > vcs-web.crt

Для Let’s Encrypt готовая цепочка уже лежит в fullchain.pem — её можно сразу копировать в vcs-web.crt, ключ — из privkey.pem:

cp fullchain.pem vcs-web.crt
cp privkey.pem vcs-web.key

В каждом PEM-блоке должны сохраниться строки -----BEGIN CERTIFICATE----- / -----END CERTIFICATE----- (для ключа — BEGIN / END соответствующего типа ключа). Порядок важен: первым всегда идёт сертификат сервера.

Проверка числа сертификатов в собранном файле:

grep -c "BEGIN CERTIFICATE" vcs-web.crt

Замена сертификата

Шаг 1. Сохраните резервные копии:

cp -a /etc/ssl/certs/vcs-web.crt /etc/ssl/certs/vcs-web.crt.bak
cp -a /etc/ssl/private/vcs-web.key /etc/ssl/private/vcs-web.key.bak

Шаг 2. Скопируйте собранные файлы на места, указанные в Nginx:

cp ./vcs-web.crt /etc/ssl/certs/vcs-web.crt
cp ./vcs-web.key /etc/ssl/private/vcs-web.key
chmod 644 /etc/ssl/certs/vcs-web.crt
chmod 600 /etc/ssl/private/vcs-web.key
chown root:root /etc/ssl/certs/vcs-web.crt /etc/ssl/private/vcs-web.key

Шаг 3. Проверьте конфигурацию и перезагрузите Nginx:

nginx -t
systemctl reload nginx

Команда nginx -t должна завершиться без ошибок. При ошибке не оставляйте нерабочие файлы — верните копии из .bak и снова выполните nginx -t и systemctl reload nginx.

Шаг 4. Откройте веб-интерфейс по HTTPS и убедитесь, что браузер принимает сертификат и вход в систему выполняется.

Откат

cp -a /etc/ssl/certs/vcs-web.crt.bak /etc/ssl/certs/vcs-web.crt
cp -a /etc/ssl/private/vcs-web.key.bak /etc/ssl/private/vcs-web.key
nginx -t
systemctl reload nginx

При необходимости согласуйте выпуск и состав цепочки сертификата с технической поддержкой (support@vinteo.ru).

Установка на открытый дистрибутив Лицензирование