Справочный центр

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

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

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

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

Ubuntu CentOS

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

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

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

sudo yum install snapd
sudo systemctl enable --now snapd.socket
sudo ln -s /var/lib/snapd/snap /snap
sudo snap install core
sudo snap refresh core
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 версии v5.3 и более поздних версий на HTTPS

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

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

Остановите сервис NGINX:
```
sudo service nginx stop
```
Скопируйте файл ds-ssl.conf.tmpl в файл ds.conf с помощью следующей команды:
```
sudo cp -f /etc/onlyoffice/documentserver/nginx/ds-ssl.conf.tmpl /etc/onlyoffice/documentserver/nginx/ds.conf
```
Отредактируйте файл /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, которые используются в файле конфигурации.
Когда все изменения будут внесены, можно снова запустить сервис NGINX:
```
sudo service nginx start
```
Для правильной работы портала должен быть открыт порт 443.

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

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

Переключение ONLYOFFICE Docs версии 5.2 на HTTPS

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

...
Скопируйте файл onlyoffice-documentserver-ssl.conf.template в файл onlyoffice-documentserver.conf с помощью следующей команды:
```
sudo cp -f /etc/onlyoffice/documentserver/nginx/onlyoffice-documentserver-ssl.conf.template /etc/onlyoffice/documentserver/nginx/onlyoffice-documentserver.conf
```
Отредактируйте файл /etc/onlyoffice/documentserver/nginx/onlyoffice-documentserver.conf, заменив все параметры в двойных фигурных скобках {{...}} на фактически используемые...
...

Переключение ONLYOFFICE Docs версий 4.3–5.1 на HTTPS

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

...
Скопируйте файл onlyoffice-documentserver-ssl.conf.template в файл onlyoffice-documentserver.conf с помощью следующей команды:
```
sudo cp -f /etc/onlyoffice/documentserver/nginx/onlyoffice-documentserver-ssl.conf.template /etc/nginx/conf.d/onlyoffice-documentserver.conf
```
Отредактируйте файл /etc/nginx/conf.d/onlyoffice-documentserver.conf, заменив все параметры в двойных фигурных скобках {{...}} на фактически используемые...
...

Переключение ONLYOFFICE Docs версий 3.6–4.2 на HTTPS

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

Откройте файл конфигурации /etc/nginx/conf.d/onlyoffice-documentserver.conf и удалите все его содержимое. Скопируйте содержимое файла конфигурации SSL в файл /etc/nginx/conf.d/onlyoffice-documentserver.conf.

Показать содержимое файла конфигурации SSL

include /etc/nginx/includes/onlyoffice-http.conf;
## Normal HTTP host
server {
  listen 0.0.0.0:80;
  listen [::]:80 default_server;
  server_name _;
  server_tokens off;
  ## Redirects all traffic to the HTTPS host
  root /nowhere; ## root doesn't have to be a valid path since we are redirecting
  rewrite ^ https://$host$request_uri? permanent;
}
#HTTP host for internal services
server {
  listen 127.0.0.1:80;
  listen [::1]:80;
  server_name localhost;
  server_tokens off;
  include /etc/nginx/includes/onlyoffice-documentserver-common.conf;
  include /etc/nginx/includes/onlyoffice-documentserver-docservice.conf;
}
## HTTPS host
server {
  listen 0.0.0.0:443 ssl;
  listen [::]:443 ssl default_server;
  server_tokens off;
  root /usr/share/nginx/html;
  ## Strong SSL Security
  ## https://raymii.org/s/tutorials/Strong_SSL_Security_On_nginx.html
  ssl on;
  ssl_certificate {{SSL_CERTIFICATE_PATH}};
  ssl_certificate_key {{SSL_KEY_PATH}};
  ssl_verify_client {{SSL_VERIFY_CLIENT}};
  ssl_client_certificate {{CA_CERTIFICATES_PATH}};
  ssl_ciphers "ECDHE-RSA-AES128-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA128:DHE-RSA-AES128-GCM-SHA384:DHE-RSA-AES128-GCM-SHA128:ECDHE-RSA-AES128-SHA384:ECDHE-RSA-AES128-SHA128:ECDHE-RSA-AES128-SHA:ECDHE-RSA-AES128-SHA:DHE-RSA-AES128-SHA128:DHE-RSA-AES128-SHA128:DHE-RSA-AES128-SHA:DHE-RSA-AES128-SHA:ECDHE-RSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:AES128-GCM-SHA384:AES128-GCM-SHA128:AES128-SHA128:AES128-SHA128:AES128-SHA:AES128-SHA:DES-CBC3-SHA:HIGH:!aNULL:!eNULL:!EXPORT:!DES:!MD5:!PSK:!RC4";
  ssl_protocols  TLSv1 TLSv1.1 TLSv1.2;
  ssl_session_cache  builtin:1000  shared:SSL:10m;
  ssl_prefer_server_ciphers   on;
  add_header Strict-Transport-Security max-age={{ONLYOFFICE_HTTPS_HSTS_MAXAGE}};
  # add_header X-Frame-Options SAMEORIGIN;
  add_header X-Content-Type-Options nosniff;
  ## [Optional] If your certficate has OCSP, enable OCSP stapling to reduce the overhead and latency of running SSL.
  ## Replace with your ssl_trusted_certificate. For more info see:
  ## - https://medium.com/devops-programming/4445f4862461
  ## - https://www.ruby-forum.com/topic/4419319
  ## - https://www.digitalocean.com/community/tutorials/how-to-configure-ocsp-stapling-on-apache-and-nginx
  # ssl_stapling on;
  # ssl_stapling_verify on;
  # ssl_trusted_certificate /etc/nginx/ssl/stapling.trusted.crt;
  # resolver 208.67.222.222 208.67.222.220 valid=300s; # Can change to your DNS resolver if desired
  # resolver_timeout 10s;
  ## [Optional] Generate a stronger DHE parameter:
  ##   cd /etc/ssl/certs
  ##   sudo openssl dhparam -out dhparam.pem 4096
  ##
  ssl_dhparam {{SSL_DHPARAM_PATH}};
  include /etc/nginx/includes/onlyoffice-documentserver-*.conf;
}

Актуальный файл конфигурации всегда доступен по этой ссылке.

Переключение ONLYOFFICE Docs версии 3.5 и более ранних версий на HTTPS

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

...
Откройте файл конфигурации /etc/nginx/sites-available/onlyoffice-documentserver и удалите все его содержимое. Перейдите по ссылке https://raw.githubusercontent.com/ONLYOFFICE/Docker-DocumentServer/v3.6/config/nginx/onlyoffice-ssl и скопируйте содержимое файла конфигурации SSL в файл /etc/nginx/sites-available/onlyoffice-documentserver.
Отредактируйте файл конфигурации /etc/nginx/sites-available/onlyoffice-documentserver, заменив все параметры в двойных фигурных скобках {{...}} на фактически используемые, как описано в приведенных выше инструкциях.
...

Переключение ONLYOFFICE Groups на HTTPS

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

Скачать Разместите на собственном сервере Доступно для
Docker, Windows и Linux

Вас также может заинтересовать:

Закрыть

Статьи с тэгом :

История изменений

Справочный центр

ONLYOFFICE Docs Community Edition для Linux

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

Введение