✅ Ajouter sa clé SSH — GitLab (Debian 12)

Court guide pas-à-pas pour utiliser SSH avec GitLab — https://gitlab.bzctoons.net

🎯 Objectifs

  • Générer une paire de clés SSH sécurisée
  • Copier la clé publique dans l'interface GitLab
  • Tester la connexion SSH et cloner un dépôt

🔧 Pré-requis

1) Générer une paire de clés (recommandé: ed25519)

ssh-keygen -t ed25519 -C "votre.email@exemple.com"
# ou (si besoin de compatibilité):
ssh-keygen -t rsa -b 4096 -C "votre.email@exemple.com"
  • Appuyez sur Entrée pour accepter le chemin par défaut (~/.ssh/id_ed25519).
  • Utilisez une passphrase pour sécuriser la clé privée (fortement recommandé).

2) Copier la clé publique

  • Afficher et copier manuellement:
cat ~/.ssh/id_ed25519.pub
  • Copier dans le presse-papier (si interface graphique):
sudo apt update && sudo apt install -y xclip
xclip -selection clipboard < ~/.ssh/id_ed25519.pub

3) Ajouter la clé sur GitLab

  1. Ouvrez https://gitlab.bzctoons.net et connectez-vous
  2. Cliquez sur votre avatar (coin supérieur droit) → Preferences → SSH Keys
  3. Collez la clé publique dans le champ Key, donnez un Title reconnaissable, puis Add key
  • Optionnel: définir une date d'expiration pour la clé

🖼️ Exemple — Interface GitLab (SSH Keys)

SSH Keys page
<small class="small">Page : Preferences → SSH Keys — collez la clé publique dans Key et donnez un Title.</small>

🖼️ Ajouter une clé — Formulaire

Add key form
<small class="small">Remplissez Title, collez la clé dans Key puis cliquez sur Add key.</small>

4) Tester la connexion SSH

ssh -T git@gitlab.bzctoons.net
  • Sortie attendue : un message de bienvenue confirmant que l'authentification est réussie.
  • Exemple de clonage:
git clone git@gitlab.bzctoons.net:namespace/projet.git

🔍 Dépannage rapide

  • Permissions clés: chmod 700 ~/.ssh && chmod 600 ~/.ssh/id_ed25519
  • Agent SSH: eval "$(ssh-agent -s)" && ssh-add ~/.ssh/id_ed25519
  • Debug: ssh -vT git@gitlab.bzctoons.net (affiche les étapes d'authentification)
  • Vérifiez que vous avez collé la clé publique complète (commence par ssh-ed25519 ou ssh-rsa)

🔒 Bonnes pratiques

  • Préférez ed25519 pour les nouvelles clés
  • Protégez la clé privée avec une passphrase
  • Utilisez des clés avec expiration pour accès temporaires
  • Évitez de partager la clé privée

📝 Changelog — V0.0.1

  • 02/02/2026 00:24 — Ajout du deck gitlab-ssh-debian12.md : guide pas-à-pas pour ajouter une clé SSH à GitLab (https://gitlab.bzctoons.net). Footer: C Avancé M2 - V0.0.1 - 02/02/2026 00:24 - Réda BOUREBABA <r.bourebaba@ynov.com>.

ℹ️ Ressources