Git Credential Manager (GCM) é um auxiliar de credenciais Git seguro desenvolvido em .NET que roda em Windows, macOS e Linux. Seu objetivo é fornecer uma experiência de autenticação consistente e segura, incluindo autenticação multifator, para todos os principais serviços e plataformas de hospedagem de controle de origem.
O GCM oferece suporte (em ordem alfabética) Azure DevOps, Azure DevOps Server (anteriormente Team Foundation Server), Bitbucket, GitHub e GitLab. Compare com os auxiliares de credenciais integrados do Git (Windows: wincred, macOS: osxkeychain, Linux: gnome-keyring/libsecret), que fornecem suporte de autenticação de fator único apenas para nome de usuário/senha.
O GCM substitui o Git Credential Manager baseado em .NET Framework para Windows e o Git Credential Manager baseado em Java para Mac e Linux.
Consulte as instruções de instalação da versão atual do GCM para opções de instalação para seu sistema operacional.
Atualmente, o Git Credential Manager está disponível para Windows, macOS e Linux*. O GCM funciona apenas com controles remotos HTTP(S); você ainda pode usar Git com SSH:
Recurso | Windows | macOS | Linux* |
---|---|---|---|
Instalador/desinstalador | ✓ | ✓ | ✓ |
Armazenamento seguro de credenciais da plataforma (veja mais) | ✓ | ✓ | ✓ |
Suporte de autenticação multifator para Azure DevOps | ✓ | ✓ | ✓ |
Suporte de autenticação de dois fatores para GitHub | ✓ | ✓ | ✓ |
Suporte de autenticação de dois fatores para Bitbucket | ✓ | ✓ | ✓ |
Suporte de autenticação de dois fatores para GitLab | ✓ | ✓ | ✓ |
Suporte à Autenticação Integrada do Windows (NTLM/Kerberos) | ✓ | N / D | N / D |
Suporte básico de autenticação HTTP | ✓ | ✓ | ✓ |
Suporte de proxy | ✓ | ✓ | ✓ |
suporte amd64 | ✓ | ✓ | ✓ |
suporte x86 | ✓ | N / D | ✗ |
suporte arm64 | melhor esforço | ✓ | ✓ |
suporte armhf | N / D | N / D | ✓ |
(*) O GCM garante suporte apenas para as distribuições Linux oficialmente suportadas pelo dotnet.
O Git Credential Manager tenta ser compatível com o conjunto mais amplo de versões do Git (dentro do razoável). No entanto, existem algumas versões problemáticas do Git que não são compatíveis.
Git 1.x
A versão principal inicial do Git não é suportada ou testada com GCM.
Git 2.26.2
Esta versão do Git introduziu uma alteração significativa na análise da configuração de credenciais da qual o GCM depende. Este problema foi corrigido no commit 12294990
do projeto Git e lançado no Git 2.27.0.
Depois de instalado e configurado, o Git Credential Manager é chamado implicitamente pelo Git. Você não precisa fazer nada de especial e o GCM não se destina a ser chamado diretamente pelo usuário. Por exemplo, ao enviar ( git push
) para Azure DevOps, Bitbucket ou GitHub, uma janela será aberta automaticamente e orientará você no processo de entrada. (Esse processo será um pouco diferente para cada host Git e, mesmo em alguns casos, se você estiver conectado a um host Git local ou hospedado na nuvem.) Os comandos Git posteriores no mesmo repositório reutilizarão as credenciais existentes ou tokens que o GCM armazenou enquanto forem válidos.
Leia o uso completo da linha de comando aqui.
Veja informações detalhadas aqui.
Consulte o índice da documentação para obter links para recursos adicionais.
Curioso para saber o que vem a seguir no projeto GCM? Dê uma olhada no roteiro do projeto! Você pode encontrar mais detalhes sobre a construção do roteiro e como interpretá-lo aqui.
Este projeto aceita contribuições e sugestões. Consulte o guia de contribuição para começar.
Este projeto segue o Código de Conduta de Código Aberto do GitHub.
Somos licenciados pelo MIT. Ao usar logotipos do GitHub, certifique-se de seguir as diretrizes do logotipo do GitHub.