Skip to main content

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


Back to top