Inserção de Certificados SSL - Gestão Contábil com Questor Cloud

1. Iniciando o Servidor do Cloud como Aplicação

Para iniciar o servidor como aplicação, na pasta de instalação do Gestão Contábil basta executar o aplicativo nHttp.exe. Ao iniciar o serviço uma tela de Prompt ficará visível, indicando que o serviço está rodando e pronto para a utilização.
Algumas opções podem ser repassadas ao aplicativo antes de iniciar o mesmo via linha de comando, como por exemplo:

• /porta:8080 - Indica em qual porta o servidor Http do Cloud irá responder. A porta padrão, quando não informada, é a 8080.

• /log - Habilita o log das requisições no prompt de comando.

• /phttps - Porta Https na qual o servidor Http irá responder. Na presença de uma porta Https, a porta Http será ignorada e o servidor responderá apenas na porta Https.
• /limiteclients:256 - Ativa o modo de comunicação por Http com os servidores de execução "nHttpExe". Obs.: recomendado utilizar este formato.

2. Instalando o Servidor do Cloud como um Serviço

Quando existe a necessidade de se iniciar o Cloud automaticamente como um serviço junto com o Windows, deve ser configurado através da conexão do sistema Tributário, na aba serviços. Esta aba somente irá funcionar se o aplicativo do tributário estiver rodando com direitos administrativos no windows.

Segue abaixo como preencher os dados:

• Aplicativo: Aplicativo ao qual o serviço se refere, escolher a opção: Cloud.
• Nome Serviço: Nome interno do serviço, deixar a opção padrão.
• Descrição: Descrição do serviço que aparecerá no gerenciador de serviços do windows.
• Porta: Porta na qual o servidor Http responderá.
• Porta Https: Porta Https na qual o servidor Http responderá. Na presença de uma porta Https, a porta Http será ignorada e o servidor responderá apenas na porta Https. OBS: Para que funcione corretamente o certificado deve estar devidamente configurado no servidor.
• Gerar Log: Habilita ou não a geração do log das requisições quando em modo de serviço.

Após a confirmação das informações, o sistema solicitará que o serviço seja iniciado imediatamente. Caso a resposta seja negativa, o serviço iniciará na próxima reinicialização da máquina em que foi instalado.
Pode-se visualizar os serviços instalados e o status de cada um através deste configurador:

3. Configuração sem Certificado SSL (http)

3.1. Abrir a porta 80 ou a porta escolhida para receber as conexões http no firewall do windows.

3.2. Adicionar um novo Serviço no Questor como exemplo abaixo:

4. Configuração com Certificado SSL (https)

Observação: Para que funcione corretamente o certificado deve estar devidamente configurado no servidor.

4.1. Abrir a porta 443 ou a porta escolhida para receber as conexões https no firewall do windows.

4.2. Instalar o certificado pelo "Gerenciador de Certificados do Computador", acessar através do comando "certmgr.msc", não instalar no usuário local, instalar na pasta "Pessoal/Certificados", como imagem abaixo:

4.3. Rodar o Prompt de Comando "cmd" como administrador e executar os comandos abaixo:

• netsh http add sslcert ipport=XXX.XXX.XXX:443 appid={00112233-4455-6677-8899-AABBCCDDEEFF} certhash=ea5874440f7ffbbb2f50866d0e3cdca19cec8bf8 certstorename=my

• Onde: XXX.XXX.XXX é o ip físico da máquina a qual está sendo instalado, por exemplo 192.168.0.150, obs.: não utilizar LocalHost.

Para buscar o certhash, abrir o "Gerenciador de Certificados do Computador" através do comando "certmgr.msc", acessar a pasta "Pessoal/Certificados", clicar duas vezes no certificado, acessar a aba detalhes campo "Impressão Digital", copiar e remover os espaços.

4.4. Adicionar o Serviço no Questor como exemplo abaixo:

5. Verificando a Instalação

Em muitos casos, não se sabe se a instalação está correta, pois os sistema não funciona como deveria. Abaixo alguns problemas e verificações que devem ser feitas caso não funcione.

nHttp gera erro ao iniciar quando utilizada uma porta https

Há duas causas para o nWeb/nHttp gerar esse erro ao iniciar o aplicativo:

Caso alguma das anteriores esteja errada, deve-se excluir o vinculo do certificado e registrar o mesmo novamente.

• Para excluir o certificado: "netsh http delete sslcert ipport={ip}:{porta}".
• Para atribuir o certificado correto: ver o item Configuração com Certificado SSL (https) no início desta documentação.
• Está sendo utilizada uma porta fora dos padrões https - Algumas portas não podem ser utilizadas para responder https, recomenda-se a 443 sempre.

nHttp iniciam sem problemas, mas ficam inacessíveis de outro computador

• Verificar se existem regras válidas de entrada no firewall do windows caso o mesmo esteja ativado.

6. Teste externo - acesso

Acesse o navegador e digite o dominio respectivo de cada empresa, ex: questor.com.br.

• Esse acesso representa a entrega no IP e na porta que for publicado no escritorio ={ip}:{porta} - ex: gc01.questor.com.br.

• Observe que sera entregue a tela de acesso ao Questor Cloud

• Confira no certificado entregue se esta dando referencia ao sertificado inserido no processo acima apontado.