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 um certificado SSL pela primeira vez 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 fornecidas 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 curinga.

Para garantir o funcionamento correto do servidor web, é importante ter não apenas um certificado SSL, mas também um arquivo de chave privada correspondente. Sem a chave privada correta, o servidor web não conseguirá iniciar. Tanto o certificado quanto a chave privada normalmente são fornecidos pela sua autoridade certificadora SSL.

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 seu certificado SSL funcione corretamente, ele deve incluir uma cadeia de confiança completa. Isso significa que os arquivos do certificado não devem 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 alguma dificuldade 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 SSL.

• Como as cadeias de certificados funcionam

• Resolvedor de cadeias de certificados 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.

• Ferramenta para confirmar que o certificado corresponde à chave privada

Etapa 2. Instalar certificados SSL

Configuração automática de SSL com LetsEncrypt

Se sua plataforma foi instalada automaticamente (consulte 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 em 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 que você use 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. Ao usar esses caminhos padrão, você não precisará especificar o caminho completo do certificado e da chave privada na configuração do site.

Etapa 3. Atualizar a configuração

Atualizar a configuração do Nginx

Encontre o arquivo de configuração do seu site. Ele normalmente 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 do Nginx prontas para uso 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 do navixy.conf por ela. Depois, você só precisa especificar os domínios e os caminhos para os certificados e chaves privadas. Ao fazer 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 certificado de cadeia completa e da chave.

listen 443 ssl; ## listen for ipv4
ssl_certificate /ssl/certificate.crt;
ssl_certificate_key /ssl/private.key;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;

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

server {
listen 443 ssl; ## listen for ipv4
server_name api.domain.com;
access_log /var/log/nginx/api.domain.com_ssl.access.log;
client_max_body_size 20m;
ssl_certificate /ssl/certificate.crt;
ssl_certificate_key /etc/nginx/ssl/private.key;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
location / {proxy_pass http://127.0.0.1:8084;
}
}

Reinicie o servidor web Nginx:

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

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

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

Atualizar 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 do Navixy (consulte Reiniciando a instância) para que todas as alterações tenham efeito. Se a página ainda estiver carregando via HTTP, você pode tentar limpar o cache do navegador.