Pular para o conteúdo principal

Mudando ONLYOFFICE Workspace Community para o protocolo HTTPS

Introdução​

Na maioria dos casos, acessar o portal pelo protocolo HTTPS é muito mais seguro do que pelo HTTP, que é usado por padrão. No entanto, para alterar o método de acesso ao portal, é necessário executar certas ações. Siga as etapas abaixo para descobrir como mudar o seu ONLYOFFICE Workspace para HTTPS.

Criando um certificado de segurança e uma chave privada​

Antes de começar a mudar o seu ONLYOFFICE Workspace Community para HTTPS, você precisará criar um certificado de segurança e a chave privada do certificado.

Para gerar automaticamente um certificado SSL usando o serviço letsencrypt, consulte este artigo.

Depois de ter o certificado, siga as etapas abaixo.

Mudando o ONLYOFFICE Workspace Community para HTTPS usando o script​

A maneira mais rápida de mudar o ONLYOFFICE Workspace Community para HTTPS é usar o script. Ele está localizado aqui:

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

Coloque os certificados criados no diretório /var/www/onlyoffice/Data/certs/. Devem existir dois arquivos nele:

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

Em seguida, execute o script:

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

Ele fará tudo o que for necessário para mudar a sua instalação do ONLYOFFICE Workspace Community para HTTPS.

Mudando o ONLYOFFICE Workspace Community para HTTPS manualmente​

Você pode executar manualmente todas as ações do script. Para isso, siga as etapas abaixo:

  1. Pare o serviço NGINX:

    sudo service nginx stop

  2. Copie o arquivo /etc/nginx/includes/onlyoffice-communityserver-common-ssl.conf.template para o arquivo /etc/nginx/sites-available/onlyoffice em sistemas baseados em Debian ou para /etc/nginx/conf.d/onlyoffice.conf em sistemas baseados em RPM.

    Use o seguinte comando para sistemas baseados em Debian:

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

    Use o seguinte comando para sistemas baseados em RPM:

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

  3. Edite o arquivo /etc/nginx/sites-available/onlyoffice em sistemas baseados em Debian ou o arquivo /etc/nginx/conf.d/onlyoffice.conf em sistemas baseados em RPM. Altere todos os parâmetros entre chaves duplas {{...}} para os valores realmente usados:

    • {{SSL_CERTIFICATE_PATH}}: o caminho para o certificado SSL que você tem;
    • {{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 os valores disponíveis 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}}: uma opção de configuração avançada para definir o max-age do HSTS na configuração do vHost NGINX do ONLYOFFICE Workspace Community, aplicável somente quando o SSL está em uso (geralmente o padrão é 31536000, considerado seguro o suficiente);
    • {{SSL_DHPARAM_PATH}}: o caminho para o parâmetro Diffie-Hellman;
    • {{ONLYOFFICE_NGINX_KEEPLIVE}}: o número máximo de conexões keep-alive ociosas com servidores upstream que são mantidas no cache de cada processo de trabalho (para mais informações sobre este parâmetro, consulte a documentação do NGINX);
    • {{DOCKER_ONLYOFFICE_SUBNET}}: o valor da sub-rede interna do Docker (se o ONLYOFFICE Workspace Community estiver instalado usando Docker);
    • {{SSL_OCSP_CERTIFICATE_PATH}}: o caminho para um arquivo com certificados de CA confiáveis no formato PEM, usado para verificar certificados de cliente e respostas OCSP (Online Certificate Status Protocol) se ssl_stapling estiver habilitado.

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

  4. Abra o arquivo de configuração /var/www/onlyoffice/Services/MailAggregator/ASC.Mail.Aggregator.CollectionService.exe.config e defina o valor do parâmetro mail.default-api-scheme como https. Depois disso, reinicie o serviço do agregador de e-mail:

    onlyofficeMailAggregator restart

  5. Mude o Talk para o protocolo TLS.

  6. Quando todas as alterações forem feitas, você pode iniciar o serviço NGINX novamente:

    sudo service nginx start
    observação

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