Controllr/Manual/Certificado SSL

De BrByte Wiki
< Controllr‎ | Manual
Revisão de 11h34min de 1 de abril de 2024 por Thiago (discussão | contribs)

Certificado SSL

Ensinaremos como criar o certificado de criptografia SSL gratuito[1], através do Let´s Encrypt, para que possa usar no Controllr. Com isso conseguir usar os nosso Apps do Cliente e do Técnico.
O Certificado SSL (Secure Sockets Layer, ou Camada de Soquetes Segura) é um protocolo que foi desenvolvido pela empresa Netscape. O certificado serve para proteger os dados de uma navegação na internet com o servidor WEB. Essa proteção é feita de forma criptografada, evitando a invasão de pessoas mal-intencionadas à capturar o seus dados. A forma de identificar que um site é seguro será através da sigla HTTPS (Hyper Text Transfer Protocol Secure, ou Protocolo de Transferência de Hipertexto Seguro).

Para poder usar o certificado de criptografia SSL é necessário TER UM DOMÍNIO[2]

Ensinaremos a gerar o certificado, usando o Windows 10 ou superior (não serve outra versão do windows abaixo dele) através do WSL (Windows Subsystem for Linux).

Linux dentro do Windows

Para começar no seu WINDOWS 10 abra o PowerShell como administrador.

  • Tecle na janela do Windows + (digite) powershell > (opção) Execute como Administrador.
Controllr-manuais-certificadossl-powershell.png
  • Depois que abrir o PowerShell irá rodar um comando para habilitar um recurso opcional Subsistema do Windows para Linux
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
Controllr-manuais-certificadossl-powershell-execute.gif


  • Agora irá realizar a instalação do Ubuntu no seu Windows. Acesse a loja da Microsoft Store do seu Windows 10 e busque pelo Ubuntu. Atalho para instalação do Ubuntu clique aqui!


  • Na primeira vez que você iniciar uma distribuição do Linux recém-instalada, uma janela de console será aberta e será solicitado que você aguarde um ou dois minutos para que os arquivos sejam descompactados e armazenados em seu PC. Todas as futuras inicializações deverão levar menos de um segundo. Em seguida, você precisará criar uma conta de usuário e uma senha para sua nova distribuição do Linux.


Controllr-manual-certificadossl-ubuntu-install.gif


  • Irá seguir os seguintes passos com os comandos.
    • Acesse o Ubuntu como root
      • sudo -i
    • Atualize os pacotes
      • apt-get update
    • Instale o Certbot
      • sudo snap install --classic certbot
  • Após esses processos, será a parte da criação do certificado.
    • Rode o comando a seguir substituindo o domino.do.provedor.com pelo o seu domínio.
      • certbot -d *.dominio.do.provedor.com -d dominio.do.provedor.com --manual --preferred-challenges dns certonly
    • Após rodar estes comandos com a devida substituição, irá aparecer uma mensagem perguntando se deseja prosseguir. Digite Y e aperte enter.
Controllr-manuais-cerrtificadossl-letsencrypt-yes.png


  • Na próxima mensagem, você só irá apertar enter depois que configurar uma entrada TXT no seu servidor de DNS. A chave aparecerá no seu terminal e é essa que deverá propagar.
Controllr-manuais-cerrtificadossl-letsencrypt-enter.png


  • _acme-challenge.dominio.com.br.   300     IN      TXT     "2BuWOB94c9lC5EXT8V6h3...................."
  • Após isso deve esperar propagar nos servidores mundiais. Poderá usar esse site para conferir https://dnschecker.org
Controllr-manuais-certificadossl-letsencrypt-propagacao.png


  • Usando o NSLOOKUP no prompt de comando do seu windows.
C:\Users\Miguelito>nslookup -q=txt _acme-challenge.dominio.do.provedor.com 8.8.8.8
Servidor:  dns.google
Address:  8.8.8.8

Não é resposta autoritativa:
_acme-challenge.dominio.do.provedor.com      text =

        "-VChlSZBBiC-"
  • Depois que confirmar a propagação, pode apertar o enter no terminal do seu Ubuntu.
Controllr-manuais-cerrtificadossl-letsencrypt-enter.png


  • Se tudo der certo irá aparecer uma mensagem de congratulations, mostrando o caminho aonde se encontra os certificados gerados. Você pode copia-los para outro local de sua preferencia.
Controllr-manuais-cerrtificadossl-letsencrypt-congratulations.png


# criar um diretório
mkdir -p /mnt/c/certificado
# copiar para esse diretório
cp /etc/letsencrypt/live/dominio.do.provedor.com/* /mnt/c/certificado
  • Agora acesse o diretório criado C:\certificado. Verá os seguintes arquivos:
cert.pem
chain.pem
fullchain.pem
privkey.pem
README
  • Renomeie os seguintes arquivos
fullchain.pem >> server.crt
privkey.pem >> server.key
  • Acesse o seu Controllr e vá no Hotsite. Depois acesse a Configuração.
  • Vá na opção do Menu /ssl.
  • Envie o texto dos arquivo que você renomeou Certificado = server.crt e Chave = server.key
  • Por fim clique em Salvar e acesse o seu Hotsite com HTTPS, para testar o certificado SSL. A validade do certificado SSL gratuito do Let's Encrypt é de 90 dias, sendo necessário a sua renovação após esse período.[3]
Controllr-aplicativo-hotsite-configuracao-ssl.png