Como instalar um certificado SSL num servidor 4D

Neste tutorial, você aprenderá como instalar um certificado SSL no 4D Server. O 4D protege seu servidor web integrado com dois arquivos PEM, cert.pem (seu certificado) e key.pem (sua chave privada), colocados junto à pasta do projeto, após o que você ativa o HTTPS nas configurações do 4D.

Gerar um código CSR no 4D Server

Um CSR (Certificate Signing Request) é um bloco de texto codificado com os seus dados de contato que uma Autoridade Certificadora exige para validar e emitir o seu certificado SSL. Você tem duas opções:

• Use nosso Gerador de CSR para criar o CSR automaticamente. É simples e não requer nenhum conhecimento técnico.
• Siga nosso tutorial passo a passo sobre como gerar um CSR no 4D Server.

Abra o seu arquivo CSR com um editor de texto e copie o conteúdo para a caixa correspondente durante o processo de pedido do SSL. Envie o CSR à Autoridade Certificadora e, assim que a CA o validar e emitir o seu certificado, prossiga com a instalação abaixo.

Instalar um certificado SSL no 4D Server

O 4D usa seus próprios arquivos para TLS em vez de uma diretiva de configuração. Você fornece o certificado e a chave como arquivos PEM em um local fixo, adiciona quaisquer certificados intermediários e, em seguida, ativa o HTTPS nas configurações.

Passo 1: Prepare os seus arquivos PEM

Depois que a Autoridade Certificadora entregar o seu certificado por e-mail, faça o download do arquivo ZIP e extraia-o. O 4D aceita certificados apenas no formato PEM (x509 em texto simples). Os nomes dos arquivos são fixos:

• cert.pem: o certificado do seu domínio. Se a sua CA enviou um arquivo .crt, abra-o em um editor de texto e salve o conteúdo em um arquivo de texto simples chamado cert.pem. O nome do arquivo deve ser exatamente cert.pem.
• key.pem: a chave privada que você gerou junto com o CSR. O nome do arquivo deve ser exatamente key.pem.

Um certificado PEM é texto simples delimitado por linhas de cabeçalho e rodapé, assim:

-----BEGIN CERTIFICATE-----
MIIFazCCA1OgAwIBAgIRA...
...your encoded certificate...
-----END CERTIFICATE-----

Onde colocar os arquivos. Com o 4D ou o 4D Server no modo local, coloque cert.pem e key.pem junto à pasta do projeto (a pasta que contém a estrutura do seu banco de dados). Para um cliente 4D no modo remoto, coloque-os na pasta do banco de dados do cliente na máquina remota. Se você construir o caminho no código, o comando Get 4D folder retorna a pasta 4D ativa para que você possa localizar o diretório correto.

Passo 2: Adicione os certificados intermediário e raiz

Os navegadores precisam da cadeia completa, portanto o pacote da CA (intermediário e, às vezes, raiz) deve estar disponível junto ao seu certificado. No 4D, você tem duas maneiras de fornecê-lo:

• Arquivos PEM separados (recomendado). Salve cada certificado intermediário (e raiz) como seu próprio arquivo .pem na mesma pasta que cert.pem. Os arquivos extras podem usar qualquer nome, desde que a extensão seja .pem. O 4D lê todos os arquivos .pem nessa pasta e monta a cadeia.
• Um arquivo combinado. Como alternativa, cole o seu certificado seguido de cada intermediário (em ordem, folha primeiro) em um único cert.pem, mantendo cada linha BEGIN/END intacta.

Mantenha a pasta limpa. O 4D carrega todos os arquivos .pem que encontrar junto à pasta do projeto. Exclua quaisquer arquivos .pem remanescentes de um certificado anterior, pois um arquivo desatualizado ou incompatível pode fazer com que o servidor web recuse conexões HTTPS.

Versões mais antigas do 4D. Versões anteriores ao modelo atual de pasta PEM exigiam que um componente TLS estivesse presente: 4DSLI.DLL no Windows (junto ao executável 4D ou 4D Server) ou 4DSLI.bundle no macOS (na subpasta Native Components do pacote 4D). As versões atuais do 4D tratam o TLS internamente, portanto você não precisa mais adicionar esse componente manualmente. Se você usar uma versão mais antiga, confirme se o componente está presente antes de ativar o HTTPS.

Passo 3: Ative o HTTPS nas configurações do 4D

Com os arquivos no lugar, ative o HTTPS para o servidor web do 4D:

1. Abra Settings (no 4D atual, o menu Design ou Structure; em versões mais antigas, esta caixa de diálogo é chamada de Database Settings).
2. Selecione a seção Web.
3. Abra a página Configuration e marque Enable HTTPS. Deixe a HTTPS Port no seu padrão de 443, a menos que a sua configuração precise de outra porta.
4. Clique em OK para salvar.

Por padrão, o protocolo mínimo aceito pelo 4D é TLS 1.2. Você pode elevar esse piso para TLS 1.3 com a propriedade do servidor web minTLSVersion se a sua política de segurança exigir isso, ou reduzi-lo apenas se precisar dar suporte a clientes mais antigos. Mantenha o mínimo em TLS 1.2 ou superior.

Passo 4: Reinicie o servidor web e verifique

Pare e inicie o servidor web do 4D para que ele carregue os arquivos de certificado. Na primeira inicialização do HTTPS, se um arquivo dhparams.pem ainda não existir, o 4D gera um (2048 bits) e o coloca junto a cert.pem e key.pem. Isso pode levar um minuto ou dois, portanto deixe o processo terminar.

Abra o seu site em https:// e confirme que o cadeado aparece. Após a instalação, escaneie o certificado em busca de problemas de cadeia ou configuração com o nosso SSL Checker, que retorna um relatório instantâneo sobre o certificado e como ele é servido. Um intermediário ausente é o problema mais comum, e um verificador o detecta imediatamente.

Opcional, ative o HSTS. Assim que o HTTPS funcionar de forma confiável, você pode dizer aos navegadores para sempre usarem a versão segura. Em Settings, abra a seção Web, vá para a página Options (II) e marque Enable HSTS. Ative isso apenas depois de confirmar que o HTTPS está estável, pois é difícil reverter enquanto a política estiver armazenada em cache nos navegadores.

Perguntas Frequentes