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

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

Введение​

В большинстве случаев доступ к ONLYOFFICE Docs по протоколу 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
    примечание

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

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

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

примечание

Эти инструкции относятся к старым версиям ONLYOFFICE Docs (v4.3–v5.2). Мы рекомендуем обновиться до последней версии. Если это невозможно, выполните все приведенные выше действия, обратив внимание на то, что второй и третий шаги отличаются и описаны ниже.

  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, заменив все параметры в двойных фигурных скобках {{...}} на фактически используемые значения, как описано в шаге 3 выше.