Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

SSH 与 Amazon CodeCommit 的连接问题排查

以下信息可帮助您排查在使用 SSH 连接到 CodeCommit 存储库时的常见问题。

访问错误：已将公有密钥成功上传到 IAM，但在 Linux、macOS 或 Unix 系统上进行连接时失败

问题：尝试连接到 SSH 端点以与 CodeCommit 存储库通信时，测试连接或克隆存储库的操作出现连接失败或连接被拒绝。

可能的修复措施：分配给 IAM 中公有密钥的 SSH 密钥 ID 可能未关联到您尝试的连接。您可能尚未配置配置文件、您可能无权访问配置文件、其他设置可能导致系统无法成功读取配置文件、您可能提供了错误的密钥 ID 或者您可能提供了 IAM 用户 ID 而不是密钥 ID。

您可以通过 IAM 控制台在 IAM 用户的配置文件中找到 SSH 密钥 ID：

尝试使用下面的命令测试连接：

ssh Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com

如果在确认连接后看到成功消息，说明您的 SSH 密钥 ID 是有效的。编辑配置文件，将您尝试的连接关联到 IAM 中的公有密钥。如果您不想编辑配置文件，可以在所有存储库连接前面加上 SSH 密钥 ID。例如，如果需要克隆名为 MyDemoRepo 的存储库，但不想修改与连接关联的配置文件，可以键入下面的命令：

git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

有关更多信息，请参阅适用于 Linux、macOS 或 Unix 上的 SSH 连接。

访问错误：已将公有密钥成功上传到 IAM 并且 SSH 测试成功，但在 Windows 系统上进行连接时失败

问题：尝试使用 SSH 端点克隆 CodeCommit 存储库或与之通信时，出现一条错误消息，其中包含 No supported authentication methods available 字样。

可能的修复措施：导致该错误的最常见原因是您设置的某个 Windows 系统环境变量指示 Windows 在您尝试使用 SSH 时使用其他的程序。例如，您可能设置了 GIT_SSH 变量，将其指向了某个 PuTTY 工具集 (plink.exe)。这可能是一个旧式配置，或计算机上安装的一个或多个其他程序需要该配置。如果确定不需要该环境变量，可以打开系统属性来将其删除。

要解决这个问题，请打开 Bash 仿真器，再次尝试 SSH 连接，但包含 GIT_SSH_COMMAND="SSH" 作为前缀。例如，要使用 SSH 克隆存储库：

GIT_SSH_COMMAND="ssh" git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

如果您的 Windows 版本要求在 Windows 命令行中通过 SSH 进行连接时必须将 SSH 密钥 ID 包含在连接字符串中，也可能会出现类似问题。尝试再次连接，这次请在命令中包含从 IAM 复制的 SSH 密钥 ID。例如：

git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

身份验证质询：连接到 CodeCommit 存储库时，无法确认主机的真实性

问题：尝试使用 SSH 端点与 CodeCommit 存储库通信时，出现一条警告消息，其中包含 The authenticity of host 'host-name' can't be established. 字样。

可能的修复措施：您的凭证设置可能不正确。按照适用于 Linux、macOS 或 Unix 上的 SSH 连接 或适用于 Windows 上的 SSH 连接 中的说明操作。

如果按照上述步骤操作后，问题仍然存在，可能是有人正在尝试实施中间人攻击。如果看到下面的消息，请键入 no 并按 Enter。

Are you sure you want to continue connecting (yes/no)?

确保 CodeCommit 连接的指纹和公有密钥与 SSH 设置主题中记录的指纹和公有密钥匹配，再继续连接。

IAM 错误：尝试向 IAM 添加公有密钥时，出现“格式无效”错误

问题：在 IAM 中，设置对 CodeCommit 使用 SSH 连接，在尝试添加公有密钥时，出现一条错误消息，其中包含 Invalid format 字样。

可能的修复措施：IAM 要求公有密钥必须采用 ssh-rsa 格式或 PEM 格式进行编码。它仅接受 OpenSSH 格式的公有密钥，并且具有《IAM 用户指南》中的将 SSH 密钥与 CodeCommit 配合使用所述的其他要求。如果提供其他格式的公有密钥，或者密钥包含的位数不够，就会出现此错误。

有关 IAM 中的 SSH 密钥要求的更多信息，请参阅《IAM 用户指南》中的将 SSH 密钥与 CodeCommit 配合使用。

我需要使用 SSH 凭证访问多个 Amazon Web Services 账户中的 CodeCommit 存储库

问题：我想在多个 Amazon Web Services 账户中设置对 CodeCommit 存储库的 SSH 访问权限。

可能的修复措施：您可以为每个 Amazon Web Services 账户创建唯一的 SSH 公有/私有密钥对，并使用每个密钥配置 IAM。然后，您可以使用与公有密钥关联的每个 IAM 用户 ID 的相关信息来配置您的 ~/.ssh/config 文件。例如：

Host codecommit-1
    Hostname git-codecommit.us-east-1.amazonaws.com
    User SSH-KEY-ID-1 # This is the SSH Key ID you copied from IAM in Amazon Web Services account 1 (for example, APKAEIBAERJR2EXAMPLE1).
    IdentityFile ~/.ssh/codecommit_rsa # This is the path to the associated public key file, such as id_rsa.  We advise creating CodeCommit specific _rsa files.
 
Host codecommit-2
    Hostname git-codecommit.us-east-1.amazonaws.com
    User SSH-KEY-ID-2 # This is the SSH Key ID you copied from IAM in Amazon Web Services account 2 (for example, APKAEIBAERJR2EXAMPLE2).
    IdentityFile ~/.ssh/codecommit_2_rsa # This is the path to the other associated public key file.  We advise creating CodeCommit specific _rsa files.

在此配置中，您可以将“git-codecommit.us-east-1.amazonaws.com”替换为“codecommit-2”。例如，要克隆第二个 Amazon Web Services 账户中的存储库，请运行以下命令：

git clone ssh://codecommit-2/v1/repos/YourRepositoryName

要为存储库设置远程操作，请运行 git remote add。例如：

git remote add origin ssh://codecommit-2/v1/repos/YourRepositoryName

有关更多示例，请参阅这篇论坛帖子和 GitHub 上的这篇文章。

Windows 上的 Git：尝试使用 SSH 进行连接时，Bash 仿真器或命令行卡住

问题：为 Windows 配置 SSH 访问并在命令行或终端中确认连接后，当尝试在命令提示符或 Bash 仿真器中 git pull、git push 或 git clone 命令时，显示一条消息，指示服务器的主机密钥未缓存在注册表中，并且有关在缓存中存储密钥的提示卡住（不接受 y/n/return 输入）。

可能的修复措施：导致该错误的最常见原因是 Git 环境配置为使用 OpenSSH 以外的程序 (可能是 PuTTY) 进行身份验证。这会在某些配置中导致与缓存密钥有关的问题。要解决这个问题，请尝试以下操作之一：

有关其他解决方案的信息，请参阅 Stack Overflow 上的 Git clone/pull continually freezing at Store key in cache。

公有密钥格式在某些 Linux 发行版中需要规范化

问题：尝试配置公有-私有密钥对时，收到一个错误。

可能的修复措施：某些 Linux 发行版需要在 ~/.ssh/config 文件中添加额外的配置行，以指定公有密钥的可接受类型。有关更多信息，请参阅有关 PubkeyAcceptedKeyTypes 的具体发行版文档。

访问错误：连接到 CodeCommit 存储库时，SSH 公有密钥被拒绝

问题：尝试使用 SSH 端点与 CodeCommit 存储库通信时，出现一条错误消息，其中包含 Error: public key denied 字样。

可能的修复措施：导致出现此错误的最常见原因是您尚未完成 SSH 连接设置。请配置公有和私有 SSH 密钥对，然后将公有密钥与您的 IAM 用户相关联。有关配置 SSH 的更多信息，请参阅适用于 Linux、macOS 或 Unix 上的 SSH 连接 和适用于 Windows 上的 SSH 连接。