Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Passaggi di configurazione per le connessioni SSH ai AWS CodeCommit repository su Linux, macOS o Unix Prima di poterti connettere CodeCommit per la prima volta, devi completare alcuni passaggi iniziali di configurazione. Dopo aver configurato il computer e il AWS profilo, è possibile connettersi a un CodeCommit repository e clonarlo sul computer (operazione nota anche come creazione di un repository locale). Se non hai mai utilizzato Git, ti consigliamo di consultare le informazioni in [Dove posso saperne di più su Git?](welcome.md#welcome-get-started-with-git). **Topics** + [Fase 1: Configurazione iniziale per CodeCommit](#setting-up-ssh-unixes-account) + [Fase 2: installazione di Git](#setting-up-ssh-unixes-install-git) + [Passaggio 3: configurare le credenziali su Linux, macOS o Unix](#setting-up-ssh-unixes-keys) + [Passaggio 4: Connect alla CodeCommit console e clona il repository](#setting-up-ssh-unixes-connect-console) + [Fasi successive](#setting-up-ssh-unixes-next-step) ## Fase 1: Configurazione iniziale per CodeCommit Segui questi passaggi per configurare un account Amazon Web Services, creare un utente IAM e configurare l'accesso a CodeCommit. **Per creare e configurare un utente IAM per l'accesso CodeCommit** 1. Crea un account Amazon Web Services accedendo a [http://aws.amazon.com](https://aws.amazon.com/) e scegliendo **Registrati**. 1. Crea un utente IAM o usane uno esistente nel tuo account Amazon Web Services. Assicurati di avere un ID chiave di accesso e una chiave di accesso segreta associati a quell'utente IAM. Per ulteriori informazioni, consulta [Creazione di un utente IAM nel tuo account Amazon Web Services](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html). **Nota** CodeCommit richiede AWS Key Management Service. Se utilizzi un utente IAM esistente, assicurati che non vi siano policy associate all'utente che neghino espressamente le AWS KMS azioni richieste da. CodeCommit Per ulteriori informazioni, consulta [AWS KMS e crittografia](encryption.md). 1. Accedi Console di gestione AWS e apri la console IAM all'indirizzo. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 1. Nella console IAM, nel pannello di navigazione, scegli **Utenti**, quindi scegli l'utente IAM che desideri configurare per CodeCommit l'accesso. 1. Nella scheda **Permissions (Autorizzazioni)**, scegliere **Add permissions (Aggiungi autorizzazioni)**. 1. In **Grant permissions (Concedi autorizzazioni)**, scegliere **Attach existing policies directly (Collega direttamente le policy esistenti)**. 1. Dall'elenco delle politiche, seleziona **AWSCodeCommitPowerUser**o un'altra politica gestita per CodeCommit l'accesso. Per ulteriori informazioni, consulta [AWS politiche gestite per CodeCommit](security-iam-awsmanpol.md). Dopo aver selezionato la policy da allegare, scegli **Avanti: Revisione** per esaminare l'elenco delle politiche da allegare all'utente IAM. Se l'elenco è corretto, scegliere **Add permissions (Aggiungi autorizzazioni)**. Per ulteriori informazioni sulle politiche CodeCommit gestite e sulla condivisione dell'accesso ai repository con altri gruppi e utenti, consulta [Condividi un repository](how-to-share-repository.md) e[Autenticazione e controllo degli accessi per AWS CodeCommit](auth-and-access-control.md). **Nota** Se desideri utilizzare i AWS CLI comandi con CodeCommit, installa il AWS CLI. Per ulteriori informazioni, consulta [Guida di riferimento alla riga di comando](cmd-ref.md). ## Fase 2: installazione di Git Per lavorare con file, commit e altre informazioni nei CodeCommit repository, devi installare Git sul tuo computer locale. CodeCommit supporta le versioni Git 1.7.9 e successive. La versione Git 2.28 supporta la configurazione del nome del ramo per i commit iniziali. Si consiglia di utilizzare una versione recente di Git. Per installare Git, consigliamo siti web come [Git Downloads](http://git-scm.com/downloads). **Nota** Git è una piattaforma in evoluzione e regolarmente aggiornata. Occasionalmente, una modifica delle funzionalità potrebbe influire sul modo in cui funziona. CodeCommit Se riscontri problemi con una versione specifica di Git and CodeCommit, consulta le informazioni in[Risoluzione dei problemi](troubleshooting.md). ## Passaggio 3: configurare le credenziali su Linux, macOS o Unix ### SSH e Linux, macOS o Unix: configura le chiavi pubbliche e private per Git e CodeCommit **Per configurare le chiavi pubbliche e private per Git e CodeCommit** 1. Dal terminale del computer locale, esegui il comando **ssh-keygen** e segui le indicazioni per salvare il file nella directory .ssh del tuo profilo. **Nota** Assicurati di chiedere all'amministratore di sistema dove archiviare i file delle chiavi e quale schema di denominazione dei file devi utilizzare. Esempio: ``` $ ssh-keygen Generating public/private rsa key pair. Enter file in which to save the key (/home/user-name/.ssh/id_rsa): Type /home/your-user-name/.ssh/ and a file name here, for example /home/your-user-name/.ssh/codecommit_rsa Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in /home/user-name/.ssh/codecommit_rsa. Your public key has been saved in /home/user-name/.ssh/codecommit_rsa.pub. The key fingerprint is: 45:63:d5:99:0e:99:73:50:5e:d4:b3:2d:86:4a:2c:14 user-name@client-name The key's randomart image is: +--[ RSA 2048]----+ | E.+.o*.++| | .o .=.=o.| | . .. *. +| | ..o . +..| | So . . . | | . | | | | | | | +-----------------+ ``` Questo genera: + Il *codecommit\$1rsa* file, che è il file con chiave privata. + Il *codecommit\$1rsa.pub* file, che è il file con chiave pubblica. **Suggerimento** Per impostazione predefinita, **ssh-keygen** genera una chiave a 2048 bit. È possibile utilizzare i parametri -t e -b per specificare il tipo e la lunghezza della chiave. Se desideri una chiave a 4096 bit nel formato rsa, devi specificarla eseguendo il comando con i seguenti parametri: ``` ssh-keygen -t rsa -b 4096 ``` [Per ulteriori informazioni sui formati e le lunghezze richieste per le chiavi SSH, consulta Using IAM with. CodeCommit](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_ssh-keys.html#ssh-keys-code-commit) 1. Esegui il comando seguente per visualizzare il valore del file della chiave pubblica ()*codecommit\$1rsa.pub*: ``` cat ~/.ssh/codecommit_rsa.pub ``` Copia questo valore. Saranno simili a quanto segue: ``` ssh-rsa EXAMPLE-AfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMCVVMxCzAJB gNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb2 5zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhc NMTEwNDI1MjA0NTIxWhcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAw DgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDAS=EXAMPLE user-name@ip-192-0-2-137 ``` 1. Accedi Console di gestione AWS e apri la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). **Nota** Puoi visualizzare e gestire direttamente le tue CodeCommit credenziali in Le **mie credenziali di sicurezza**. Per ulteriori informazioni, consulta [Visualizza e gestisci le tue credenziali](setting-up.md#setting-up-view-credentials). 1. Nella console IAM, nel riquadro di navigazione, scegli **Utenti** e dall'elenco degli utenti scegli il tuo utente IAM. 1. Nella pagina dei dettagli dell'utente, seleziona la scheda **Security Credentials (Credenziali di sicurezza)**, quindi **Upload SSH public key (Carica chiave pubblica SSH)**. 1. Incolla il contenuto della chiave pubblica SSH nel campo, quindi scegli **Upload SSH public key (Carica chiave pubblica SSH)**. 1. Copia o salva le informazioni in **SSH Key ID** (ad esempio,*APKAEIBAERJR2EXAMPLE*). ![\[L'ID della chiave SSH nella console IAM\]](http://docs.aws.amazon.com/it_it/codecommit/latest/userguide/images/codecommit-ssh-key-id-iam.png) **Nota** Se hai IDs caricato più di una chiave SSH, le chiavi sono elencate alfabeticamente per ID chiave, non per data di caricamento. Assicurati di aver copiato l'ID della chiave associato alla data di caricamento corretta. 1. Sul computer locale, usa un editor di testo per creare un file di configurazione nella directory \$1/.ssh, quindi aggiungi le seguenti righe al file, dove il valore per *User* è l'ID della chiave SSH che hai copiato in precedenza: ``` Host git-codecommit.*.amazonaws.com User APKAEIBAERJR2EXAMPLE IdentityFile ~/.ssh/codecommit_rsa ``` **Nota** Se hai dato al file della chiave privata un nome diverso da*codecommit\$1rsa*, assicurati di usarlo qui. Puoi configurare l'accesso SSH ai repository in più account Amazon Web Services. Per ulteriori informazioni, consulta. [Risoluzione dei problemi relativi alle connessioni SSH a AWS CodeCommit](troubleshooting-ssh.md) Salva e attribuisci un nome al file `config`. 1. Dal terminale, esegui il seguente comando per modificare le autorizzazioni per il file config: ``` chmod 600 config ``` 1. Esegui il seguente comando per verificare la configurazione SSH: ``` ssh git-codecommit.us-east-2.amazonaws.com ``` Ti viene chiesto di confermare la connessione perché non `git-codecommit.us-east-2.amazonaws.com` è ancora inclusa nel tuo file hosts noto. L'impronta digitale del CodeCommit server viene visualizzata come parte della verifica (`a9:6d:03:ed:08:42:21:be:06:e1:e0:2a:d1:75:31:5e`per MD5 o `3lBlW2g5xn/NA2Ck6dyeJIrQOWvn7n8UEs56fG6ZIzQ` per SHA256). **Nota** CodeCommit le impronte digitali del server sono uniche per tutti. Regione AWS Per visualizzare le impronte digitali del server per un Regione AWS, vedere. [Impronte digitali del server per CodeCommit](regions.md#regions-fingerprints) Dopo avere verificato la connessione, dovrebbe venire visualizzato un messaggio di conferma dell'avvenuta aggiunta del server ai file hosts noti e un messaggio dell'avvenuta connessione. Se non visualizzi un messaggio di successo, verifica di aver salvato il `config` file nella directory \$1/.ssh dell'utente IAM a cui hai configurato l'accesso CodeCommit e di aver specificato il file di chiave privata corretto. Per informazioni su come risolvere i problemi, esegui il comando con il parametro. `ssh` `-v` Esempio: ``` ssh -v git-codecommit.us-east-2.amazonaws.com ``` Per informazioni sulla risoluzione dei problemi di connessione, consulta [Risoluzione dei problemi relativi alle connessioni SSH a AWS CodeCommit](troubleshooting-ssh.md). ## Passaggio 4: Connect alla CodeCommit console e clona il repository Se un amministratore ha già inviato il nome e i dettagli di connessione del repository CodeCommit, puoi ignorare questa fase e clonare direttamente il repository. **Per connettersi a un repository CodeCommit** 1. Apri la CodeCommit console su [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home). 1. Nel selettore della regione, scegli Regione AWS dove è stato creato il repository. I repository sono specifici di un. Regione AWS Per ulteriori informazioni, consulta [Regioni ed endpoint di connessione Git](regions.md). 1. Trova e seleziona nell'elenco il repository che intendi collegare. Scegliere **Clone URL (URL clone)**, quindi scegliere il protocollo che si desidera utilizzare durante la clonazione o la connessione al repository. In questo modo si copia l'URL del clone. + Copia l'URL HTTPS se utilizzi le credenziali Git con il tuo utente IAM o l'helper per le credenziali incluso in. AWS CLI + Copia l'URL HTTPS (GRC) se usi il comando **git-remote-codecommit** sul computer locale. + Copia l'URL SSH se utilizzi una coppia di public/private chiavi SSH con il tuo utente IAM. **Nota** Se vedi una pagina di **benvenuto** anziché un elenco di repository, significa che non ci sono repository associati al tuo AWS account nel luogo in Regione AWS cui hai effettuato l'accesso. Per creare un repository, consulta [Creare un repository AWS CodeCommit](how-to-create-repository.md) oppure segui la procedura del tutorial [Guida introduttiva a Git e CodeCommit](getting-started.md). 1. Apri un terminale. Dalla directory /tmp, esegui il comando **git clone** con l'URL SSH copiato per clonare il repository. Ad esempio, per clonare un repository denominato su un repository locale denominato *MyDemoRepo* *my-demo-repo* nella regione Stati Uniti orientali (Ohio): ``` git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo ``` **Nota** Se la verifica della connessione ha avuto esito positivo, a differenza del comando di clonazione, potresti non disporre dell'accesso richiesto al file config oppure un'altra impostazione potrebbe essere in conflitto con il file config. Prova a effettuare nuovamente la connessione, questa volta includendo nel comando l'ID della chiave SSH. Esempio: ``` git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo ``` Per ulteriori informazioni, consulta [Errore di accesso: la chiave pubblica viene caricata correttamente su IAM ma la connessione non riesce su sistemi Linux, macOS o Unix](troubleshooting-ssh.md#troubleshooting-ae4). Per ulteriori informazioni su come connettersi ai repository, consulta [Connect al CodeCommit repository clonando il repository](how-to-connect.md#how-to-connect-http). ## Fasi successive Hai completato i prerequisiti. Segui i passaggi indicati per iniziare [Iniziare con CodeCommit ](getting-started-cc.md) a utilizzare. CodeCommit