Mettre en place SSH pour Gitlab/en - Historique des versions

Daniela.cojocaru : Page créée avec « {{Attention|Cette commande génère deux fichiers dans le dossier `C:\Users\\.ssh` : la clé privée (`id_ed25519`) et la clé publique (`id_ed25519.pub`). '''DO NOT SHARE THE PRIVATE KEY'''. It's the '''public key''' which should be added to Gitlab. We cannot stress enough this point. All the security counts on the fact that the private key stays secret.}} »

2026-08-11T11:52:34Z

Page créée avec « {{Attention|Cette commande génère deux fichiers dans le dossier <code>C:\Users\<ton_nom>\.ssh</code> : la clé privée (<code>id_ed25519</code>) et la clé publique (<code>id_ed25519.pub</code>). '''DO NOT SHARE THE PRIVATE KEY'''. It's the '''public key''' which should be added to Gitlab. We cannot stress enough this point. All the security counts on the fact that the private key stays secret.}} »

← Version précédente		Version du 11 août 2026 à 11:52
Ligne 24 :		Ligne 24 :
	Please note that there is an option to change the key’s name (by default <code>id_ed25519</code>) and the save location. There is also another option to add a passphrase to the key, which is recommended if your hard drive is not encrypted.		Please note that there is an option to change the key’s name (by default <code>id_ed25519</code>) and the save location. There is also another option to add a passphrase to the key, which is recommended if your hard drive is not encrypted.

	~~<div lang="fr" dir="ltr" class="mw-content-ltr">~~		{{Attention\|Cette commande génère deux fichiers dans le dossier <code>C:\Users\<ton_nom>\.ssh</code> : la clé privée (<code>id_ed25519</code>) et la clé publique (<code>id_ed25519.pub</code>). '''DO NOT SHARE THE PRIVATE KEY'''. It's the '''public key''' which should be added to Gitlab. We cannot stress enough this point. All the security counts on the fact that the private key stays secret.}}
	{{Attention\|Cette commande génère deux fichiers dans le dossier <code>C:\Users\<ton_nom>\.ssh</code> : la clé privée (<code>id_ed25519</code>) et la clé publique (<code>id_ed25519.pub</code>). '''~~IL NE FAUT EN AUCUN CAS PARTAGER LA CLÉ PRIVÉE~~'''. ~~C’est la~~ '''~~clé publique~~''' ~~qui doit être ajoutée sur~~ Gitlab. ~~On n’insistera jamais assez sur ce~~ point. ~~Toute la sécurité repose sur le fait que la clé privée reste secrète~~.}}
	~~</div>~~

	== Étape 2 : Ajouter la clé SSH sur Gitlab ==		== Étape 2 : Ajouter la clé SSH sur Gitlab ==

Daniela.cojocaru : Page créée avec « Please note that there is an option to change the key’s name (by default `id_ed25519`) and the save location. There is also another option to add a passphrase to the key, which is recommended if your hard drive is not encrypted. »

2026-08-11T11:50:45Z

Page créée avec « Please note that there is an option to change the key’s name (by default <code>id_ed25519</code>) and the save location. There is also another option to add a passphrase to the key, which is recommended if your hard drive is not encrypted. »

← Version précédente		Version du 11 août 2026 à 11:50
Ligne 19 :		Ligne 19 :
	Open a terminal (cmd or powershell) and type the following command:		Open a terminal (cmd or powershell) and type the following command:

	~~<div lang="fr" dir="ltr" class="mw-content-ltr">~~
	<syntaxhighlight lang="bash">ssh-keygen -t ed25519 -C "ordi portable vaneau"</syntaxhighlight>		<syntaxhighlight lang="bash">ssh-keygen -t ed25519 -C "ordi portable vaneau"</syntaxhighlight>
	~~En remplaçant~~ <code>ordi portable vaneau</code> ~~par un nom de ton choix~~. ~~Tu peux laisser les autres champs vides en appuyant simplement sur la touche~~ <code>~~Entrée~~</code> ~~pour chaque~~ option.		Replace <code>ordi portable vaneau</code> with a name of your choice. You can leave the other fields empty by pressing <code>Enter</code> for each option.
	~~</div>~~

	~~<div lang="fr" dir="ltr" class="mw-content-ltr">~~		Please note that there is an option to change the key’s name (by default <code>id_ed25519</code>) and the save location. There is also another option to add a passphrase to the key, which is recommended if your hard drive is not encrypted.
	~~À noter qu'il y a une~~ option ~~pour changer le nom de la clé~~ (~~par défaut~~ <code>id_ed25519</code>) ~~et l’emplacement de sauvegarde~~. ~~Il y~~ a ~~aussi une autre option pour ajouter un mot de passe (''~~passphrase~~'') à la clé~~, ~~qu'il est recommandé de mettre si ton disque dur n'est pas chiffré~~.
	~~</div>~~

	<div lang="fr" dir="ltr" class="mw-content-ltr">		<div lang="fr" dir="ltr" class="mw-content-ltr">

Daniela.cojocaru : Page créée avec « Open a terminal (cmd or powershell) and type the following command: »

2026-08-11T11:49:18Z

Page créée avec « Open a terminal (cmd or powershell) and type the following command: »

← Version précédente		Version du 11 août 2026 à 11:49
Ligne 17 :		Ligne 17 :
	== Étape 1 : Générer une clé SSH ==		== Étape 1 : Générer une clé SSH ==

	~~<div lang="fr" dir="ltr" class="mw-content-ltr">~~		Open a terminal (cmd or powershell) and type the following command:
	~~Ouvre un~~ terminal (cmd ou powershell) ~~et tape la commande suivante~~ :
	~~</div>~~

	<div lang="fr" dir="ltr" class="mw-content-ltr">		<div lang="fr" dir="ltr" class="mw-content-ltr">

Daniela.cojocaru : Page créée avec « * open a cmd or PowerShell terminal (press the Windows key + R, then type `cmd` or `powershell`); * type `git -v` and check that Git is installed; if it isn’t, [https://git-scm.com/downloads install Git here]; * then type `ssh -V` to check that SSH is installed; if it isn’t, [https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse install OpenSSH here]. »

2026-08-11T11:48:56Z

Page créée avec « * open a cmd or PowerShell terminal (press the Windows key + R, then type <code>cmd</code> or <code>powershell</code>); * type <code>git -v</code> and check that Git is installed; if it isn’t, [https://git-scm.com/downloads install Git here]; * then type <code>ssh -V</code> to check that SSH is installed; if it isn’t, [https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse install OpenSSH here]. »

← Version précédente		Version du 11 août 2026 à 11:48
Ligne 9 :		Ligne 9 :
	Before you start, make sure you have [[Git\|git]] installed on your computer. To check this:		Before you start, make sure you have [[Git\|git]] installed on your computer. To check this:

	~~<div lang="fr" dir="ltr" class="mw-content-ltr">~~		* open a cmd or PowerShell terminal (press the Windows key + R, then type <code>cmd</code> or <code>powershell</code>);
	* ~~ouvrir un~~ terminal ~~cmd ou powershell~~ (~~touche~~ Windows + R, ~~puis taper~~ <code>cmd</code> ou <code>powershell</code>) ;		* type <code>git -v</code> and check that Git is installed; if it isn’t, [https://git-scm.com/downloads install Git here];
	* ~~taper~~ <code>git -v</code> ~~et vérifier que git est bien installé et, si ce n’est pas le cas~~, [https://git-scm.com/downloads ~~installe git ici~~] ;		* then type <code>ssh -V</code> to check that SSH is installed; if it isn’t, [https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse install OpenSSH here].
	* ~~taper ensuite~~ <code>ssh -V</code> ~~pour vérifier que ssh est installé et, si ce n’est pas le cas~~, [https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse ~~installe~~ OpenSSH ~~ici~~].
	~~</div>~~

	= Mise en place =		= Mise en place =

Daniela.cojocaru : Page créée avec « Before you start, make sure you have git installed on your computer. To check this: »

2026-08-11T11:47:54Z

Page créée avec « Before you start, make sure you have git installed on your computer. To check this: »

← Version précédente		Version du 11 août 2026 à 11:47
Ligne 7 :		Ligne 7 :
	= Prérequis =		= Prérequis =

	~~<div lang="fr" dir="ltr" class="mw-content-ltr">~~		Before you start, make sure you have [[Git\|git]] installed on your computer. To check this:
	~~Avant de commencer~~, ~~assure-toi d’avoir~~ [[Git\|git]] ~~installé sur ta machine~~. ~~Pour vérifier cela~~ :
	~~</div>~~

	<div lang="fr" dir="ltr" class="mw-content-ltr">		<div lang="fr" dir="ltr" class="mw-content-ltr">

Daniela.cojocaru : Page créée avec « The setup is relatively simple. Follow carefully the following steps. »

2026-08-11T11:47:20Z

Page créée avec « The setup is relatively simple. Follow carefully the following steps. »

← Version précédente		Version du 11 août 2026 à 11:47
Ligne 4 :		Ligne 4 :
	The installation steps for Windows 10 and 11 are described below. For Linux and macOS, please also refer to the main SSH guide.		The installation steps for Windows 10 and 11 are described below. For Linux and macOS, please also refer to the main SSH guide.

	~~<div lang="fr" dir="ltr" class="mw-content-ltr">~~		The setup is relatively simple. Follow carefully the following steps.
	~~La mise en place est relativement~~ simple. ~~Suit scrupuleusement les étapes suivantes~~.
	~~</div>~~
	= Prérequis =		= Prérequis =

Daniela.cojocaru : Page créée avec « The installation steps for Windows 10 and 11 are described below. For Linux and macOS, please also refer to the main SSH guide. »

2026-08-11T11:46:48Z

Page créée avec « The installation steps for Windows 10 and 11 are described below. For Linux and macOS, please also refer to the main SSH guide. »

← Version précédente		Version du 11 août 2026 à 11:46
Ligne 2 :		Ligne 2 :
	The aim of this guide is to help you set up a computer to use [[GitLab\|GitLab]] with SSH authentication. It is aimed at beginners: for a more general introduction, see the main page on [[SSH]] and the BR’s [[Astuces_ssh\|advanced tips]].		The aim of this guide is to help you set up a computer to use [[GitLab\|GitLab]] with SSH authentication. It is aimed at beginners: for a more general introduction, see the main page on [[SSH]] and the BR’s [[Astuces_ssh\|advanced tips]].

	~~<div lang="fr" dir="ltr" class="mw-content-ltr">~~		The installation steps for Windows 10 and 11 are described below. For Linux and macOS, please also refer to the main SSH guide.
	~~On décrit les étapes d’installation pour~~ Windows 10 et 11. ~~Pour~~ Linux et macOS, ~~se référer également au~~ guide ~~SSH principal~~.
	~~</div>~~

	<div lang="fr" dir="ltr" class="mw-content-ltr">		<div lang="fr" dir="ltr" class="mw-content-ltr">

Daniela.cojocaru : Page créée avec « The aim of this guide is to help you set up a computer to use GitLab with SSH authentication. It is aimed at beginners: for a more general introduction, see the main page on SSH and the BR’s advanced tips. »

2026-08-11T11:46:24Z

Page créée avec « The aim of this guide is to help you set up a computer to use GitLab with SSH authentication. It is aimed at beginners: for a more general introduction, see the main page on SSH and the BR’s advanced tips. »

Nouvelle page

<languages/>
The aim of this guide is to help you set up a computer to use [[GitLab|GitLab]] with SSH authentication. It is aimed at beginners: for a more general introduction, see the main page on [[SSH]] and the BR’s [[Astuces_ssh|advanced tips]].

<div lang="fr" dir="ltr" class="mw-content-ltr">
On décrit les étapes d’installation pour Windows 10 et 11. Pour Linux et macOS, se référer également au guide SSH principal.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
La mise en place est relativement simple. Suit scrupuleusement les étapes suivantes.
</div>
= Prérequis =

<div lang="fr" dir="ltr" class="mw-content-ltr">
Avant de commencer, assure-toi d’avoir [[Git|git]] installé sur ta machine. Pour vérifier cela :
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
* ouvrir un terminal cmd ou powershell (touche Windows + R, puis taper <code>cmd</code> ou <code>powershell</code>) ;
* taper <code>git -v</code> et vérifier que git est bien installé et, si ce n’est pas le cas, [https://git-scm.com/downloads installe git ici] ;
* taper ensuite <code>ssh -V</code> pour vérifier que ssh est installé et, si ce n’est pas le cas, [https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse installe OpenSSH ici].
</div>

= Mise en place =

== Étape 1 : Générer une clé SSH ==

<div lang="fr" dir="ltr" class="mw-content-ltr">
Ouvre un terminal (cmd ou powershell) et tape la commande suivante :
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
<syntaxhighlight lang="bash">ssh-keygen -t ed25519 -C "ordi portable vaneau"</syntaxhighlight>
En remplaçant <code>ordi portable vaneau</code> par un nom de ton choix. Tu peux laisser les autres champs vides en appuyant simplement sur la touche <code>Entrée</code> pour chaque option.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
À noter qu'il y a une option pour changer le nom de la clé (par défaut <code>id_ed25519</code>) et l’emplacement de sauvegarde. Il y a aussi une autre option pour ajouter un mot de passe (''passphrase'') à la clé, qu'il est recommandé de mettre si ton disque dur n'est pas chiffré.
</div>

<div lang="fr" dir="ltr" class="mw-content-ltr">
{{Attention|Cette commande génère deux fichiers dans le dossier <code>C:\Users\<ton_nom>\.ssh</code> : la clé privée (<code>id_ed25519</code>) et la clé publique (<code>id_ed25519.pub</code>). '''IL NE FAUT EN AUCUN CAS PARTAGER LA CLÉ PRIVÉE'''. C’est la '''clé publique''' qui doit être ajoutée sur Gitlab. On n’insistera jamais assez sur ce point. Toute la sécurité repose sur le fait que la clé privée reste secrète.}}
</div>

== Étape 2 : Ajouter la clé SSH sur Gitlab ==

# Connecte-toi sur Gitlab avec tes identifiants Sigma BR ;
# Clique sur ton avatar en haut à gauche, puis sur <code>Preferences</code>, puis sur <code>SSH Keys</code> (ou va directement sur [https://gitlab.binets.fr/-/user_settings/ssh_keys cette page]) ;
# Clique sur <code>Add new key</code> ;
# Copie le contenu du fichier <code>C:\Users\<ton_nom>\.ssh\id_ed25519.pub</code> (ou un autre chemin si tu as choisi un autre emplacement) en remplaçant <code><ton_nom></code> par ton nom d’utilisateur Windows et colle-le dans le champ <code>Key</code> ;
# (optionnel) Supprime la date d’expiration de la clé si tu veux qu’elle reste valide indéfiniment ;
# Clique sur <code>Add key</code>.

== Étape 3 : Préparer SSH pour utiliser la clé ==

# Ouvre le dossier <code>C:\Users\<ton_nom>\.ssh</code> sur VSCode (ou ton éditeur de texte préféré) ;
# Crée un fichier <code>config</code> ('''sans extension''') ;
# Ajoute le contenu suivant :

Host gitlab.binets.fr
User git
IdentityFile C:\Users\<ton_nom>\.ssh\id_ed25519

En remplaçant <code><ton_nom></code> par ton nom d’utilisateur Windows.

== Étape 4 : Activer l'agent SSH ==

Taper <code>ssh-add -L</code>
* Si ta clef ssh est affichée, tout va bien, tu peux passer à l'étape suivante
* Sinon, suit ces étapes :

=== Sur windows ===

# Aller dans la recherche windows et lancer <code>Services</code>
# Chercher OpenSSH Authentification Agent
# Double cliquer dessus et mettre : <code>Type de démarrage : Automatique</code>
# Appuyer sur démarrer
# Dans un terminal, faire <code>ssh-add</code>

=== Sur Linux/Mac ===

Voilà une solution un peu nulle qu'il faudra refaire à chaque fois que tu redémarre ton ordi. Lance un terminal et tape :

eval `ssh-agent`
ssh-add

N'hésite pas à trouver une meilleure solution et à l'écrire ici.

== Étape 5 : Tester la connexion SSH ==

Pour tester la connexion SSH, ouvre un terminal et tape la commande suivante :

<syntaxhighlight lang="bash">ssh -T gitlab.binets.fr</syntaxhighlight>
Tu devrais voir un message comme ça :

The authenticity of host 'gitlab.binets.fr (129.104.201.46)' can't be established.
ED25519 key fingerprint is SHA256:sn+wsip9OTBcwiY0ZplULWXNij3v3kdj/tP228i2+70.
Are you sure you want to continue connecting (yes/no/[fingerprint])?

Écrit <code>yes</code> puis appuie sur <code>Entrée</code>.

Si tout s’est bien passé, tu devrais voir un message de bienvenue de Gitlab. Dans le cas contraire, vérifie que tu as bien suivi toutes les étapes précédentes. Si tu rencontres des difficultés, n’hésite pas à demander de l’aide au Binet Réseau en permanence ou sur PaniX.

== Étape 6 : Configurer l’identité Git ==

Pour finir, il faut configurer correctement ton identité sur Git. Dans ton terminal, tape les commandes suivantes :

<syntaxhighlight lang="bash">git config --global user.name "<Ton Nom>"
git config --global user.email "<ton.nom>@polytechnique.edu"</syntaxhighlight>
En remplaçant <code><Ton Nom></code> par ton nom et <code><ton.nom>@polytechnique.edu</code> par les valeurs adéquates.

Félicitations ! À partir de là, tu peux utiliser Gitlab avec une authentification SSH.

'''Lorsque tu clones un dépôt, veille bien à choisir le lien SSH et non HTTPS.'''

Mettre en place SSH pour Gitlab/en - Historique des versions

Daniela.cojocaru : Page créée avec « Please note that there is an option to change the key’s name (by default id_ed25519) and the save location. There is also another option to add a passphrase to the key, which is recommended if your hard drive is not encrypted. »

Daniela.cojocaru : Page créée avec « Open a terminal (cmd or powershell) and type the following command: »

Daniela.cojocaru : Page créée avec « Before you start, make sure you have git installed on your computer. To check this: »

Daniela.cojocaru : Page créée avec « The setup is relatively simple. Follow carefully the following steps. »