Back to Git Credential Manager

Migration Guide

docs/migration.md

2.8.01.4 KB
Original Source

Migration Guide

Migrating from Git Credential Manager for Windows

GCM_AUTHORITY

This setting (and the corresponding credential.authority configuration) is deprecated and should be replaced with the GCM_PROVIDER (or corresponding credential.authority configuration) setting.

Because both Basic HTTP authentication and Windows Integrated Authentication (WIA) are now handled by one provider, if you specified basic as your authority you also need to disable WIA using GCM_ALLOW_WINDOWSAUTH / credential.allowWindowsAuth.

The following table shows the correct replacement for all legacy authorities values:

GCM_AUTHORITY (credential.authority)GCM_PROVIDER (credential.provider)GCM_ALLOW_WINDOWSAUTH (credential.allowWindowsAuth)
msa, microsoft, microsoftaccount, aad, azure, azuredirectory, live, liveconnect, liveidazure-reposN/A
githubgithubN/A
basicgenericfalse
integrated, windows, kerberos, ntlm, tfs, ssogenerictrue (default)

For example if you had previous set the authority for the example.com host to basic..

shell
git config --global credential.example.com.authority basic

..then you can replace this with the following..

shell
git config --global --unset credential.example.com.authority
git config --global credential.example.com.provider generic
git config --global credential.example.com.allowWindowsAuth false