Alternando o ONLYOFFICE Docs Enterprise Edition para Windows para o protocolo HTTPS

Introdução

Na maioria dos casos, acessar os editores via protocolo HTTPS é muito mais seguro do que via HTTP, que é usado por padrão. Mas para alterar o método de acesso aos editores, certas ações devem ser executadas. Siga as etapas abaixo para descobrir como alternar seu ONLYOFFICE Docs para o protocolo HTTPS.

Alternando o ONLYOFFICE Docs v5.3 e posterior para HTTPS

Antes de começar a alternar seu ONLYOFFICE Docs para o protocolo HTTPS, você precisará criar um certificado de segurança e a chave privada do certificado. Coloque-os em uma pasta no computador onde o ONLYOFFICE Docs está instalado.

Assim que tiver o certificado, prossiga com as etapas abaixo:

observação

Todos os comandos devem ser executados com privilégios administrativos. Para iniciar um prompt de comando como administrador, clique com o botão direito no botão do menu Iniciar no canto inferior esquerdo da área de trabalho e clique na opção Prompt de Comando (Admin).

1. Pare o serviço ONLYOFFICE DocumentServer Proxy:

   net stop DsProxySvc

2. Copie o arquivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl para o arquivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf usando o seguinte comando:

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

3. Edite o arquivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf alterando todos os parâmetros entre chaves duplas {{...}} pelos valores realmente usados:

   observação

   Observe que os caracteres de barra invertida ( \ ) devem ser escapados de uma das seguintes maneiras: C:\\suapasta\\certificados\\onlyoffice.key ou C:/suapasta/certificados/onlyoffice.key. Se houver espaços no caminho, você precisa colocá-lo todo entre aspas, por exemplo: "C:/suapasta/meus certificados/onlyoffice.key".

   • {{SSL_CERTIFICATE_PATH}} - o caminho para o certificado SSL que você obteve;
   • {{SSL_KEY_PATH}} - o caminho para a chave privada do certificado SSL;
   • {{SSL_VERIFY_CLIENT}} - se a verificação de certificados de cliente está habilitada (com valores disponíveis de on, off, optional e optional_no_ca);
   • {{CA_CERTIFICATES_PATH}} - o caminho para o certificado do cliente, que será verificado se habilitado com o parâmetro anterior;
   • {{ONLYOFFICE_HTTPS_HSTS_MAXAGE}} - opção de configuração avançada para definir o max-age HSTS na configuração vHost NGINX do ONLYOFFICE Docs, aplicável somente quando o SSL está em uso (geralmente o padrão é 31536000, o que é considerado seguro o suficiente);
   • {{SSL_DHPARAM_PATH}} - o caminho para o parâmetro Diffie-Hellman;

   Consulte a documentação do NGINX para mais informações sobre os parâmetros SSL usados no arquivo de configuração.

4. Quando todas as alterações forem feitas, você pode iniciar o serviço ONLYOFFICE DocumentServer Proxy novamente:

   net start DsProxySvc

   observação

   A porta 443 deve estar aberta para a operação correta do portal.

5. Execute %ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-update-securelink.bat

Alternando o ONLYOFFICE Docs v4.3–v5.2 para HTTPS

Para alternar o ONLYOFFICE Docs v4.3/v5.2 para HTTPS, você precisa executar todas as etapas acima, observando que a segunda e a terceira etapas serão diferentes e devem ficar assim:

2. Copie o arquivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template para o arquivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf usando o seguinte comando:

   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"

3. Edite o arquivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf alterando todos os parâmetros entre chaves duplas {{...}} pelos valores realmente usados...