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: 

 Crie o subdomínio  que será utilizado no acesso ao DOX Portal (ex:  dox.suaempresa.com.br ) 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 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 : 

 Abra o Ema Configurador  e edite o registro da conexão 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 Marque a opção "Utiliza HTTPS" Nos campos "Certificado" e "Arq. Senha"  procure e informe o certificado no formato  .PEM  ou  .CRT 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 : 

 Abra o terminal do Windows  (Prompt de Comando) Execute: C:\Ema Software\Contas ERP\fabio.exe" -cfg fabio.properties 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