🛠️ Objectif Configuration `~/.ssh/config`

→ Simplifier l’utilisation de SSH
→ Choisir automatiquement la bonne clé
→ Configurer GitHub proprement
→ Éviter les erreurs “Permission denied (publickey)”

✅ Exemple de configuration `~/.ssh/config` propre

Crée ou modifie ce fichier :

~/.ssh/config

Et mets-y ceci :

# ===============================
#  Configuration SSH GitHub
# ===============================
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes

Explication

Directive	Rôle
`Host github.com`	S’applique uniquement aux connexions vers GitHub
`HostName github.com`	Le vrai nom du serveur
`User git`	Nom d’utilisateur utilisé par Git pour les connexions SSH
`IdentityFile ~/.ssh/id_ed25519`	Ta clé privée utilisée pour GitHub
`IdentitiesOnly yes`	Force SSH à utiliser seulement cette clé (évite que SSH en teste trop et se fasse bloquer)

🔐 Ajouter plusieurs clés (si tu as plusieurs comptes GitHub)

Tu peux isoler les identités avec un alias :

# Compte GitHub personnel
Host github.com-personal
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_personal
    IdentitiesOnly yes

# Compte GitHub Pro
Host github.com-pro
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_pro
    IdentitiesOnly yes

Et dans tes dépôts Git :

git remote set-url origin git@github.com-pro:monorg/monrepo.git

🧪 Tester que tout fonctionne (sans risque)

Pour tester la connexion SSH sans rien casser :

ssh -T git@github.com

Pour voir quelle clé est réellement utilisée (mode debug très utile) :

ssh -vT git@github.com

Cherche la ligne :

Offering public key: /home/user/.ssh/id_ed25519

Cela confirme la configuration.

🔒 Bonnes pratiques

Donne les bonnes permissions : bash chmod 600 ~/.ssh/id_* chmod 700 ~/.ssh
Ne mets jamais ta clé privée dans un dépôt (même privé).
Utilise ed25519 plutôt que rsa si possible.

Pour tester si ta connexion SSH vers ton dépôt GitHub fonctionne

✅ Tester la connexion SSH à GitHub

La commande officielle est :

ssh -T git@github.com

👉 Elle teste l’authentification SSH sans ouvrir de session interactive (-T = disable pseudo-tty).

🔍 Que se passe‑t‑il si tout fonctionne ?

Selon ta configuration, GitHub répondra par l’un de ces messages :

✔️ Si ta clé SSH est reconnue :

Hi <ton_username>! You've successfully authenticated, but GitHub does not provide shell access.

→ Parfait : tu es authentifié correctement.

❓ Si GitHub te demande de vérifier l’empreinte de la clé :

La première fois seulement :

The authenticity of host 'github.com (IP...)' can't be established...

Tape : yes.

❌ Si ça ne fonctionne pas

Pas de clé SSH :

Permission denied (publickey).

→ Tu dois générer une clé SSH et l’ajouter à GitHub.

📌 Résumé rapide

Action	Commande
Tester SSH vers GitHub	`ssh -T git@github.com`
Vérifier quelle clé est utilisée	`ssh -vT git@github.com`
Lister tes clés SSH	`ls ~/.ssh/`

🛠️ Objectif Configuration ~/.ssh/config

✅ Exemple de configuration ~/.ssh/config propre