Pular para o conteúdo principal

Alternando ONLYOFFICE Docs para Windows para protocolo HTTPS

Introdução​

Na maioria dos casos, acessar o ONLYOFFICE Docs via protocolo HTTPS é muito mais seguro do que via HTTP, que é usado por padrão. 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:

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

  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, substituindo todos os parâmetros em chaves duplas {{...}} pelos valores reais:

    observação

    Observe que os caracteres de barra invertida ( \ ) devem ser escapados de uma das seguintes maneiras: C:\\yourfolder\\certificates\\onlyoffice.key ou C:/yourfolder/certificates/onlyoffice.key. Se houver espaços no caminho, você precisa colocá-lo entre aspas, por exemplo: "C:/yourfolder/my certificates/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, considerado suficientemente seguro);
    • {{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 salvas, reinicie o serviço ONLYOFFICE DocumentServer Proxy:

    net start DsProxySvc
    observação

    A porta 443 deve estar aberta para o funcionamento correto do ONLYOFFICE Docs.

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

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

observação

Estas instruções se aplicam a versões mais antigas do ONLYOFFICE Docs (v4.3–v5.2). Recomendamos atualizar para a versão mais recente. Se não for possível atualizar, siga estas etapas junto com as instruções principais acima, observando que as etapas 2 e 3 são diferentes, conforme descrito abaixo.

  1. 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"

  2. Edite o arquivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf, substituindo todos os parâmetros em chaves duplas {{...}} pelos valores reais, conforme descrito na etapa 3 acima.