Guia para Emissão e Configuração de Certificado SSL no DOX Portal

Objetivo

Este documento orienta clientes da Ema Sistemas na emissão e configuração de certificados SSL para uso em domínios próprios no DOX Portal.

A utilização do HTTPS (HTTP sobre SSL/TLS) garante uma camada adicional de segurança na comunicação entre o navegador e o servidor, protegendo os dados transmitidos por meio de criptografia.

✅ Etapas para Emissão e Configuração do Certificado SSL

1. Registrar um Domínio Próprio

• Você deve possuir um domínio registrado em seu nome (ex: suaempresa.com.br)
• Este domínio servirá de base para criação do endereço de acesso ao DOX Portal (ex: dox.suaempresa.com.br)
• Se você não possui domínio, deve registrar através de:
  • Registro.br
  • Provedores de hospedagem (KingHost, GoDaddy, HostGator, etc.)

💡 Importante: A Ema não realiza o registro para os clientes, mas pode instruir como fazer. O registro de domínio é um serviço pago.

2. Hospedar o Domínio

• Após o registro, o domínio deve estar vinculado a um serviço de hospedagem com suporte à emissão de certificados SSL
• Recomendação: Serviços como KingHost ou similares, que já oferecem emissão de certificados SSL compatíveis

💰 A hospedagem do domínio também é um serviço pago.

3. Criar o Subdomínio e Emitir o Certificado SSL

Com o domínio hospedado:

1. Crie o subdomínio que será utilizado no acesso ao DOX Portal (ex: dox.suaempresa.com.br)
2. Solicite no serviço de hospedagem a emissão do certificado SSL para este subdomínio, garantindo que o formato gerado seja compatível com o sistema da Ema: .PEM ou .CRT
3. Alternativa: Caso a hospedagem não ofereça emissão de certificado SSL, será necessário buscar uma certificadora terceirizada especializada. Esta alternativa exige atenção redobrada, pois envolve um processo mais técnico e pode demandar etapas adicionais de validação e configuração.

⏱️ A emissão pode levar até 1 dia útil, dependendo do provedor de hospedagem.

4. Configurar o Certificado no Ema Configurador

Com o certificado em mãos, siga os passos abaixo com apoio do Suporte da Ema:

1. Abra o Ema Configurador e edite o registro da conexão
2. Defina a porta principal como 443 (HTTPS padrão). Portas alternativas também são permitidas, desde que especificadas corretamente no endereço de conexão
3. Marque a opção "Utiliza HTTPS"
4. Nos campos "Certificado" e "Arq. Senha" procure e informe o certificado no formato .PEM ou .CRT
5. Caso o cliente esteja executando o sistema anteriormente com conexão HTTP, altere o caminho de conexão no seguinte arquivo, substituindo o protocolo de http para https e ajustando a porta.:
   

   C:\Ema Software\Contas ERP\Ema_Conexao_Servidor.ini

5. Testar a Inicialização do Sistema com SSL

Caso os microserviços do sistema não iniciem, execute o seguinte teste manual:

1. Abra o terminal do Windows (Prompt de Comando)
2. Execute:
   

   C:\Ema Software\Contas ERP\fabio.exe" -cfg fabio.properties

3. Este comando tenta inicializar o serviço com o certificado SSL configurado e mostrará mensagens de erro úteis para diagnóstico

🔧 Se o sistema estiver online, pare os serviços pelo Ema_Start antes de testar.

ℹ️ Informações Importantes

🌐 Clientes Cloud Server da Ema

• O domínio fornecido para acesso ao cloud não pode ser usado para emissão de certificados SSL
• O cliente deve possuir um domínio próprio

🆓 Opção Gratuita com Let's Encrypt

• Também é possível emitir certificados gratuitamente com o Let's Encrypt
• Esta opção exige:
  • Conhecimento técnico em Linux
  • Que o cliente renove o certificado a cada 90 dias
• • Que o cliente renove o certificado a cada 90 dias

🔗 Documentação Relacionada

Para mais informações sobre configuração de acesso externo, consulte também: Liberando o Acesso Externo ao DOX Portal