Partilhar via

Usar o Git Credential Manager para autenticar no Azure Repos

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

O Git Credential Manager simplifica a autenticação com seus repositórios Git do Azure Repos. Os gestores de credenciais permitem-lhe utilizar as mesmas credenciais que utiliza para o portal Web do Azure DevOps, suportando a autenticação segura através da conta Microsoft ou do Microsoft Entra ID com autenticação multifator incorporada. O Git Credential Manager também suporta autenticação de dois fatores com repositórios GitHub.

Opções de autenticação

O Git Credential Manager suporta vários métodos de autenticação, com tokens de ID do Microsoft Entra sendo a abordagem recomendada para segurança aprimorada:

  • Tokens de ID do Microsoft Entra (recomendado): Fornece segurança aprimorada com vida útil mais curta do token e melhor integração com políticas organizacionais.
  • Autenticação de conta Microsoft: contas Microsoft pessoais com suporte para autenticação multifator.
  • Tokens de acesso pessoal: disponíveis como alternativa, embora recomendemos o uso de tokens de ID do Microsoft Entra quando possível.

Integração IDE

O Azure Repos fornece suporte IDE para conta Microsoft e autenticação Microsoft Entra através dos seguintes clientes:

Se seu ambiente não tiver uma integração disponível, você poderá configurar seu IDE com tokens Microsoft Entra ID (recomendado), Tokens de Acesso Pessoal ou SSH para se conectar aos seus repositórios.

Importante

Recomendamos os tokens Microsoft Entra mais seguros do que os tokens de acesso pessoal de maior risco. Saiba mais sobre os nossos esforços para reduzir a utilização de PAT. Reveja as nossas orientações de autenticação para escolher o mecanismo de autenticação certo para as suas necessidades.

Instalar o Git Credential Manager

Windows

Baixe e execute o mais recente instalador do Git para Windows, que inclui o Git Credential Manager. Certifique-se de ativar a opção de instalação do Git Credential Manager.

Captura de tela mostra a seleção Ativar o Git Credential Manager durante a instalação do Git para Windows.

macOS e Linux

Você pode usar chaves SSH para autenticar no Azure Repositórios ou usar o Git Credential Manager.

As instruções de instalação estão incluídas no repositório GitHub para GCM. No Mac, recomendamos o uso do Homebrew. No Linux, você pode instalar a partir de um .deb ou um tarball.

Usando o Git Credential Manager

Quando você se conecta a um repositório Git do seu cliente Git pela primeira vez, o gerenciador de credenciais solicita credenciais. Forneça a sua conta Microsoft ou credenciais do Microsoft Entra. Se sua conta tiver a autenticação multifator habilitada, o gerenciador de credenciais solicitará que você também passe por esse processo.

solicitação do Git Credential Manager durante o pull do Git

Uma vez autenticado, o gerenciador de credenciais cria e armazena em cache um token para conexões futuras com o repositório. Os comandos do Git que se conectam a essa conta não solicitam credenciais de usuário até que o token expire. Um token pode ser revogado por meio do Azure Repos.

Por padrão, o GCM pode solicitar diferentes tipos de tokens de autenticação do Azure Repos. Você pode configurar a autenticação padrão do Git para usar tokens de ID do Microsoft Entra, que fornecem segurança aprimorada por meio de protocolos OAuth. Recomendamos esta abordagem para uma melhor segurança e integração com as políticas organizacionais. Saiba mais sobre usando o GCM com Azure Repos.

git config --global credential.azreposCredentialType oauth

Usar o principal de serviço como autenticação

Você também pode fornecer um principal de serviço para autenticação com o GCM. Especifique os IDs de cliente e inquilino de um principal de serviço neste formato: {tenantId}/{clientId}.

git config --global credential.azreposServicePrincipal "11111111-1111-1111-1111-111111111111/22222222-2222-2222-2222-222222222222"

Você também deve definir pelo menos um mecanismo de autenticação se definir este valor:

Obter ajuda

Você pode abrir e relatar problemas com o Git Credential Manager no projeto GitHub.