Saltar al contenido principal

Cambiar ONLYOFFICE Docs Enterprise Edition para Windows al protocolo HTTPS

Introducción​

En la mayoría de los casos, acceder a los editores a través del protocolo HTTPS es mucho más seguro que hacerlo mediante HTTP, que se utiliza por defecto. Pero para cambiar el método de acceso a los editores, se deben realizar ciertas acciones. Por favor, siga los pasos a continuación para saber cómo cambiar su ONLYOFFICE Docs al protocolo HTTPS.

Cambiar ONLYOFFICE Docs v5.3 y posteriores a HTTPS​

Antes de poder comenzar a cambiar su ONLYOFFICE Docs al protocolo HTTPS, necesitará crear un certificado de seguridad y la clave privada del certificado. Colóquelos en una carpeta en el ordenador donde está instalado ONLYOFFICE Docs.

Una vez que tenga el certificado, proceda con los siguientes pasos:

nota

Todos los comandos deben ejecutarse con privilegios administrativos. Para iniciar un símbolo del sistema como administrador, haga clic derecho en el botón del menú Inicio en la esquina inferior izquierda del escritorio y haga clic en la opción Command Prompt (Admin).

  1. Detenga el servicio ONLYOFFICE DocumentServer Proxy:

    net stop DsProxySvc

  2. Copie el archivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl al archivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf usando el siguiente comando:

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

  3. Edite el archivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf cambiando todos los parámetros entre dobles llaves {{...}} por los realmente utilizados:

    nota

    Tenga en cuenta que los caracteres de barra invertida ( \ ) deben escaparse de una de las siguientes maneras: C:\\yourfolder\\certificates\\onlyoffice.key o C:/yourfolder/certificates/onlyoffice.key. Si hay espacios en la ruta, debe ponerla entre comillas, por ejemplo: "C:/yourfolder/my certificates/onlyoffice.key".

    • {{SSL_CERTIFICATE_PATH}} - la ruta al certificado SSL que ha obtenido;
    • {{SSL_KEY_PATH}} - la ruta a la clave privada del certificado SSL;
    • {{SSL_VERIFY_CLIENT}} - si la verificación de los certificados de cliente está habilitada (con valores disponibles de on, off, optional y optional_no_ca);
    • {{CA_CERTIFICATES_PATH}} - la ruta al certificado del cliente, que se verificará si está habilitado con el parámetro anterior;
    • {{ONLYOFFICE_HTTPS_HSTS_MAXAGE}} - opción de configuración avanzada para establecer el HSTS max-age en la configuración del vHost de NGINX de ONLYOFFICE Docs, y aplicable solo cuando SSL está en uso (generalmente por defecto es 31536000, lo cual se considera suficientemente seguro);
    • {{SSL_DHPARAM_PATH}} - la ruta al parámetro Diffie-Hellman;

    Por favor, consulte la documentación de NGINX para más información sobre los parámetros SSL utilizados en el archivo de configuración.

  4. Cuando se hayan realizado todos los cambios, puede iniciar nuevamente el servicio ONLYOFFICE DocumentServer Proxy:

    net start DsProxySvc
    nota

    El puerto 443 debe estar abierto para el correcto funcionamiento del portal.

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

Cambiar ONLYOFFICE Docs v4.3–v5.2 a HTTPS​

Para cambiar ONLYOFFICE Docs v4.3/v5.2 a HTTPS, debe realizar todos los pasos anteriores, prestando atención a que el segundo y el tercer pasos se verán de manera diferente y deben ser así:

  1. Copie el archivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template al archivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf usando el siguiente 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 el archivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf cambiando todos los parámetros entre dobles llaves {{...}} por los realmente utilizados...