Solucionar problemas de certificado SSL do Git: Um guia passo-a-passo Se alguma vez tentaste clonar, recuperar ou fazer push para um repositório Git e recebeste um problema de certificado SSL, podes compreender como pode ser frustrante. De repente, a tua produtividade reduz-se a uma paragem, colocando-te a olhar para uma mensagem de erro que pode estar noutra língua.
Não te preocupes, não estás sozinho! Em particular, quando trabalhas com repositórios remotos, os problemas com certificados SSL são frequentes. A boa notícia é que, com as informações corretas, eles geralmente podem ser facilmente corrigidos. Vamos guiar-te pelo processo de depuração das dificuldades do certificado SSL do Git, passo a passo, neste artigo. Este guia foi projetado para ajudar desenvolvedores de todos os níveis de habilidade a voltar ao caminho certo.
Além disso, é provável que descubras que muitos desses problemas são bastante simples de resolver com a Cloudways Platform e seus recursos gerenciados, se você estiver utilizando-a para hospedar seus aplicativos. Vamos apenas começar!
Quais são os problemas do certificado Git SSL?
Agora podes ver que os certificados SSL/TLS estão a ser utilizados para encriptar a tua ligação quando te ligas a um repositório Git remoto, como o GitHub, GitLab, ou talvez um servidor privado. Estes certificados são usados para garantir que estás a comunicar com o servidor correto e que os teus dados estão completamente seguros. No entanto, o Git lançará um erro se houver um problema com o certificado SSL, como expirar, ser autoassinado ou até mesmo não ser confiável para o teu sistema. Aqui estão alguns erros típicos e comuns que podes encontrar:
- Problema com o certificado SSL: não é possível obter o certificado do emissor local
- Problema com o certificado SSL: certificado auto-assinado
- Problema com o certificado SSL: o certificado expirou
Como já foi dito, há várias razões para que estes erros possam ocorrer, mas vamos discutir cada uma delas nesta publicação do blogue.
Passo 1: Verifica o URL do teu repositório remoto
Antes de começarmos a depuração SSL, vamos certificar-nos de que o problema não é algo tão simples como um erro no URL do teu repositório. Agora abre o teu terminal ou prompt de comando para executar o seguinte comando para verificar o teu URL remoto: git remote -v Este comando irá mostrar-te os URLs para fetch e push. Portanto, se o teu URL parecer errado (por exemplo, está a apontar para http:// em vez de https://), actualiza-o utilizando o seguinte comando: git remote set-url origin Podes substituir o URL do teu repositório pelo texto de exemplo. Isso é importante porque se a URL estiver incorreta, o Git não conseguirá se conectar ao repositório, muito menos verificar o certificado SSL.
git remote -v/pre>
Passo 2: Atualizar os certificados CA do teu sistema
Agora deves saber que o Git depende do armazenamento de certificados do teu sistema para verificar os certificados SSL. Se os teus certificados estiverem desactualizados, o Git não confiará no certificado do servidor remoto e, eventualmente, receberás um erro. Aqui está como te podes livrar deste problema.
Para utilizadores do Windows:
Terás de transferir o pacote de certificados CA mais recente a partir do site oficial do curl. Depois guarda o ficheiro como ca-bundle.crt no teu diretório de instalação do Git, por exemplo (C:\Program Files\Git\usr\ssl).
Terás de dizer ao Git para utilizar este novo pacote de certificados, executando o seguinte comando:
git config --global http.sslCAinfo "C:/Program Files/Git/usr/ssl/ca-bundle.crt"
Para utilizadores de macOS/Linux:
Terás de atualizar os certificados CA do teu sistema utilizando o teu gestor de pacotes. Eis como o podes fazer utilizando o seguinte comando:
# Para macOS (usando Homebrew)
instala o ca-certificates
# Para Ubuntu/Debian
sudo apt-get install --reinstall ca-certificates
# Para CentOS/RHEL
sudo yum reinstala o ca-certificates
Porque é que isto é importante? Como vês, os certificados desactualizados não conseguem verificar os certificados SSL mais recentes, por isso, para resolver o problema, actualizamo-los para garantir que o nosso sistema pode confiar no servidor remoto.
Etapa 3: Desativar temporariamente a verificação SSL (use com cuidado!)
Agora, se estiveres com pressa e precisares de uma solução rápida, podes desativar temporariamente a verificação SSL. Mas tem cuidado, isto não é seguro e só deve ser utilizado para testes. Podes executar o seguinte comando para desativar a verificação SSL:
git config --global http.sslVerify false
Quando terminares o teste, terás de voltar a ativar a verificação SSL executando o seguinte comando, pois é muito importante que esteja activada:
git config --global http.sslVerify true
Como vês, desativar a verificação SSL ignora totalmente a verificação do certificado, o que te pode ajudar a identificar se o problema está relacionado com SSL ou se precisas de investigar o assunto com uma abordagem diferente. No entanto, deixa a tua ligação sem encriptação, por isso não a uses como uma solução permanente.
Passo 4: Certificados auto-assinados
Outra solução pode ser se estiveres a trabalhar com um repositório que utiliza um certificado auto-assinado (o que é bastante comum em servidores privados ou internos), terás de confiar explicitamente no certificado. Vê aqui como:
Terás de exportar o certificado, executando o seguinte comando para transferir o certificado do servidor:
openssl s_client -connect <seu-servidor-git>:443 -showcerts </dev/null 2>/dev/null | openssl x509 -outform PEM > git-server-cert.pem
Agora tens de substituir pelo domínio ou endereço IP do teu servidor. Podes adicionar o certificado ao Trusted Store do teu sistema utilizando os seguintes comandos:
Para macOS/Linux:
sudo cp git-server-cert.pem /usr/local/share/ca-certificates/ sudo update-ca-certificates
Para Windows:
Abre o menu Iniciar, procura por “Gerir Certificados de Computador” e importa o ficheiro .pem para o armazenamento “Autoridades de Certificação Raiz Confiáveis”. Podes dizer ao Git para Utilizar o Certificado executando o seguinte comando:
git config --global http.sslCAinfo /path/to/git-server-cert.pem
Isto é importante porque os certificados auto-assinados não são de confiança por predefinição, pelo que tens de os adicionar manualmente aos certificados de confiança do teu sistema.
Passo 5: Verifica a data e a hora do teu sistema
Os certificados SSL são sensíveis ao tempo. Se a data e a hora do teu sistema estiverem incorrectas, o Git poderá rejeitar certificados válidos.
Para macOS/Linux:
Podes sincronizar o teu relógio utilizando o seguinte comando:
sudo ntpdate pool.ntp.org
Para Windows:
Abre as definições de Data e Hora e sincroniza o teu relógio com um servidor de horas da Internet. Se o relógio do teu sistema estiver desligado, isso pode fazer com que os certificados SSL pareçam expirados ou inválidos.
Passo 6: Simplifica o teu fluxo de trabalho com a Cloudways
A solução de problemas de SSL pode consumir muito tempo, mas plataformas como a Cloudways facilitam o gerenciamento de seus aplicativos e implantações. Veja como a Cloudways pode ajudar:
- Implantação do Git com um clique: Implementa os teus repositórios sem te preocupares com as configurações SSL.
- Certificados SSL geridos: Gera e renova automaticamente certificados SSL para as tuas aplicações.
- Suporte especializado 24 horas por dia, 7 dias por semana: Obtém ajuda de profissionais certificados sempre que precisares.
Com Cloudways, podes concentrar-te na codificação enquanto a plataforma trata dos detalhes técnicos.
Simplificando os fluxos de trabalho com a Cloudways
Hospeda seus projetos na Cloudways para obter um desempenho rápido, seguro e escalável. Começa hoje mesmo!
Conclusão
Os problemas com o certificado Git SSL podem ser uma dor de cabeça, mas normalmente são fáceis de resolver quando sabes o que fazer. Desde atualizar seus certificados até confiar em certificados autoassinados, este guia cobre todas as etapas necessárias para resolver esses erros. Lembra-te de que, embora as correcções temporárias, como desativar a verificação SSL, possam ajudar, não são seguras para utilização a longo prazo. Procura sempre uma solução adequada para manter as tuas ligações seguras. Se estiveres à procura de uma plataforma que simplifique as implementações do Git e a gestão do SSL, a Cloudways é uma excelente escolha. Com sua interface amigável e recursos robustos, o Cloudways garante que seu fluxo de trabalho de desenvolvimento seja suave e eficiente. Experimenta hoje e vê a diferença por ti mesmo!
Perguntas frequentes
P: Quais são as causas dos erros do certificado Git SSL?
Estes erros ocorrem quando o teu sistema não consegue verificar o certificado SSL do repositório remoto, muitas vezes devido a certificados desactualizados, configurações incorrectas ou certificados auto-assinados.
P: É seguro desativar a verificação SSL no Git?
Não, não é seguro para utilização a longo prazo, uma vez que expõe a tua ligação a riscos de segurança. Utiliza-a apenas como uma solução temporária.
P: Como a Cloudways ajuda nas implementações do Git?
A Cloudways oferece implementação do Git com um clique, certificados SSL gerenciados e suporte especializado 24 horas por dia, 7 dias por semana, facilitando o gerenciamento de seus repositórios e aplicativos.
Salwa Mujtaba
Salwa Mujtaba é redatora de conteúdo técnico na Cloudways. Com uma sólida formação em Ciência da Computação e experiência anterior como líder de equipe em Operações da Cloudways, ela traz uma profunda compreensão da Plataforma Cloudways para sua escrita. Salwa cria conteúdo que simplifica conceitos complexos, tornando-os acessíveis e envolventes para os leitores. Quando não está a escrever, podes encontrá-la a apreciar boa música, a ler um livro ou a passar tempo de qualidade com a sua família.
