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

#### <span style="color: inherit;">Objetivo</span>

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.

<span style="white-space: pre-wrap;">A utilização do </span>**HTTPS**<span style="white-space: pre-wrap;"> (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.</span>

---

#### <span style="color: inherit;">✅ Etapas para Emissão e Configuração do Certificado SSL</span>

##### <span style="color: inherit;">1. Registrar um Domínio Próprio</span>

- <span style="white-space: pre-wrap;">Você deve possuir um </span>**domínio registrado em seu nome**<span style="white-space: pre-wrap;"> (ex: </span>`<span class="editor-theme-code">suaempresa.com.br</span>`)
- <span style="white-space: pre-wrap;">Este domínio servirá de base para criação do endereço de acesso ao DOX Portal (ex: </span>`<span class="editor-theme-code">dox.suaempresa.com.br</span>`)
- Se você não possui domínio, deve registrar através de:
    - **Registro.br**
    - Provedores de hospedagem (KingHost, GoDaddy, HostGator, etc.)

<span style="white-space: pre-wrap;">💡 </span>**Importante:**<span style="white-space: pre-wrap;"> A Ema </span>**não realiza**<span style="white-space: pre-wrap;"> o registro para os clientes, mas pode instruir como fazer. </span>**O registro de domínio é um serviço pago.**

##### <span style="color: inherit;">2. Hospedar o Domínio</span>

- <span style="white-space: pre-wrap;">Após o registro, o domínio deve estar vinculado a um </span>**serviço de hospedagem**<span style="white-space: pre-wrap;"> com suporte à emissão de certificados SSL</span>
- **Recomendação:**<span style="white-space: pre-wrap;"> Serviços como KingHost ou similares, que já oferecem emissão de certificados SSL compatíveis</span>

<span style="white-space: pre-wrap;">💰 </span>**A hospedagem do domínio também é um serviço pago.**

##### <span style="color: inherit;">3. Criar o Subdomínio e Emitir o Certificado SSL</span>

Com o domínio hospedado:

1. **Crie o subdomínio**<span style="white-space: pre-wrap;"> que será utilizado no acesso ao DOX Portal (ex: </span>`<span class="editor-theme-code">dox.suaempresa.com.br</span>`)
2. **Solicite no serviço de hospedagem**<span style="white-space: pre-wrap;"> a emissão do certificado SSL para este subdomínio, garantindo que o formato gerado seja compatível com o sistema da Ema: </span>**.PEM**<span style="white-space: pre-wrap;"> ou </span>**.CRT**
3. **Alternativa:**<span style="white-space: pre-wrap;"> Caso a hospedagem não ofereça emissão de certificado SSL, será necessário buscar uma </span>**certificadora terceirizada**<span style="white-space: pre-wrap;"> 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.</span>

<span style="white-space: pre-wrap;">⏱️ </span>**A emissão pode levar até 1 dia útil**, dependendo do provedor de hospedagem.

##### <span style="color: inherit;">4. Configurar o Certificado no Ema Configurador</span>

<span style="white-space: pre-wrap;">Com o certificado em mãos, siga os passos abaixo </span>**com apoio do Suporte da Ema**:

1. **Abra o Ema Configurador**<span style="white-space: pre-wrap;"> e edite o registro da conexão</span>
2. **Defina a porta principal como 443**<span style="white-space: pre-wrap;"> (HTTPS padrão). Portas alternativas também são permitidas, desde que especificadas corretamente no endereço de conexão</span>
3. **Marque a opção "Utiliza HTTPS"**
4. **Nos campos "Certificado" e "Arq. Senha"**<span style="white-space: pre-wrap;"> procure e informe o certificado no formato </span>**.PEM**<span style="white-space: pre-wrap;"> ou </span>**.CRT**
5. **Caso o cliente esteja executando o sistema anteriormente com conexão HTTP**<span style="white-space: pre-wrap;">, altere o caminho de conexão no seguinte arquivo, substituindo o protocolo de </span>`<span class="editor-theme-code">http</span>`<span style="white-space: pre-wrap;"> para </span>`<span class="editor-theme-code">https</span>`<span style="white-space: pre-wrap;"> e ajustando a porta.:</span>  
    ```
    C:\Ema Software\Contas ERP\Ema_Conexao_Servidor.ini
    ```

##### <span style="color: inherit;">5. Testar a Inicialização do Sistema com SSL</span>

<span style="white-space: pre-wrap;">Caso os microserviços do sistema não iniciem, execute o seguinte </span>**teste manual**:

1. **Abra o terminal do Windows**<span style="white-space: pre-wrap;"> (Prompt de Comando)</span>
2. **Execute:**  
    ```
    C:\Ema Software\Contas ERP\fabio.exe" -cfg fabio.properties
    ```
3. <span style="white-space: pre-wrap;">Este comando tenta inicializar o serviço com o certificado SSL configurado e mostrará </span>**mensagens de erro úteis para diagnóstico**

<span style="white-space: pre-wrap;">🔧 </span>**Se o sistema estiver online, pare os serviços pelo Ema\_Start antes de testar.**

---

#### <span style="color: inherit;">ℹ️ Informações Importantes</span>

#### <span style="color: inherit;">🌐 Clientes Cloud Server da Ema</span>

- <span style="white-space: pre-wrap;">O domínio fornecido para acesso ao cloud </span>**não pode ser usado**<span style="white-space: pre-wrap;"> para emissão de certificados SSL</span>
- <span style="white-space: pre-wrap;">O cliente </span>**deve possuir um domínio próprio**

#### <span style="color: inherit;">🆓 Opção Gratuita com Let's Encrypt</span>

- <span style="white-space: pre-wrap;">Também é possível emitir certificados </span>**gratuitamente**<span style="white-space: pre-wrap;"> com o Let's Encrypt</span>
- Esta opção exige:
    - **Conhecimento técnico em Linux**
    - <span style="white-space: pre-wrap;">Que o cliente </span>**renove o certificado a cada 90 dias**
- - <span style="white-space: pre-wrap;">Que o cliente </span>**renove o certificado a cada 90 dias**

---

#### <span style="color: inherit;">🔗 Documentação Relacionada</span>

<span style="white-space: pre-wrap;">Para mais informações sobre configuração de acesso externo, consulte também: </span>[Liberando o Acesso Externo ao DOX Portal](https://kb.emasistemas.com.br/books/configuracoes/page/liberando-o-acesso-externo-ao-dox-portal)