g4e常见问题#1 解决Git在Windows上使用http/https无法认证的问题
来源 | 公众号:DevOps作者 | 徐磊由于 Git 本身托身与 Linux 软件的开发过程,所以在 Linux 和类似的 Mac 环境中使用 Git 具备天然的优势,这也同时造成了在 Windows 上使用Git的困难。这个问题在用户身份认证方面尤其明显,特别是对于企业开发者来说。你可能会在刚开始使用 Git 的时候遇到类似以下的错误信息,特别是针对 Team Foundation Serv
来源 | 公众号:DevOps
作者 | 徐磊
由于 Git 本身托身与 Linux 软件的开发过程,所以在 Linux 和类似的 Mac 环境中使用 Git 具备天然的优势,这也同时造成了在 Windows 上使用Git的困难。
这个问题在用户身份认证方面尤其明显,特别是对于企业开发者来说。你可能会在刚开始使用 Git 的时候遇到类似以下的错误信息,特别是针对 Team Foundation Server 所提供的Git服务器:
Fatal: Authentication failed for …
解决这个问题有2种方式:
方式1 – 强制Git Crdential Manager for Windows使用Basic 认证方式
我们需要针对 Git Credential Manager 进行一定的配置。Git Credential Manager 是一个插件系统,可以允许不同平台通过不同的工具将身份认证信息进行安全保存,避免在操作远程存储库的时候频繁输入用户名和密码。
要解决以上问题,首先确保使用了最新版本的 Git for Windows 安装(至少2.15版本以上),并且在安装的时候配置了以下选项:
注:你还需要 .NET Framework 4.5.1或以上版本才能正常使用。
安装完成后,请通过命令行输入以下命令
运行以下命令
配置完成后就可以正常使用了,第一次从TFS远程存储库克隆代码时Windows会询问你的用户名和密码,输入成功克隆即可开始,后续的操作就不再会弹出了。
你刚才输入的认证信息被保存在 Windows 凭据管理器 里面了。
如果你连接的是VSTS,那么弹出的是类似以下的一个Azure Active Directory (AAD)的登陆窗口,你需要输入你的Live ID。
完成之后,你的身份信息会被存放在Windows凭据管理器,不过存放的是一个叫做PAT (Person Access Token)的令牌。
如果要查看这个令牌,可以通过当前用户的菜单中选择 Security进入 Personal Access Token的配置页面进行查看
你会主要到这个 PAT 只对 Code (read and write) 和 Packing (read)两项内容进行了授权,这是为了确保最小安全性配置。
进入 Windows 凭据管理器管理器,你就可以看到这个凭据已经被保存。
Git Credential Manager for Windows 的工作机制
这个 Credential Manager 会首先尝试使用当前登陆计算机的用户账号连接远程的 TFS 服务器,如果本地计算机和远程 TFS 同在一个 AD 域并且登陆账号已经具备了访问 Git 仓库的权限,则会直接成功;如果不成功则会弹出登陆对话框要求用户登录。
但是如果当前计算机没有在TFS所属的AD域中,则会直接给出Authentication Failed的错误并退出。
这是因为在这个场景下无法直接使用 NTLM 进行身份认证(因为不在同一个域),但是因为TFS返回的信息要求使用NTLM,就会出现以上问题。
我们的解决办法是强制本地的 Credential Manager 使用Basic方式发送用户名和密码,虽然在这种情况下会有一定的安全性问题,但是如果服务器启用了https加密就没有关系了。
方法 2 – 使用SSH Key的方式进行认证
SSH Key 认证方式是在 Linux/MacOS 上非常常见的一种认证方式,在Git中也被很好的支持,如果要在 Windows上使用,首先我们需要使用 cmder 命令行工具生成自己的 ssh key pair。
在 cmder 工具中输入以下命令
注意:以上我使用了所有参数的默认值,特别是passphrase中也使用了空密码,这主要是为了方便在操作存储库的时候不用一直输入密码。
生成的 ssh key pair (包括公钥和私钥文件)会被保存到 c:\users\{当前用户}\.ssh目录中,如下图:
ssh key pair 生成好以后还需要把公钥文件的内容(以上.pub文件)复制到VSTS/TFS服务器的SSH KEY列表中,确保VSTS/TFS服务器可以识别
然后就可以通过ssh url来操作git存储库了,首先获取ssh url如下图
然后使用 git clone命令克隆代码
注:如果使用的是自己搭建的TFS服务器,还需要确保服务器的22端口已经正确打开
小结
以上2种版本都可以确保你在 Windows 上顺利的连接到远程 Git 存储库。
更多推荐
所有评论(0)