Gitea : configurer une clé SSH

Une clé SSH authentifie les opérations Git sans saisie de mot de passe à chaque commande.

Prérequis

• Un compte sur git.exemple.fr.
• OpenSSH installé (ssh -V).

1. Générer une paire de clés

ssh-keygen -t ed25519 -C "poste-travail"

Accepter le chemin par défaut ~/.ssh/id_ed25519. Définir une phrase de passe.

2. Charger la clé dans l’agent

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

3. Copier la clé publique

cat ~/.ssh/id_ed25519.pub

Copier l’intégralité de la ligne (commence par ssh-ed25519).

4. Enregistrer dans Gitea

Profil → Paramètres → Clés SSH / GPG → Ajouter une clé. Coller le contenu, nommer la clé, valider.

5. Configurer un hôte SSH (port non standard)

Si le service écoute sur un autre port, éditer ~/.ssh/config :

Host git.exemple.fr
    HostName git.exemple.fr
    Port 2222
    User git
    IdentityFile ~/.ssh/id_ed25519

Vérification

ssh -T git@git.exemple.fr

La réponse attendue : Hi <utilisateur>! You've successfully authenticated....

Dépannage

• « Permission denied (publickey) » : clé absente de l’agent (ssh-add -l) ou non enregistrée dans Gitea.
• Mauvaise clé envoyée : préciser IdentityFile dans ~/.ssh/config.
• Port refusé : le service écoute sur un port non standard ; ajouter Port dans la config.
• « Agent refused operation » : relancer ssh-add après réouverture du terminal.