Come aggiungere una chiave SSH al tuo account GitLab

Introduzione

In questo tutorial vediamo come aggiungere una chiave SSH al tuo account GitLab.

Per creare una chiave SSH per Gitlab leggere il seguente tutorial: Come generare una coppia di chiavi SSH per GitLab.

Per aggiornare la passphrase della chiave SSH (SSH Key) leggere il seguente tutorial: Come generare una coppia di chiavi SSH per GitLab.

Come aggiungere la chiave SSH su Gitlab

Per utilizzare SSH con GitLab, copia la tua chiave pubblica nel tuo account GitLab.

Copia il contenuto del file della tua chiave pubblica. Puoi farlo manualmente o utilizzando uno script. Ad esempio, per copiare una chiave ED25519 negli appunti:

Mac OS:

pbcopy < ~/.ssh/id_ed25519.pub

Linux (richiede il pacchetto xclip):

xclip -sel clip < ~/.ssh/id_ed25519.pub

Git Bash su Windows:

cat ~/.ssh/id_ed25519.pub | clip

Sostituisci id_ed25519.pub con il nome del tuo file. Ad esempio, utilizzare id_rsa.pub per RSA.

Dopo aver copiato il contenuto del file:

1. Accedi a GitLab.
2. Nell'angolo in alto a destra, seleziona il tuo avatar.
3. Seleziona Preferences.
4. Nella barra laterale sinistra, seleziona SSH Keys.
5. Nella casella Key, incolla il contenuto della tua chiave pubblica. Se hai copiato manualmente la chiave, assicurati di copiare l'intera chiave, che inizia con ssh-ed25519 o ssh-rsa e potrebbe terminare con un commento.
6. Nella casella di testo Title, digita una descrizione, ad esempio "Computer portatile da lavoro" o "Stazione di lavoro domestica".
7. Opzionale. Nella casella Expires at selezionare una data di scadenza. (Introdotto in GitLab 12.9.) La data di scadenza è solo informativa e non impedisce di utilizzare la chiave. Tuttavia, gli amministratori possono visualizzare le date di scadenza e utilizzarle come guida durante l'eliminazione delle chiavi.
8. Seleziona Add Key.

Verificare di potersi connettere

Verifica che la tua chiave SSH sia stata aggiunta correttamente.

Su GitLab.com, per assicurarti di connetterti al server corretto, conferma le impronte digitali delle chiavi dell'host SSH.

Apri un terminale ed esegui questo comando, sostituendolo gitlab.example.com con l'URL del repository GitLab:

ssh -T [email protected]

Se è la prima volta che ti connetti, dovresti verificare l'autenticità dell'host GitLab. Se vedi un messaggio come il seguente, digita Yes e premi Invio:

The authenticity of host 'gitlab.example.com (35.231.145.151)' can't be established.
ECDSA key fingerprint is SHA256:HbW3g8zUjNSksFbqTiUWPWg2Bq1x8xdGUrliXFzSnUw.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'gitlab.example.com' (ECDSA) to the list of known hosts.

Esegui nuovamente il comando ssh -T [email protected]. Si dovrebbe ricevere un messaggio di benvenuto.

Se il messaggio di benvenuto non viene visualizzato, puoi risolvere il problema eseguendo ssh in modalità dettagliata:

ssh -Tvvv [email protected]

Conclusione

In questo tutorial abbiamo visto come aggiungere una chiave SSH al tuo account GitLab.