Adicionar certificado SSL/HTTPS no Windows com XAMPP

O certificado digital é um recurso obrigatório para todo site. No ambiente de desenvolvimento local ele pode não ter a mesma importância, podemos até desenvolver sem termos nenhum certificado SSL/HTTPS instalado. No entanto os navegadores estão mais seguros e ficam avisando que está havendo uma quebra de segurança quando estamos testando os sistemas que estamos desenvolvendo, além disso, algumas aplicações necessitam obrigatória estar navegando de forma certificada, como paginas de pagamentos com cartão. Para resolver isso precisamos instalar um certificado SSH/HTTPS na nossa máquina local. Nosso ambiente de trabalho está rodando em uma máquina com Windows 10 e com o XAMPP instalado na pasta padrão C:\xampp.

Configurando o certificado SSH local

Primeiro precisamos criar um arquivo de configuração que vamos chamar de domains.ext no diretório C:/xampp/apache. Esse arquivo tem o seguinte conteúdo que você poderá copiar e colar:

C:/xampp/apache/domains.ext

authorityKeyIdentifier=keyid,issuer
basicConstraints=CA:FALSE
keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
subjectAltName = @alt_names
[alt_names]
DNS.1 = localhost
DNS.2 = www.localhost

Uma observação interessante, é que se você quer acessar esse servidor dentro de uma intranet ou precisa de adicionar mais domínios locais, você poderá adicionar abaixo de DNS.1 = localhost o novo dominio DNS.2 = novodominio.exemplo ou o ip da máquina local.

Localize agora o arquivo makecert.bat e acrescentar -sha256 -extfile domains.ext no final da linha com o seguinte conteúdo: bin\openssl x509 -in server.csr -out server.crt -req -signkey server.key -days 500.

C:/xampp/apache/vmakecert.bat

@echo off
set OPENSSL_CONF=./conf/openssl.cnf

if not exist .\conf\ssl.crt mkdir .\conf\ssl.crt
if not exist .\conf\ssl.key mkdir .\conf\ssl.key

bin\openssl req -new -out server.csr
bin\openssl rsa -in privkey.pem -out server.key
bin\openssl x509 -in server.csr -out server.crt -req -signkey server.key -days 365 -sha256 -extfile domains.ext

set OPENSSL_CONF=
del .rnd
del privkey.pem
del server.csr

move /y server.crt .\conf\ssl.crt
move /y server.key .\conf\ssl.key

echo.
echo -----
echo Das Zertifikat wurde erstellt.
echo The certificate was provided.
echo.
pause

O que foi adicionado está destacado em vermelho.

2. Criar o certificado

Agora vamos execitar o makecert.bat. Temos duas formas de fazer isso. A primeira e clicar em cima desse arquivo para ele executar ou fazer isso usando um terminal no modo texto como o cmd e executar digitando makecert.bat e “enter” que criará o os arquivos do certificado e os deixará no lugar certo.

Depois aparecerá na tela várias perguntas, que precisará responder e a seguir tem um exemplo ou informação sobre a a sequencia de perguntas e acrescentei em destaque as respostas ou o que deve ser colocado como resposta.

Generating a RSA private key
……………………………………………..+++++
……………………………………………………………………………+++++
writing new private key to 'privkey.pem'
Enter PEM pass phrase:CRIAR UMA SENHA

Verifying - Enter PEM pass phrase:Redigitar a SENHA

You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,

If you enter '.', the field will be left blank.

Country Name (2 letter code) [AU]:BR 
State or Province Name (full name) [Some-State]:Estado 
Locality Name (eg, city) []:Cidade 
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Nome 
Organizational Unit Name (eg, section) []: 
Common Name (e.g. server FQDN or YOUR name) []:localhost
Email Address []:email@email.com 

Please enter the following 'extra' attributes 
to be sent with your certificate request 
A challenge password []: 
An optional company name []: 
Enter pass phrase for privkey.pem: Digitar novamente a SENHA
writing RSA key 
Signature ok 
subject=C = BR, ST = Parana, L = Londrina, O = WebiG, CN = localhost, emailAddress = lisanias@hotmail.com 
Getting Private key 
Não foi possível encontrar C:\xampp\apache\.rnd 
    1 arquivo(s) movido(s). 
    1 arquivo(s) movido(s). 

-----
Das Zertifikat wurde erstellt. 
The certificate was provided. 

Pressione qualquer tecla para continuar. . .

Com o certificado criado precisa reiniciar o Apache para que ele execute os novos certificados.

Instalar o certificado como confiável

Como não tem nenhuma entidade certificadora externa para abonar esse certificado que criamos, precisamos informar ao Windows e navegador que ele é sim um certificado confiável. Para isso vamos a pasta C:\xampp\apache\conf\ssl.crt e clicamos no arquivo server.crt.

Clique no botão “Instalar Certificado” e avance. Selecione “Usuário Atual” e avance.

Selecionar “Colocar todos os certificados no repositório a seguir” e clicar em “procurar“. Na nova janela que abrir selecionar “Autoridades de Certificação Raiz Confiavel” e clicar em “Ok” e de seguida clique em “Seguinte” e finalmente em “Concluir“.

Para concluir, reinicie o Apache no Painel Administrativo do XAMPP, ou seja para e inicie ele novamente.

Se tudo deu certo, ao atualizar o https://localhost no navegador, devera estar com o cadeado acionado e a página carregada.

Comente se deu certo certo para você também. Se tiver uma forma melhor e mais eficiente, compartilhe nos comentários deste post.