Git Credential Manager

Git Credential Manager (GCM) é um auxiliar de credenciais do Git gratuito e de código aberto para desenvolvedores que se autenticam em repositórios remotos. O Git o chama quando são necessárias credenciais; ele não é um cofre de senhas de uso geral nem um cliente Git de desktop completo.

Recursos • Autentique-se no GitHub, GitHub Enterprise, Azure DevOps/Repos, Bitbucket e GitLab, incluindo fluxos compatíveis de autenticação multifator e OAuth. • Reutilize credenciais ou tokens válidos nas operações do Git e armazene credenciais no Chaveiro do macOS por padrão no Mac. • Use autenticação pelo navegador ou por código de dispositivo quando disponível e integre a autenticação da Microsoft ao broker do sistema operacional em dispositivos compatíveis e configurados. • Lide com proxies de rede e ofereça comandos de diagnóstico para solucionar problemas de autenticação e configuração do armazenamento de credenciais.

Instalação e uso Instale o pacote para Mac com brew install --cask git-credential-manager ou abra o instalador .pkg oficial adequado à arquitetura e siga as instruções. O instalador pode exigir permissão de administrador. É necessário ter o Git para usar este auxiliar de credenciais. Depois de instalado e configurado, use seu fluxo de trabalho normal do Git com uma URL de repositório HTTP(S); o Git invoca o GCM e pode abrir uma solicitação de autenticação. As operações seguintes reutilizam tokens armazenados ainda válidos. O GCM não substitui a autenticação com chave SSH; configure o SSH separadamente ao usar um remoto SSH. Verifique a configuração do auxiliar antes de adicionar auxiliares de credenciais duplicados. O guia oficial fornece git-credential-manager configure para instalações que precisam de configuração e git-credential-manager diagnose para solução de problemas.

Requisitos e compatibilidade Para o GCM 3.x, o projeto upstream oferece suporte ao macOS 14 Sonoma ou posterior. Há pacotes para Apple Silicon; o suporte a Macs Intel é oferecido como melhor esforço. Os metadados atuais de Homebrew não expressam esse requisito mínimo de sistema operacional do projeto upstream, portanto o objeto de dependências vazio não deve ser interpretado como suporte a versões mais antigas do macOS. Os pacotes independentes para cada plataforma incluem o necessário e não exigem uma instalação separada do .NET. A instalação alternativa como ferramenta .NET requer o SDK do .NET 10. O Git 1.x não é compatível; o projeto upstream identifica o Git 2.26.2 como incompatível e informa que a correção foi lançada no Git 2.27.0. A documentação citada não informa requisitos fixos de RAM nem de espaço em disco após a instalação. O cask para Mac não lista conflito explícito com cask nem dependência adicional de fórmula; configurações mais antigas do GCM/helper Java podem precisar de migração, em vez de configuração paralela.

Broker da Microsoft e outras plataformas A autenticação pelo broker da Microsoft é ativada por padrão quando há suporte. No Mac, ela requer o Intune Company Portal e o registro do dispositivo. Esse requisito se aplica a esse método de autenticação, não à instalação básica do GCM nem à autenticação do GitHub. As políticas da organização podem solicitar o registro do dispositivo; consulte o guia oficial do broker antes de entrar em uma conta em um dispositivo pessoal. É possível desativar essa opção com git config --global credential.msauthUseBroker false e usar um fluxo apropriado sem broker. O GCM 3.x também oferece suporte ao Windows 10+, Windows Server 2016+ e distribuições Linux compatíveis com o .NET 10. O Linux requer um armazenamento de credenciais configurado explicitamente e as dependências de runtime da distribuição escolhida; a variação para Linux do Homebrew lista ICU. Os binários oficiais de lançamento para Windows x86 são removidos em 3.0.1. Este pacote para Mac não instala uma edição para Windows ou Linux.

Contas, custo e licença O GCM é gratuito, sob a licença MIT, e não exige uma assinatura separada do GCM. A autenticação requer uma conta ou credenciais aceitas pelo provedor do repositório; hospedagem, acesso organizacional e serviços de nuvem têm permissões, termos e possíveis cobranças próprios. A autenticação pela rede requer conectividade. O GCM 3.x usa tokens OAuth renováveis por padrão para o Azure Repos, mas as configurações explícitas de PAT continuam sendo respeitadas.

Fontes oficiais https://github.com/git-ecosystem/git-credential-manager https://github.com/git-ecosystem/git-credential-manager/blob/v3.0.1/docs/install.md https://github.com/git-ecosystem/git-credential-manager/blob/v3.0.1/docs/credstores.md https://github.com/git-ecosystem/git-credential-manager/blob/v3.0.1/docs/msauth-broker.md https://github.com/git-ecosystem/git-credential-manager/releases/tag/v3.0.1 https://github.com/git-ecosystem/git-credential-manager/blob/v3.0.1/LICENSE Os detalhes de Cask vêm dos metadados atuais de Homebrew. As imagens são exemplos da documentação oficial com contas ilustrativas; a interface do broker varia conforme a plataforma e a configuração. O tamanho do download corresponde ao arquivo .pkg para Apple Silicon 3.0.1, não ao espaço em disco após a instalação.