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

Переключение ONLYOFFICE Docs Enterprise Edition для Windows на протокол HTTPS

Введение​

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

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

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

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

примечание

Все команды должны выполняться от имени администратора. Чтобы запустить командную строку от имени администратора, щелкните правой кнопкой мыши по кнопке меню Пуск в левом нижнем углу рабочего стола и выберите пункт Командная строка (администратор).

  1. Остановите сервис ONLYOFFICE DocumentServer Proxy:

    net stop DsProxySvc

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

    COPY /Y "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl" "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf"

  3. Отредактируйте файл %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf, заменив все параметры в двойных фигурных скобках {{...}} на фактически используемые:

    примечание

    Обратите внимание, что обратный слэш ( \ ) надо экранировать одним из следующих способов: C:\\yourfolder\\certificates\\onlyoffice.key или C:/yourfolder/certificates/onlyoffice.key. Если в пути есть пробелы, весь путь нужно взять в кавычки, например: "C:/yourfolder/my certificates/onlyoffice.key".

    • {{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. Когда все изменения будут внесены, можно снова запустить сервис ONLYOFFICE DocumentServer Proxy:

    net start DsProxySvc
    примечание

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

  5. Запустите %ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-update-securelink.bat

Переключение ONLYOFFICE Docs версии v4.3–v5.2 на HTTPS​

Для того чтобы переключить ONLYOFFICE Docs версии v4.3/v5.2 на HTTPS, необходимо выполнить все приведенные выше действия, обратив внимание на то, что второй и третий шаги будут отличаться и должны быть следующими:

  1. Скопируйте файл %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template в файл %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf с помощью следующей команды:

    COPY /Y "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template" "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf"

  2. Отредактируйте файл %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf, заменив все параметры в двойных фигурных скобках {{...}} на фактически используемые...