Saltar al contenido principal

Cambio de ONLYOFFICE Workspace Community al protocolo HTTPS

Introducción​

En la mayoría de los casos, acceder al portal mediante el protocolo HTTPS es mucho más seguro que mediante HTTP, que es el que se usa de forma predeterminada. Sin embargo, para cambiar el método de acceso al portal es necesario realizar ciertas acciones. Sigue los pasos a continuación para saber cómo cambiar tu ONLYOFFICE Workspace a HTTPS.

Creación de un certificado de seguridad y una clave privada​

Antes de poder empezar a cambiar tu ONLYOFFICE Workspace Community a HTTPS, tendrás que crear un certificado de seguridad y la clave privada del certificado.

Para generar automáticamente un certificado SSL mediante el servicio letsencrypt, consulta este artículo.

Una vez que tengas el certificado, continúa con los pasos siguientes.

Cambio de ONLYOFFICE Workspace Community a HTTPS mediante el script​

La forma más rápida de cambiar ONLYOFFICE Workspace Community a HTTPS es usar el script. Se encuentra aquí:

/var/www/onlyoffice/Tools/default-onlyoffice-ssl.sh

Coloca los certificados creados en el directorio /var/www/onlyoffice/Data/certs/. Debe haber dos archivos allí:

  • /var/www/onlyoffice/Data/certs/onlyoffice.crt
  • /var/www/onlyoffice/Data/certs/onlyoffice.key

Luego ejecuta el script:

sudo bash /var/www/onlyoffice/Tools/default-onlyoffice-ssl.sh

Hará todo lo necesario para cambiar tu instalación de ONLYOFFICE Workspace Community a HTTPS.

Cambio manual de ONLYOFFICE Workspace Community a HTTPS​

Puedes realizar manualmente todas las acciones del script. Para ello, sigue los pasos a continuación:

  1. Detén el servicio NGINX:

    sudo service nginx stop

  2. Copia el archivo /etc/nginx/includes/onlyoffice-communityserver-common-ssl.conf.template en el archivo /etc/nginx/sites-available/onlyoffice para sistemas basados en Debian o en /etc/nginx/conf.d/onlyoffice.conf para sistemas basados en RPM.

    Usa el siguiente comando para sistemas basados en Debian:

    sudo cp -f /etc/nginx/includes/onlyoffice-communityserver-common-ssl.conf.template /etc/nginx/sites-available/onlyoffice

    Usa el siguiente comando para sistemas basados en RPM:

    sudo cp -f /etc/nginx/includes/onlyoffice-communityserver-common-ssl.conf.template /etc/nginx/conf.d/onlyoffice.conf

  3. Edita el archivo /etc/nginx/sites-available/onlyoffice para sistemas basados en Debian o el archivo /etc/nginx/conf.d/onlyoffice.conf para sistemas basados en RPM. Cambia todos los parámetros entre llaves dobles {{...}} por los valores realmente utilizados:

    • {{SSL_CERTIFICATE_PATH}}: la ruta al certificado SSL que tienes;
    • {{SSL_KEY_PATH}}: la ruta a la clave privada del certificado SSL;
    • {{SSL_VERIFY_CLIENT}}: si la verificación de certificados de cliente está habilitada (con los valores disponibles on, off, optional y optional_no_ca);
    • {{CA_CERTIFICATES_PATH}}: la ruta al certificado de cliente, que se verificará si se habilita con el parámetro anterior;
    • {{ONLYOFFICE_HTTPS_HSTS_MAXAGE}}: una opción de configuración avanzada para establecer el max-age de HSTS en la configuración del vHost de NGINX de ONLYOFFICE Workspace Community, aplicable solo cuando se usa SSL (normalmente el valor predeterminado es 31536000, que se considera suficientemente seguro);
    • {{SSL_DHPARAM_PATH}}: la ruta al parámetro Diffie-Hellman;
    • {{ONLYOFFICE_NGINX_KEEPLIVE}}: el número máximo de conexiones keep-alive inactivas con los servidores upstream que se conservan en la caché de cada proceso de trabajo (para más información sobre este parámetro, consulta la documentación de NGINX);
    • {{DOCKER_ONLYOFFICE_SUBNET}}: el valor de la subred interna de Docker (si ONLYOFFICE Workspace Community está instalado con Docker);
    • {{SSL_OCSP_CERTIFICATE_PATH}}: la ruta a un archivo con certificados de CA de confianza en formato PEM, utilizado para verificar los certificados de cliente y las respuestas OCSP (Online Certificate Status Protocol) si ssl_stapling está habilitado.

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

  4. Abre el archivo de configuración /var/www/onlyoffice/Services/MailAggregator/ASC.Mail.Aggregator.CollectionService.exe.config y establece el valor del parámetro mail.default-api-scheme en https. Después, reinicia el servicio del agregador de correo:

    onlyofficeMailAggregator restart

  5. Cambia Talk al protocolo TLS.

  6. Cuando se hayan realizado todos los cambios, puedes iniciar de nuevo el servicio NGINX:

    sudo service nginx start
    nota

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