Configuración para usuarios de SSH que no utilizan la AWS CLI

Si desea utilizar conexiones SSH en el repositorio, puede conectarse a AWS CodeCommit sin necesidad de instalar la AWS CLI. La AWS CLI incluye comandos que son útiles para utilizar y administrar los repositorios de CodeCommit, pero no es necesaria durante la configuración inicial.

En este tema se presupone:

• Que ha creado un usuario de IAM según las políticas o los permisos necesarios de CodeCommit y la política administrada IAMUserSSHKeys o los permisos equivalentes necesarios para cargar claves. Para obtener más información, consulte Uso de políticas basadas en la identidad (políticas de IAM) para CodeCommit.

• Que ya tiene, o sabe cómo crear, un par de claves pública y privada. Recomendamos encarecidamente que proteja la clave SSH con una frase de contraseña segura.

• Que está familiarizado con SSH, el cliente de Git y sus archivos de configuración.

• Que si utiliza Windows, tiene instalada una utilidad de línea de comandos, como Git Bash, que simula el shell de Bash.

Si necesita más información, siga las instrucciones que aparecen en Para conexiones SSH en Linux, macOS o Unix o Para conexiones SSH en Windows.

Paso 1: Asociar su clave pública a su usuario de IAM

1. Inicie sesión en la AWS Management Console y abra la consola de IAM en https://console.aws.amazon.com/iam/.

2. En el panel de navegación de la consola de IAM, seleccione Usuarios y, en la lista de usuarios seleccione su usuario de IAM.

3. En la pestaña Security Credentials, elija Upload SSH public key.

4. Pegue el contenido de la clave SSH pública en el campo y, a continuación, elija Upload SSH Key.

   sugerencia

   El par de claves pública y privada debe ser SSH-2 RSA, estar en formato OpenSSH y contener 2048 bits. La clave tiene un aspecto parecido al siguiente:

   ssh-rsa EXAMPLE-AfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMCVVMxCzAJB
   gNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb2
   5zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhc
   NMTEwNDI1MjA0NTIxWhcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAw
   DgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDAS=EXAMPLE user-name@ip-192-0-2-137

   IAM solo es compatible con claves públicas en formato OpenSSH. Si introduce la clave pública en otro formato, aparece un mensaje de error que indica que el formato de clave no es válido.

5. Copie el ID de la clave SSH (por ejemplo, APKAEIBAERJR2EXAMPLE) y cierre la consola.

   

Paso 2: Añadir CodeCommit a la configuración de SSH

1. En el terminal (Linux, macOS o Unix) o emulador de Bash (Windows), edite el archivo de configuración de SSH escribiendo cat>> ~/.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
            

   sugerencia

   Si tiene más de una configuración de SSH, asegúrese de incluir las líneas en blanco antes y, a continuación, del contenido. Pulse las teclas Ctrl y d a la vez para guardar el archivo.

2. Ejecute el siguiente comando para probar la configuración SSH:

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

   Cuando se le pida, introduzca la frase de contraseña del archivo de clave SSH. Si todo se ha configurado correctamente, deberá ver el siguiente mensaje de operación correcta:

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

Pasos siguientes

Ha completado los requisitos previos. Siga los pasos que se indican en Empezando con CodeCommit para empezar a utilizar CodeCommit.

Para conectarse a un repositorio, siga los pasos que se detallan en Conectarse a un repositorio. Para crear un repositorio, siga los pasos que se detallan en Creación de un repositorio.