Skip to content

Latest commit

 

History

History
53 lines (34 loc) · 3.62 KB

set-up-credential-managers.md

File metadata and controls

53 lines (34 loc) · 3.62 KB
title titleSuffix description ms.assetid ms.service ms.topic monikerRange ms.subservice ms.date
Connect to your Git repos using credential managers
Azure Repos
Authenticate to Azure Repos and TFS Git repos using credential managers
7779af87-460c-4078-bc2b-ceb4b758c24e
azure-devops-repos
conceptual
<= azure-devops
azure-devops-repos-git
11/13/2020

Use Git Credential Manager to authenticate to Azure Repos

[!INCLUDE version-lt-eq-azure-devops] [!INCLUDE version-vs-gt-eq-2019]

Git Credential Manager simplifies authentication with your Azure Repos Git repositories. Credential managers let you use the same credentials that you use for the Azure DevOps Services web portal. Credential managers support multi-factor authentication through Microsoft account or Microsoft Entra ID. Besides supporting multi-factor authentication with Azure Repos, credential managers also support two-factor authentication with GitHub repositories.

Azure Repos provides IDE support for Microsoft account and Microsoft Entra authentication through the following clients:

If your environment doesn't have an integration available, configure your IDE with a Personal Access Token or SSH to connect to your repositories.

Install Git Credential Manager

Windows

Download and run the latest Git for Windows installer, which includes Git Credential Manager. Make sure to enable the Git Credential Manager installation option.

Select Enable Git Credential Manager during Git for Windows install

macOS and Linux

You may use SSH keys to authenticate to Azure Repos, or you may use Git Credential Manager.

Installation instructions are included in the GitHub repository for GCM. On Mac, we recommend using Homebrew. On Linux, you can install from a .deb or a tarball.

Using the Git Credential Manager

When you connect to a Git repository from your Git client for the first time, the credential manager prompts for credentials. Provide your Microsoft account or Microsoft Entra credentials. If your account has multi-factor authentication enabled, the credential manager prompts you to go through that process as well.

Git Credential Manager prompting during Git pull

Once authenticated, the credential manager creates and caches a personal access token for future connections to the repo. Git commands that connect to this account won't prompt for user credentials until the token expires. A token can be revoked through Azure Repos.

Getting help

You can open and report issues with Git Credential Manager on the project GitHub.