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