Git Credential Manager for Windows

Windows的GIT凭据管理器

---

注意：不再维护此项目。配x

Windows的GIT凭据管理器不再维护。跨平台GIT凭证管理器Core（GCM Core）是官方替代者。

GCM Core作为Windows 2.28的GIT的可选组件包括在内，并将成为Windows 2.29的Git默认凭证助手。 GCM Core也可以从此页面手动安装。

---

注意：遇到GitHub推送/提取问题？

GitHub将禁用Windows用途的API GIT凭据管理器上的基于密码的身份验证以创建令牌。结果，Windows的GCM将不再能够为GitHub创建新的访问令牌。

GIT凭证管理器Core（GCM Core）支持GITHUB基于OAUTH的身份验证，是Windows GCM的替代。

请更新Windows 2.28的git，并在要求“选择凭据助手”或手动安装GCM Core时，从安装程序中选择“ Git凭据管理器核心”。

---

截至2018年2月22日，GitHub已禁用对弱加密的支持，这意味着许多用户会突然发现自己无法使用git使用git进行身份验证（影响比V2.16.0年龄大的版本）。不要惊慌，有一个解决方案。更新Windows的git到最新的（或至少v2.16.0）。

用户看到的最常见错误看起来像：

 fatal: HttpRequestException encountered.
   An error occurred while sending the request.
fatal: HttpRequestException encountered.
   An error occurred while sending the request.
Username for 'https://github.com':

如果在更新Windows的Git之后，您仍在使用GitHub身份验证的问题，请阅读此开发人员社区主题，其中包含您可以采取的其他补救措施来解决该问题。

如果您在使用Visual Studio时遇到问题，请阅读无法通过Visual Studio连接到GitHub 。

---

Windows（GCM）的GIT凭据管理器为Windows提供了安全的GIT凭据存储。它是Windows凭证商店的后继产品（Git-Credential-Winstore），这是不再维护的。与GIT的Windows内置凭证存储（WinCred）相比，该存储提供了在任何启用HTTP的GIT存储库上使用的单因素身份验证支持，GCM为Azure Devops，Team Foundation Server，Github和Bitbucket提供了多因素身份验证支持。

该项目包括：

• 在Windows凭据存储中保护密码存储。
• 对Azure Devops的多因素身份验证支持。
• GitHub的两因素身份验证支持。
• Bitbucket的两因素身份验证支持。
• 个人访问代币的生成和对Azure Devops，Github和Bitbucket的使用支持。
• Azure DevOps支持Azure目录的非相互作用模式支持。
• Team Foundation Server的NTLM/Kerberos身份验证（请参阅注释）。
• 构建代理优化的可选设置。

社区

这是一个社区项目，因此可以随意贡献想法，提交错误，修复错误或代码新功能。有关GCM工作原理的详细信息，请访问Wiki。

下载并安装

要使用GCM，您可以下载最新的安装程序。要安装，双击GCMW-{version}.exe并按照显示的说明进行操作。

当提示您选择终端模拟器进行Git Bash时，您应该选择Windows的默认控制台窗口，或确保将GCM配置为使用模态对话框。 GCM无法在薄荷设置中提示您在控制台上获得凭据。

手动安装

注意对于有特殊安装需求的用户，您仍然可以提取gcm-{version}.zip文件并从管理员命令提示符运行install.cmd。这允许指定下面说明的安装选项。

在MSYS2环境中安装

要在MSYS2环境中使用GCM以及与pacman安装的GIT，只需下载释放zip，然后将内容直接提取到C:msys64usrlibgit-core （假设您的MSYS2环境安装在C:msys64中）。然后运行：

git config --global credential.helper manager

如何使用

你没有。当需要凭据时，它神奇地起作用。例如，当推到Azure DevOps时，它会自动打开一个窗口并初始化OAuth2流以获取令牌。

从来源构建和安装

要自己构建并安装GCM，请克隆来源，在Visual Studio中打开解决方案文件，然后构建解决方案。所有必要的组件将从构建输出位置复制到解决方案根部的A。 .Deploy文件夹中。在.Deploy文件夹中的高架命令提示符中发出以下命令git-credential-manager install 。有关开发和调试的其他信息可在我们的文档区域内获得。

各种选项可用于唯一配置的系统，例如自动化构建系统。对于非标准git放置的系统，请使用--path <git>参数，以提供GIT所在的位置以及应部署GCM的位置。对于希望避免检查Microsoft .NET框架和其他类似先决条件的系统，请使用--force选项。对于寻求无需任何提示的无静止安装的系统，请使用--passive选项。

其他资源

• 凭证管理器的使用情况
• AskPass用法
• 配置选项
• 建立代理和自动化支持
• Bitbucket具体细节
• 常见问题
• 开发和调试

贡献

有很多贡献的方法。

• 提交错误并帮助我们核实修复程序。
• 评论代码更改。
• 贡献错误修复和功能。

代码贡献

对于代码贡献，您将需要完成贡献者许可协议（CLA）。简而言之，本协议证明您允许我们根据项目许可条款使用提交的更改，并且提交的工作属于适当的版权。

在提交拉动请求之前，请提交贡献者许可协议（CLA）。您可以访问https://cla.microsoft.com以数字签名。或者，下载协议Microsoft贡献许可协议。pdf，签名，扫描，然后将其发送回[email protected]。确保将您的GitHub用户名与协议一起包含。收到签名的CLA后，我们将查看请求。

行为守则

该项目采用了Microsoft开源的行为代码。有关更多信息，请参见《行为守则常见问题守则》或与其他问题或评论联系[email protected]。

执照

该项目使用MIT许可证。