¶ Como configurar o certificado SSL (HTTPS) no nServer?
O nServer permite expor o Questor Cloud via HTTPS utilizando um certificado SSL instalado na máquina local. Esta configuração é necessária para ambientes que exigem comunicação segura com os clientes do sistema. Os passos abaixo cobrem desde a abertura de porta no firewall até a validação do certificado no navegador.
¶ Pré-requisitos
- Permissões de administrador no servidor Windows.
- Acesso ao PowerShell como administrador.
- Chocolatey instalado ou disponível para instalação conforme descrito neste manual.
- OpenSSL instalado (será instalado durante o processo, se necessário).
- Entendimento básico sobre certificados digitais nos formatos .crt, .key e .pfx.
- Acesso ao Gerenciador de Certificados do Windows (certlm.msc).
¶ Iniciando o servidor antes da configuração
Antes de configurar o HTTPS, o nServer deve estar em execução como aplicação. Para isso, consulte o guia de configuração:
📌 Orientação importante!
Para saber como iniciar o servidor do Cloud como aplicação, acesse:
Configuração do nServer
¶ 1º Passo — Abrir a porta HTTPS no firewall
Para que o servidor aceite conexões externas na porta HTTPS, é necessário liberar a porta correspondente no firewall do Windows.
- Acesse o Firewall do Windows com Segurança Avançada.
- Crie uma nova regra de entrada para liberar a porta 443 (ou outra porta definida para HTTPS).
¶ 2º Passo — Instalar o certificado SSL
O certificado deve ser instalado no repositório da máquina local, na pasta Pessoal > Certificados.
Quando já possui um arquivo .pfx, realize a importação diretamente:
- Pressione Win + R, digite certlm.msc e pressione Enter.
- Navegue até Pessoal > Certificados, clique com o botão direito e selecione Importar.
- Selecione o arquivo .pfx, informe a senha (se houver) e conclua a instalação.
- Verifique se o certificado aparece corretamente na lista.
Quando não possui um arquivo .pfx, gere-o a partir dos arquivos .crt e .key:
Instale o Chocolatey, caso ainda não esteja disponível. Abra o PowerShell como administrador e execute:
Set-ExecutionPolicy Bypass -Scope Process -Force; \
[System.Net.WebClient]::new().DownloadString('https://community.chocolatey.org/install.ps1') | Invoke-Expression
Aguarde a conclusão e instale o OpenSSL:
choco install openssl -y
Acesse a pasta onde os arquivos estão salvos. Exemplo:
cd C:\Certificados
Execute o comando abaixo para gerar o arquivo .pfx:
openssl pkcs12 -export -out certificado.pfx -inkey arquivo.key -in arquivo.crt
Substitua certificado.pfx, arquivo.key e arquivo.crt pelos nomes reais dos seus arquivos. O arquivo .pfx será gerado na mesma pasta. Em seguida, importe-o conforme descrito acima.
¶ 3º Passo — Configurar o certificado com netsh
Com o certificado instalado, é necessário vinculá-lo à porta HTTPS por meio do netsh.
Abra o PowerShell como administrador e liste os certificados instalados para obter o hash (Thumbprint):
Get-ChildItem -Path cert:\LocalMachine\My, cert:\LocalMachine\root `
-SSLServerAuthentication
A saída exibirá algo semelhante ao exemplo abaixo:
FriendlyName Thumbprint
Questor Cloud Cert 1234567890ABCDEF1234567890ABCDEF12345678
Copie o valor da coluna Thumbprint e remova todos os espaços. Se preferir, obtenha o hash manualmente: abra o Gerenciador de Certificados, clique no certificado, acesse a aba Detalhes e localize o campo Impressão Digital.
Com o hash em mãos, execute o comando de bind:
netsh http add sslcert ipport=0.0.0.0:443 appid='{00112233-4455-6677-8899-AABBCCDDEEFF}' certhash=1234567890ABCDEF1234567890ABCDEF12345678 certstorename=my
Substitua 1234567890ABCDEF1234567890ABCDEF12345678 pelo hash obtido no passo anterior.
¶ 4º Passo — Adicionar o serviço HTTPS no Questor
Com o certificado vinculado à porta, adicione o serviço correspondente no sistema.
No Questor, cadastre um novo serviço com as seguintes configurações:
- Nome do serviço: QuestorHTTPS.
- Tipo: HTTPS.
- Porta: 443.
No nServer, acesse a aba nHttp e informe 443 no campo de Porta HTTPS.
¶ 5º Passo — Testar o acesso externo
Para validar a configuração, abra um navegador e acesse o domínio configurado. Exemplo:
https://gc01.questor.com.br
Para confirmar que o certificado está ativo e correto, siga as etapas abaixo:
- Clique no cadeado próximo à barra de endereço.
- Selecione Certificado ou Connection is secure (conforme o navegador).
- Verifique o emissor, a validade e o nome do domínio informados.
- Confirme que o certificado exibido corresponde ao configurado.
⚠️ Atenção!
Se a página não carregar, revise as configurações de firewall, o certificado instalado e o bind realizado no passo anterior.
¶ Resolução de problemas
Os problemas mais comuns durante a configuração do HTTPS estão descritos abaixo, com suas respectivas soluções.
Erro ao iniciar com porta HTTPS pode ter as seguintes causas:
- Certificado incorreto: Verifique o hash e reinstale o certificado. Para remover o bind anterior, execute
netsh http delete sslcert ipport=0.0.0.0:443e refaça o 3º Passo. - Porta inválida: Utilize portas padrão como a 443.
Inacessibilidade externa ocorre geralmente por:
- Regras de entrada ausentes ou incorretas no firewall do Windows.
- IP ou porta configurados de forma incorreta no serviço.
¶ Informações gerais
Os termos abaixo são utilizados ao longo desta configuração e estão descritos para referência.
- Bind: Processo de associar um certificado SSL a uma porta de rede.
- certhash: Impressão digital do certificado, utilizada para identificação no bind.
- PFX: Formato de arquivo que combina o certificado público e a chave privada.