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

Переход на HTTPS в ONLYOFFICE Workspace Community для Windows

Введение​

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

Прежде чем переводить ONLYOFFICE Workspace Community на HTTPS, необходимо создать сертификат безопасности в формате .pem.

примечание

Убедитесь, что сертификат содержит закрытый ключ. Наличие закрытого ключа можно проверить, открыв сертификат в любом текстовом редакторе.

Когда сертификат будет готов, выполните действия, описанные ниже, чтобы перевести ONLYOFFICE Workspace Community на HTTPS.

Переход ONLYOFFICE Workspace Community на HTTPS с помощью скрипта​

Самый быстрый способ перевести ONLYOFFICE Workspace Community на HTTPS — использовать скрипт. О том, как это сделать, читайте в этой статье.

Переход ONLYOFFICE Community Server версии 8.5 и более поздних на HTTPS вручную​

Все действия скрипта можно выполнить вручную. Для этого следуйте инструкциям ниже.

Версия 8.5 использует IIS 7, у которого есть свои особенности. Вам потребуется привязать сертификат безопасности к ONLYOFFICE Community Server с помощью встроенных средств IIS.

Если у вас есть сертификат безопасности (самоподписанный или выданный третьей стороной), вы можете привязать его к ONLYOFFICE Community Server:

  1. Откройте Internet Information Services (IIS) Manager.
  2. Выберите сайт, к которому нужно привязать сертификат (портал ONLYOFFICE).
  3. Используйте опцию Bindings... в меню справа, чтобы открыть диалоговое окно Site Bindings.
  4. В открывшемся окне нажмите Add....
  5. Измените тип на https и выберите ранее созданный сертификат в выпадающем меню SSL certificate.
  6. Нажмите OK, а затем закройте окно Site Bindings.

После этого ваш сертификат будет привязан к ONLYOFFICE Community Server. Если у вас остались вопросы о сертификатах в IIS 7, обратитесь к соответствующим статьям базы знаний Microsoft.

примечание

Если у вас нет сертификата, его можно создать с помощью Internet Information Services (IIS) Manager:

  1. Откройте Internet Information Services (IIS) Manager.
  2. Перейдите к имени сервера и выберите его.
  3. Дважды щелкните опцию Service Certificates в разделе IIS.
  4. Используйте опцию Create Self-Signed Certificate в меню справа, чтобы открыть соответствующее диалоговое окно.
  5. Введите нужное имя сертификата и нажмите OK.

Теперь у вас есть самоподписанный сертификат со сроком действия один год.

Теперь необходимо включить правила перезаписи для вашего сервера, чтобы он обрабатывал запросы HTTPS вместо HTTP. Для этого:

  1. Откройте Internet Information Services (IIS) Manager.
  2. Выберите сайт, для которого нужно включить HTTPS.
  3. Используйте опцию URL Rewrite в меню справа, чтобы открыть окно URL Rewrite.
  4. Найдите следующие правила: HTTP to HTTPS и Add Strict-Transport-Security when HTTPS и выберите Enable Rule для каждого из них на панели справа.

Следующие шаги не являются обязательными, но если вы хотите защитить свою установку ONLYOFFICE Community Server, мы настоятельно рекомендуем их выполнить. Перейдите на веб-страницу IIS Crypto. Это бесплатный инструмент, который позволяет администраторам включать или отключать протоколы, шифры, хэши и алгоритмы обмена ключами в Windows Server 2008, 2012 и 2016. Он также позволяет изменять порядок наборов шифров SSL/TLS, предлагаемых IIS, применять рекомендуемые настройки одним щелчком мыши, создавать пользовательские шаблоны и тестировать ваш сайт. Скачайте и запустите его, выберите Best Practices, а затем Apply. После этого перезагрузите сервер.

Теперь можно проверить, все ли сделано правильно, следующим образом:

  • Откройте портал с префиксом https://. Если он открывается и работает, значит, все сделано правильно.
  • Если ваш ONLYOFFICE Community Server доступен через интернет, вы можете проверить его безопасность на сайте SSL Server Test. Введите имя вашего домена в поле Hostname и нажмите Submit. Дождитесь результатов. Ваш рейтинг безопасности должен быть не ниже A.

Переход ONLYOFFICE Community Server версии 7.7.1 и более поздних на HTTPS (до версии 8.5)​

  1. Создайте папку ssl_cert в каталоге c:\Program Files\Ascensio System SIA\ONLYOFFICE\Router\.

  2. Скопируйте сертификат в формате .pem в эту только что созданную папку.

  3. Перезапустите службу ONLYOFFICE Router.

    примечание

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

  4. Найдите и откройте файл Web.config в папке WebStudio (для сохранения изменений вам потребуются права администратора) и найдите в нем следующий раздел:

    <rewrite>
        <rules>
            ...
        </rules>
    </rewrite>

    Замените все содержимое этого раздела (обозначенное выше как «...») следующими правилами:

    <rule name="HTTP to HTTPS" stopProcessing="true">
        <match url=".*" />
        <conditions>
            <add input="{HTTPS}" pattern="off" />
            <add input="{REQUEST_URI}" pattern="^/api/2.0/" negate="true" />
            <add input="{REQUEST_URI}" pattern="products/files/services/wcfservice/service.svc.*" negate="true" />
        </conditions>
        <action type="Redirect" url="https://{HTTP_HOST}/{R:0}" appendQueryString="true" redirectType="Temporary" />
    </rule>
    <rule name="WCF files HTTPS to HTTP" stopProcessing="true">
        <match url="products/files/services/wcfservice/service.svc.*" />
        <conditions>
            <add input="{HTTPS}" pattern="on" />
        </conditions>
        <action type="Rewrite" url="http://{HTTP_HOST}/{R:0}" appendQueryString="true" />
    </rule>

Переход более старых версий ONLYOFFICE Community Server на HTTPS (до версии 7.7.1)​

Для перехода более старых версий ONLYOFFICE Community Server на HTTPS необходимо выполнить следующие действия:

  1. Поместите сертификат в формате .pem с закрытым ключом в папку на компьютере, на котором установлен ONLYOFFICE Community Server.

  2. Перейдите в папку c:\Program Files\Ascensio System SIA\ONLYOFFICE\Router\ и откройте файл config.js в текстовом редакторе. Для сохранения изменений необходимы права администратора.

  3. Найдите следующую строку:

    config.sslCertPath = '../Cert/https-cert.pem';

    Замените ../Cert/https-cert.pem на путь, по которому вы поместили сертификат.

    примечание

    Обратите внимание: необходимо указать абсолютный путь к файлу сертификата (например, C:/Cert/mycertificate.pem), причем в пути необходимо использовать прямые косые черты (не обратные), как показано в примере.

  4. Перезапустите службу ONLYOFFICE Router.

    примечание

    Соответствующие порты должны быть открыты, а node.js должен быть добавлен в исключения брандмауэра или в разрешающие правила.

Возможно, также потребуется заменить sslCertPath на sslCert в строке параметра config.sslCertPath.