Git 身份验证

Cargo 在使用 git 依赖项和注册表时支持某些形式的身份验证。本附录包含一些有关以 Cargo 可行的方式设置 git 身份验证的信息。

如果您需要其他身份验证方法，可以设置 net.git-fetch-with-cli 配置值，使 Cargo 执行 git 可执行文件来处理远程仓库的获取，而不是使用内置支持。可以使用 CARGO_NET_GIT_FETCH_WITH_CLI=true 环境变量启用此功能。

HTTPS 身份验证

HTTPS 身份验证需要 credential.helper 机制。有多种凭据助手，您可以在全局 git 配置文件中指定要使用的助手。

# ~/.gitconfig

[credential]
helper = store

Cargo 不会询问密码，因此对于大多数助手，您需要在运行 Cargo 之前向助手提供初始用户名/密码。一种方法是运行私有 git 仓库的 git clone 并输入用户名/密码。

提示

macOS 用户可以考虑使用 osxkeychain 助手。

Windows 用户可以考虑使用 GCM 助手。

**注意：**Windows 用户需要确保 sh shell 在您的 PATH 中可用。这通常在 Git for Windows 安装中可用。

SSH 身份验证

SSH 身份验证需要运行 ssh-agent 来获取 SSH 密钥。确保设置了适当的环境变量（大多数类 Unix 系统上的 SSH_AUTH_SOCK），并添加了正确的密钥（使用 ssh-add）。

Windows 可以使用 Pageant（PuTTY 的一部分）或 ssh-agent。要使用 ssh-agent，Cargo 需要使用 Windows 发行版中包含的 OpenSSH，因为 Cargo 不支持 MinGW 或 Cygwin 使用的模拟 Unix 域套接字。有关使用 Windows 进行安装的更多信息，请参阅Microsoft 安装文档，密钥管理页面上有关于如何启动 ssh-agent 和添加密钥的说明。

**注意：**Cargo 不支持 git 的 SSH URL 简写形式，例如 [email protected]:user/repo.git。请使用完整的 SSH URL，例如 ssh://[email protected]/user/repo.git。

**注意：**Cargo 的内置 SSH 库不使用 SSH 配置文件（例如 OpenSSH 的 ~/.ssh/config）。更高级的要求应使用 net.git-fetch-with-cli。

SSH 已知主机

连接到 SSH 主机时，Cargo 必须使用“已知主机”验证主机的身份，“已知主机”是主机密钥列表。Cargo 可以在其标准位置（主目录中的 .ssh/known_hosts，或类 Unix 平台上的 /etc/ssh/ssh_known_hosts 或 Windows 上的 %PROGRAMDATA%\ssh\ssh_known_hosts）中查找 OpenSSH 风格的 known_hosts 文件。有关这些文件的更多信息，请参阅 sshd 手册页。或者，可以在 Cargo 配置文件中使用 net.ssh.known-hosts 配置密钥。

在配置已知主机之前连接到 SSH 主机时，Cargo 将显示一条错误消息，指示您如何添加主机密钥。这还包括一个“指纹”，它是主机密钥的较小哈希值，应该更容易进行视觉验证。服务器管理员可以通过对公钥运行 ssh-keygen 来获取指纹（例如，ssh-keygen -l -f /etc/ssh/ssh_host_ecdsa_key.pub）。知名网站可能会在网上发布其指纹；例如，GitHub 在 https://githubdocs.cn/en/authentication/keeping-your-account-and-data-secure/githubs-ssh-key-fingerprints 上发布其指纹。

Cargo 内置了 github.com 的主机密钥。如果这些密钥发生更改，您可以将新密钥添加到配置文件或 known_hosts 文件中。

**注意：**Cargo 不支持 known_hosts 文件中的 @cert-authority 或 @revoked 标记。要使用此功能，请使用 net.git-fetch-with-cli。如果 Cargo 的 SSH 客户端的行为不符合您的预期，这也是一个很好的建议。