Configuration pour les utilisateurs SSH qui n'utilisent pas leAWS CLI

Si vous souhaitez utiliser des connexions SSH pour votre référentiel, vous pouvez vous connecter à AWS CodeCommit sans avoir à installer l'AWS CLI. LeAWS CLIcomprend des commandes qui sont utiles lorsque vous utilisez et gérez des référentiels CodeCommit, mais elle n'est pas requise pour la configuration initiale.

Cette rubrique suppose que :

• Vous avez configuré un utilisateur IAM avec les stratégies ou les autorisations nécessaires pour CodeCommit et leIAMUserSSHKeysstratégie gérée ou autorisations équivalentes requises pour charger des clés. Pour plus d'informations, consultez Utilisation de politiques basées sur l'identité (politiques IAM) pour CodeCommit.

• Vous disposez déjà d'une paire de clés publique/privée, ou vous savez comment en créer une. Nous vous recommandons vivement d'utiliser une phrase passe sécurisée pour votre clé SSH.

• Vous êtes familiarisé avec SSH, votre client Git et ses fichiers de configuration.

• Si vous utilisez Windows, vous avez installé un utilitaire de ligne de commande, tel que Git Bash, qui émule le shell bash.

Si vous avez besoin de conseils supplémentaires, suivez les instructions de Pour les connexions SSH sous Linux, macOS ou Unix ou Pour des connexions SSH sous Windows.

Étape 1 : Associez votre clé publique à votre utilisateur IAM

1. Connectez-vous à la AWS Management Console et ouvrez la console IAM à l'adresse https://console.aws.amazon.com/iam/.

2. Dans le panneau de navigation de la console IAM, sélectionnezUsers, et dans la liste d'utilisateurs, sélectionnez votre utilisateur IAM.

3. Sur l'onglet Security Credentials, choisissez Upload SSH public key.

4. Collez le contenu de votre clé publique SSH dans le champ, puis sélectionnez Upload SSH Key.

   Astuce

   La paire de clés publique/privée doit être de type SSH-2 RSA, au format OpenSSH et contenir 2048 bits. La clé ressemble à ceci :

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

   IAM accepte les clés publiques au format OpenSSH uniquement. Si vous fournissez votre clé publique dans un autre format, un message d'erreur vous indique que le format de clé n'est pas valide.

5. Copiez l'ID de clé SSH (par exemple, APKAEIBAERJR2EXAMPLE) et fermez la console.

   

Étape 2 : Ajouter CodeCommit à votre configuration SSH

1. Depuis le terminal (Linux, macOS ou Unix) ou de l'émulateur bash (Windows), modifiez votre fichier de configuration SSH en tapant :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
            

   Astuce

   Si vous avez plusieurs configurations SSH, veillez à inclure les lignes vides avant et après le contenu. Enregistrez le fichier en appuyant simultanément sur les touches Ctrl et d.

2. Exécutez la commande suivante pour tester votre configuration SSH :

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

   Saisissez la phrase passe pour votre fichier de clé SSH lorsque vous y êtes invité. Si tout est correctement configuré, vous devez voir le message de réussite suivant :

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

Étapes suivantes

Vous réunissez toutes les conditions prérequises. Suivez les étapes deCommencer avec CodeCommit pour commencer à utiliser CodeCommit.

Pour vous connecter à un référentiel, suivez les étapes de Connexion à un référentiel. Pour créer un référentiel, suivez les étapes de Création d'un référentiel .