Pular para o conteúdo principal

Configurar o protocolo HTTPS no ONLYOFFICE Docs para Windows

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 precisam ser realizadas. Siga as etapas abaixo para saber como migrar o seu ONLYOFFICE Docs para o protocolo HTTPS.

Configuração para a versão 5.3 e posteriores​

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

Depois de obter o certificado, prossiga com as etapas abaixo:

observação

Todos os comandos devem ser executados com privilégios de Administrador do sistema. Para iniciar um prompt de comando como administrador, clique com o botão direito do mouse 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 e altere os campos delimitados por chaves duplas {{...}} pelos valores realmente utilizados:

    observação

    Observe que as barras invertidas ( \ ) devem ser escapadas de uma das seguintes formas: C:\\yourfolder\\certificates\\onlyoffice.key ou C:/yourfolder/certificates/onlyoffice.key. Se houver espaços no caminho, coloque-o inteiro entre aspas, por exemplo: "C:/yourfolder/my certificates/onlyoffice.key".

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

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

  4. Quando todas as alterações forem feitas, inicie novamente o serviço ONLYOFFICE DocumentServer Proxy:

    net start DsProxySvc
    observação

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

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

Configuração para as versões legadas (v4.3 a v5.2)​

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

  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 e altere os campos delimitados por chaves duplas {{...}} pelos valores realmente utilizados...