

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 未使用 的 SSH 使用者設定 AWS CLI
<a name="setting-up-without-cli"></a>

如果您想要使用儲存庫的 SSH 連線，您可以連線至 ， AWS CodeCommit 而無需安裝 AWS CLI。 AWS CLI 包含在您使用和管理 CodeCommit 儲存庫時非常有用的命令，但初始設定不需要。

此主題假設：
+ 您已使用 CodeCommit 所需的政策或許可，以及上傳金鑰所需的 **IAMUserSSHKeys** 受管政策或同等許可來設定 IAM 使用者。如需詳細資訊，請參閱[針對 CodeCommit 使用身分型政策 (IAM 政策）](auth-and-access-control-iam-identity-based-access-control.md)。
+ 您已經具有 (或知道如何建立) 公有-私有金鑰對。強烈建議您對 SSH 金鑰使用安全的複雜密碼。
+ 您熟悉 SSH、Git 用戶端及其組態檔案。
+ 如果您使用 Windows，則您已安裝可模擬 bash shell 的命令列公用程式，例如 Git Bash。

如果您需要更多指導，請遵循 [針對 Linux、macOS 或 Unix 上的 SSH 連線](setting-up-ssh-unixes.md)或 [Windows 上的 SSH 連線](setting-up-ssh-windows.md)中的指示。

**Topics**
+ [步驟 1：將您的公有金鑰與 IAM 使用者建立關聯](#setting-up-without-cli-add-key)
+ [步驟 2：將 CodeCommit 新增至 SSH 組態](#setting-up-without-cli-configure-client)
+ [後續步驟](#setting-up-without-cli-next-step)

## 步驟 1：將您的公有金鑰與 IAM 使用者建立關聯
<a name="setting-up-without-cli-add-key"></a>

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。

1. 在 IAM 主控台的導覽窗格中，選擇**使用者**，然後從使用者清單中選擇您的 IAM 使用者。

1. 在 **Security Credentials (安全登入資料)** 標籤上，選擇 **Upload SSH public key (上傳 SSH 公有金鑰)**。

1. 將 SSH 公有金鑰的內容貼到欄位中，然後選擇 **Upload SSH Key (上傳 SSH 金鑰)**。
**提示**  
公有-私有金鑰對必須為 SSH-2 RSA、OpenSSH 格式，且包含 2048 位元。金鑰看起來如下：  

   ```
   ssh-rsa EXAMPLE-AfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMCVVMxCzAJB
   gNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb2
   5zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhc
   NMTEwNDI1MjA0NTIxWhcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAw
   DgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDAS=EXAMPLE user-name@ip-192-0-2-137
   ```
IAM 僅接受 OpenSSH 格式的公有金鑰。如果您提供其他格式的公有金鑰，則會看到錯誤訊息，指出金鑰格式無效。

1. 複製 SSH 金鑰 ID (例如，*APKAEIBAERJR2EXAMPLE*) 並關閉主控台。  
![\[IAM 主控台中的 SSH 金鑰 ID\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-ssh-key-id-iam.png)

## 步驟 2：將 CodeCommit 新增至 SSH 組態
<a name="setting-up-without-cli-configure-client"></a>

1. 在終端機 (Linux、macOS 或 Unix) 或 bash 模擬器 (Windows)，輸入 來編輯 SSH 組態檔案**cat>> \$1/.ssh/config**：

   ```
   Host git-codecommit.*.amazonaws.com
   User Your-SSH-Key-ID, such as APKAEIBAERJR2EXAMPLE
   IdentityFile Your-Private-Key-File, such as ~/.ssh/codecommit_rsa or ~/.ssh/id_rsa
   ```
**提示**  
如果您有多個 SSH 組態，請務必在內容前後包含空白行。同時按下 `Ctrl` 和 `d` 鍵來儲存檔案。

1. 執行下列命令以測試 SSH 組態：

   ```
   ssh git-codecommit.us-east-2.amazonaws.com
   ```

   出現提示時，為您的 SSH 金鑰檔案輸入複雜密碼。如果一切都設定正確，您應該會看到以下成功訊息：

   ```
   You have successfully authenticated over SSH. You can use Git to interact with CodeCommit. 
   ```

## 後續步驟
<a name="setting-up-without-cli-next-step"></a>

您已完成事前準備。依照中的步驟[開始使用 CodeCommit ](getting-started-cc.md)開始使用 CodeCommit。

若要連接到儲存庫，請遵循[連接到儲存庫](how-to-connect.md)中的步驟。若要建立儲存庫，請遵循[建立 儲存庫](how-to-create-repository.md)中的步驟。