====== Github ======

===== Authentification par clé SSH =====

<code bash>
# 1) Générer une clé
ssh-keygen  -t ed25519 -C "<email du compte github>"
# 2) Choisir un nom pour votre clé (<nom du fichier local>, exemple: "github")
# 3) Vous pouvez laisser la passphrase vide

# 4) déplacer la clé privée (<nom du fichier local>, pas <nom du fichier local>.pub) dans .ssh/

# 5) ajoutez votre clé à ssh-agent
ssh-add .ssh/<nom du fichier local>
# si erreur : vérifiez que seul VOUS pouvez lire la clé publique (et corrigez éventuellement avec chmod)

# 6) copiez le contenu de la clé publique
cat <nom du fichier local>.pub

# 7) ajoutez-là dans les paramètres de votre compte github dans la section "SSH & GPG Keys"
# vous devriez pouvoir cloner des repos, mêmes privés, s'ils sont liés à votre compte Github
</code>

===== Config locale =====

<code bash>
# 7) configurez vos user name et email pour git avant votre premier commit
git config --global user.name "<nom de l'utilisateur>"
git config --global user.email "<email du compte github>"
</code>

===== Connexion SSH à Github =====
Si les commandes vers Github font des timeout, cela peut être causé par un proxy interdisant la connexion en SSH vers Github. Une solution de contournement consiste à utiliser une connexion SSH en profitant du port HTTPS, généralement autorisé par les proxies (et que Github accepte aussi) :

Pour cela, éditer le fichier
<code bash>
sudo vim ~/.ssh/config
</code>

Ajouter les lignes suivantes
<code bash>
Host github.com
  Hostname ssh.github.com
  Port 443
</code>

Pour tester le bon fonctionnement :
<code bash>
ssh -T git@github.com
</code>