Перейти к основному содержимому

Переключение ONLYOFFICE Docs на протокол HTTPS

Введение​

В большинстве случаев доступ к ONLYOFFICE Docs по протоколу HTTPS намного безопаснее, чем по протоколу HTTP, который используется по умолчанию. Но для изменения способа доступа к редакторам необходимо выполнить определенные действия. Прочитайте следующие инструкции, чтобы узнать, как переключить ONLYOFFICE Docs на протокол HTTPS.

Переключение ONLYOFFICE Docs на протокол HTTPS с помощью certbot​

Проще всего переключить ONLYOFFICE Docs на протокол HTTPS, автоматически получив SSL-сертификаты от Let's Encrypt с помощью certbot.

Установите certbot. Этот процесс различается в зависимости от операционной системы — на базе DEB или RPM. Выберите соответствующую вкладку с инструкциями для вашей ОС:

Например, на Ubuntu 20 это можно сделать с помощью следующих команд:

sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot

Когда certbot будет установлен на компьютере, запустите скрипт, указав ваш адрес электронной почты и домен:

sudo bash /usr/bin/documentserver-letsencrypt.sh email@example.com yourdomain.com

Скрипт автоматически создаст и установит на ваш сервер сертификат, подписанный центром сертификации letsencrypt.org, а также перезапустит сервис NGINX, чтобы изменения вступили в силу.

Теперь ONLYOFFICE Docs должен быть доступен по адресу https://yourdomain.com.

Переключение ONLYOFFICE Docs версии 5.3 и более поздних версий на HTTPS​

Прежде чем начинать переключение ONLYOFFICE Docs на протокол HTTPS, необходимо создать сертификат безопасности и закрытый ключ сертификата. Положите их в папку на компьютере, где установлен ONLYOFFICE Docs.

Когда у вас будет сертификат, переходите к последующим действиям:

  1. Остановите сервис NGINX:

    sudo service nginx stop

  2. Скопируйте файл ds-ssl.conf.tmpl в файл ds.conf с помощью следующей команды:

    sudo cp -f /etc/onlyoffice/documentserver/nginx/ds-ssl.conf.tmpl /etc/onlyoffice/documentserver/nginx/ds.conf

  3. Отредактируйте файл /etc/onlyoffice/documentserver/nginx/ds.conf, заменив все параметры в двойных фигурных скобках {{...}} на фактически используемые:

    • {{SSL_CERTIFICATE_PATH}} — путь к вашему сертификату SSL;
    • {{SSL_KEY_PATH}} — путь к закрытому ключу сертификата SSL;
    • {{SSL_VERIFY_CLIENT}} — параметр, определяющий, включена ли проверка клиентских сертификатов (допустимые значения: on, off, optional и optional_no_ca);
    • {{CA_CERTIFICATES_PATH}} — путь к клиентскому сертификату, который будет проверяться, если проверка включена в предыдущем параметре;
    • {{ONLYOFFICE_HTTPS_HSTS_MAXAGE}} — дополнительный параметр настройки для задания параметра max-age HSTS в конфигурации виртуального хоста NGINX для ONLYOFFICE Docs, применяется только в тех случаях, когда используется SSL (как правило, по умолчанию задается значение 31536000, что считается достаточно безопасным);
    • {{SSL_DHPARAM_PATH}} — путь к параметру Диффи-Хеллмана;

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

  4. Когда все изменения будут внесены, можно снова запустить сервис NGINX:

    sudo service nginx start
    примечание

    Для правильной работы портала должен быть открыт порт 443.

  5. Запустите следующий скрипт:

    sudo bash /usr/bin/documentserver-update-securelink.sh