Saltar al contenido principal

¿Cómo cambiar la versión Windows de ONLYOFFICE Docs Community Edition al protocolo HTTPS?

Introducción​

En la mayoría de los casos, el acceso a ONLYOFFICE Docs a través del protocolo HTTPS es mucho más seguro que el acceso a través del protocolo HTTP que se usa por defecto. Para cambiar el método de acceso a los editores, determinadas acciones deben ser realizadas. Por favor, siga los siguientes pasos para entender cómo cambiar su ONLYOFFICE Docs al protocolo HTTPS.

Cambio del ONLYOFFICE Docs v5.3 y versiones posteriores al protocolo HTTPS​

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

Cuando tenga el certificado, siga los siguientes pasos:

nota

Todos los comandos deben ser ejecutados con privilegios administrativos. Para iniciar la línea de comandos como administrador, haga clic derecho en el botón de menú Inicio en la esquina inferior izquierda del escritorio y seleccione la opción Command Prompt (Admin) (Línea de comandos (Administrador)).

  1. Suspenda el servicio ONLYOFFICE DocumentServer Proxy:

    net stop DsProxySvc

  2. Copie el archivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl en el 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 reemplazando todos los parámetros en llaves dobles {{...}} por los valores reales:

    nota

    Tenga en cuenta que el carácter barra invertida ( \ ) debe escaparse de una de las siguientes maneras: C:\\yourfolder\\certificates\\onlyoffice.key o C:/yourfolder/certificates/onlyoffice.key. Si existen espacios en la ruta, Usted necesita escribir toda la ruta entre comillas, por ejemplo: "C:/yourfolder/my certificates/onlyoffice.key".

    • {{SSL_CERTIFICATE_PATH}} - la ruta al certificado SSL que Usted ha recibido;
    • {{SSL_KEY_PATH}} - la ruta a la clave privada del certificado SSL;
    • {{SSL_VERIFY_CLIENT}} - el parámetro que define si está activada la verificación de certificados de clientes (los valores disponibles: on, off, optional y optional_no_ca);
    • {{CA_CERTIFICATES_PATH}} - la ruta al certificado de cliente que será verificado si la verificación está activada en el parámetro anterior;
    • {{ONLYOFFICE_HTTPS_HSTS_MAXAGE}} - la opción de configuración avanzada para establecer el parámetro max-age HSTS en la configuración del host virtual NGINX para el ONLYOFFICE Docs, y es aplicable únicamente cuando se usa SSL (normalmente por defecto se establece el valor 31536000 que se considera suficientemente seguro);
    • {{SSL_DHPARAM_PATH}} - la ruta al parámetro Diffie-Hellman;

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

  4. Una vez guardados todos los cambios, reinicie el servicio ONLYOFFICE DocumentServer Proxy:

    net start DsProxySvc
    nota

    Es necesario abrir el puerto 443 para un funcionamiento correcto de ONLYOFFICE Docs.

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

Cambio del ONLYOFFICE Docs v4.3–v5.2 al protocolo HTTPS​

nota

Estas instrucciones se aplican a versiones anteriores de ONLYOFFICE Docs (v4.3–v5.2). Le recomendamos actualizar a la última versión. Si no puede actualizar, siga estos pasos junto con las instrucciones principales anteriores, teniendo en cuenta que los pasos 2 y 3 son diferentes, como se describe a continuación.

  1. Copie el archivo %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template en el 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 reemplazando todos los parámetros en llaves dobles {{...}} por los valores reales, como se describe en el paso 3 anterior.