For the complete documentation index, see llms.txt. This page is also available as Markdown.

instalação de certificados SSL

Instale certificados SSL no Navixy On-Premise e converta HTTP em HTTPS. Abrange a preparação do certificado, a configuração do Nginx e atualizações da configuração da plataforma.

Esta página descreve como instalar inicialmente um certificado SSL e converter seu site para usar HTTPS. Se você já estiver usando um certificado SSL e ele tiver expirado, consulte a Atualização página.

A plataforma Navixy usa Nginx como servidor web. Ela é compatível com Linux e Windows, portanto, as etapas abaixo se aplicam a qualquer sistema operacional.

Etapa 1. Preparar certificados SSL

Para garantir a proteção SSL do seu site, você precisará de um certificado SSL junto com sua chave privada. Se o seu site tiver vários nomes de domínio, você precisará de um certificado para cada domínio ou de um certificado multidomínio ou wildcard.

Para obter um certificado, você pode entrar em contato com qualquer autoridade certificadora. A plataforma oferece suporte a certificados válidos de qualquer emissor. Para mais detalhes sobre a proteção SSL, consulte esta página: Criptografia SSL.

Cadeia de confiança

Para que o seu certificado SSL funcione corretamente, ele deve incluir uma cadeia de confiança completa. Isso significa que o(s) arquivo(s) de certificado não deve(m) conter apenas o certificado principal, mas também quaisquer certificados intermediários e raiz necessários para estabelecer uma cadeia de confiança com o emissor do certificado. Esses certificados são conhecidos como certificados de cadeia completa.

É importante garantir que o certificado que você obtiver inclua a cadeia completa, pois alguns recursos, como aplicativos móveis, podem não funcionar corretamente sem ela. Se você encontrar dificuldades para montar a cadeia completa, pode entrar em contato com o emissor do certificado para obter ajuda ou usar ferramentas on-line como esta para resolver a cadeia de confiança. Para mais informações sobre a cadeia de confiança, você pode consultar uma explicação fornecida pelo emissor do SSL.

Requisito da chave privada

Para que o servidor web Nginx inicie corretamente, a chave privada deve corresponder ao certificado SSL. Normalmente, o emissor do certificado fornece a chave privada junto com o certificado. Se você reemitir um certificado da mesma autoridade, a chave privada geralmente permanece a mesma e não precisa ser substituída.

Etapa 2. Instalar certificados SSL

Configuração automática de SSL com LetsEncrypt

Se sua plataforma foi instalada automaticamente (veja Instalação automática), você pode instalar certificados gratuitos do LetsEncrypt usando o Assistente de configuração.

Configuração manual de SSL com quaisquer certificados

Para instalar manualmente certificados SSL no seu servidor, comece obtendo os arquivos do certificado e da chave privada. Eles podem ser obtidos de qualquer autoridade certificadora. Depois de ter os arquivos, você precisa colocá-los em um diretório no seu servidor. Recomenda-se usar os caminhos padrão, que são /etc/nginx/ssl/ para Linux e C:\nginx\conf\ssl\ para Windows.

Depois de colocar os arquivos no diretório apropriado, você pode especificar o caminho para o certificado e a chave privada na configuração do seu site. Recomenda-se usar caminhos curtos como ssl/name.crt e ssl/name.key. Usando esses caminhos padrão, você não precisará especificar o caminho completo para o certificado e a chave privada na configuração do site.

Etapa 3. Atualizar configuração

Atualizar a configuração do Nginx

Encontre o arquivo de configuração do seu site. Ele geralmente se chama navixy.conf e está localizado em /etc/nginx/sites-available/ (Linux) ou C:\nginx\sites-enabled\ (Windows).

Recomenda-se prosseguir com as configurações prontas para uso do Nginx fornecidas na Nginx página. Basta escolher uma configuração HTTPS que corresponda ao seu sistema operacional e ao número de domínios, e substituir o conteúdo atual de navixy.conf por ela. Em seguida, você só precisa especificar os domínios e os caminhos para os certificados e chaves privadas. Fazendo isso, você pode evitar possíveis erros, já que o restante da configuração já foi comprovado como funcional. No entanto, você também pode optar por editar a configuração do Nginx manualmente, se isso atender melhor às suas necessidades.

Altere a porta de escuta de "80" para "443 ssl" e adicione as linhas relacionadas a SSL à configuração de cada site, especificando o caminho correto para os arquivos do seu certificado fullchain e da chave.

Aqui está um exemplo da configuração do site da API:

Reinicie o servidor web Nginx:

  • No Linux: nginx -t && nginx -s reload

  • No Windows, você precisa encerrar todos os processos do Nginx e então iniciar nginx.exe from C:\nginx.

Certifique-se de que o Nginx foi iniciado e não apresenta nenhum erro relacionado a SSL.

Atualize os arquivos de configuração da plataforma

Em seguida, precisamos informar ao Navixy para usar o protocolo HTTPS em vez de HTTP em todos os arquivos de configuração. Abra os seguintes arquivos:

  • /var/www/panel-v2/PConfig.js – edite o parâmetro "apiRoot", alterando "http" para "https". Edite o parâmetro "terminalHost" - altere "ws" para "wss" e exclua a porta 8383.

  • /var/www/pro-ui/Config.js – edite o parâmetro "apiRoot", alterando "http" para "https"

  • /var/www/pro-ui/static/app_config.js – edite o parâmetro "apiUrl", alterando "http" para "https" (se o valor estiver presente)

  • /home/java/api-server/conf/config.properties – edite o parâmetro api.externalBaseUrl, alterando "http" para "https" (se o valor estiver presente)

Reinicie os serviços Navixy (veja Reinicialização da instância) para que todas as alterações entrem em vigor. Se a página ainda estiver carregando via HTTP, você pode tentar limpar o cache do navegador.

Atualizado

Isto foi útil?