Home
Alternando ONLYOFFICE Docs para Windows para protocolo HTTPS

Alternando ONLYOFFICE Docs para Windows para 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 dos editores, certas ações devem ser realizadas. Siga as etapas abaixo para descobrir como mudar seu ONLYOFFICE Docs para o protocolo HTTPS.

Mudando ONLYOFFICE Docs v5.3 e posterior para HTTPS

Antes de começar a mudar 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 você tiver o certificado, prossiga com as etapas abaixo:

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 (Administrador).

Pare o serviço ONLYOFFICE DocumentServer Proxy:
```
net stop DsProxySvc
```
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"
```
Edite o arquivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf alterando todos os parâmetros em chaves duplas {{...}} para os realmente usados:
Observe que os caracteres de barra invertida ( \ ) devem ser escapados de uma das seguintes maneiras: С:\\suapasta\\certificados\\onlyoffice.key ou С:/suapasta/certificados/onlyoffice.key. Se houver espaços no caminho, você precisa colocar tudo entre aspas, por exemplo: "С:/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 do HSTS na configuração vHost NGINX do ONLYOFFICE Docs, e aplicável apenas quando SSL está em uso (geralmente o padrão é 31536000, 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.
Quando todas as alterações forem feitas, você pode iniciar o serviço ONLYOFFICE DocumentServer Proxy novamente:
```
net start DsProxySvc
```
A porta 443 deve estar aberta para o funcionamento correto do portal.
Execute %ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-update-securelink.bat

Mudando ONLYOFFICE Docs v4.3–v5.2 para HTTPS

Para mudar o ONLYOFFICE Docs v4.3/v5.2 para HTTPS, você precisa realizar todas as etapas acima, prestando atenção que a segunda e a terceira etapas serão diferentes e devem ser assim:

...
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"
```
Edite o arquivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf alterando todos os parâmetros em chaves duplas {{...}} para os realmente usados...
...