Accès Git via SSH¶

Ce guide explique comment cloner un dépôt Forgejo ou Gitea PinkSalmon avec une clé SSH. La clé publique est enregistrée sur la forge, la clé privée reste sur votre poste.

1. Ajouter votre clé SSH à la forge¶

Si vous ne possédez pas encore de paire de clés, suivez le guide adapté à votre poste :

Suivez ensuite le guide Ajouter et vérifier une clé SSH sur la forge.

Ajoutez uniquement la clé publique à votre compte. Ne transmettez jamais votre clé privée.

2. Copier l’URL SSH du dépôt¶

Ouvrez un dépôt auquel vous avez accès, sélectionnez le mode de clonage SSH, puis copiez l’URL affichée.

Sélection de l’URL SSH pour cloner un dépôt

Utilisez l’URL complète fournie par la forge : elle contient le nom du serveur, l’utilisateur SSH et, si nécessaire, un port spécifique.

3. Cloner le dépôt¶

Dans un terminal, remplacez URL_SSH_DU_DEPOT par l’URL copiée :

git clone URL_SSH_DU_DEPOT

Lors de la première connexion, SSH peut vous demander de confirmer l’identité du serveur. Comparez l’empreinte affichée avec celle fournie par l’administrateur de votre forge avant de l’accepter. La clé du serveur est alors enregistrée dans votre fichier known_hosts.

Si votre clé privée est protégée par une phrase de passe, SSH peut vous la demander. Il s’agit de la phrase de passe de votre clé locale.

Une fois le clonage terminé, le code est disponible dans un nouveau répertoire portant généralement le nom du dépôt.

Résoudre un problème d’accès¶

Message ou problème	Vérifications
`Permission denied (publickey)`	Vérifiez que la bonne clé publique est ajoutée à votre compte et que votre client SSH utilise la clé privée correspondante.
`Host key verification failed`	Vérifiez l’empreinte du serveur auprès de l’administrateur et assurez-vous que SSH peut enregistrer la clé dans votre fichier `known_hosts`.
`REMOTE HOST IDENTIFICATION HAS CHANGED`	Faites confirmer le changement de clé par l’administrateur avant de mettre à jour l’entrée du serveur dans `known_hosts`.
Connexion refusée ou délai dépassé	Vérifiez le serveur et le port dans l’URL de clonage, ainsi que leur accessibilité depuis votre réseau.
Dépôt introuvable ou accès refusé	Vérifiez l’URL du dépôt et les droits du compte auquel votre clé est associée.

La commande ssh-keyscan collecte des clés de serveur sans en vérifier l’authenticité. Elle ne remplace donc pas la vérification de l’empreinte auprès de l’administrateur. Consultez la documentation OpenSSH de ssh-keyscan pour plus de détails.

Pour choisir un autre mode de connexion, consultez le guide d’accès HTTPS.