| Prochaine révision | Révision précédenteDernière révisionLes deux révisions suivantes |
| en:documentation:tutorials:ssh:putty [2020/06/10 14:33] – créée fleroux | en:documentation:tutorials:ssh:putty [2020/08/25 15:58] – modification externe 127.0.0.1 |
|---|
| Configuration documentation for PuTTY/KiTTY and WinSCP in the PSMN environment (Click on the following images if you want to view them in normal resolution). | Configuration documentation for PuTTY/KiTTY and WinSCP in the PSMN environment (Click on the following images if you want to view them in normal resolution). |
| |
| <note warning>If you are using **Windows 10**, please refer to [[documentation:tutorials:ssh:windows10|this documentation]]</note> | <note warning>If you are using **Windows 10**, please refer to [[en:documentation:tutorials:ssh:windows10|this documentation]]</note> |
| |
| ===== References ===== | ===== References ===== |
| |
| Don't worry, these adjustments only have to be made once. You will then be able to copy and rename the saved sessions. | Don't worry, these adjustments only have to be made once. You will then be able to copy and rename the saved sessions. |
| ==== 3.2 First connection & backup of .ssh/authorized_keys ==== | ==== 3.2 First connection ==== |
| | |
| | **And backup of .ssh/authorized_keys** |
| |
| * **If necessary**, validate the addition of the Gateway HostKey to PuTTY's cache. | * **If necessary**, validate the addition of the Gateway HostKey to PuTTY's cache. |
| * Enter your SNS, CBP or NCSP password when prompted. | * Enter your SNS, CBP or NCSP password when prompted. |
| |
| * The NCMSP Gateway has very few tools at its disposal. Connect to an internal machine ([[documentation:clusters:services#serveurs_de_compilation|See the list of compilation servers]]. Accept the addition of the HostKey to the SSH cache), then edit the file ''~/.ssh/authorized_keys''. | * The PSMN Gateway has very few tools at its disposal. Connect to an internal machine: ([[documentation:clusters:services#serveurs_de_compilation|See the list of compilation servers]]. Accept the addition of the HostKey to the SSH cache), then edit the file ''~/.ssh/authorized_keys''. |
| {{:documentation:tutorials:ssh_vim_authorized_keys.png?direct&300|}} | {{:documentation:tutorials:ssh_vim_authorized_keys.png?direct&300|}} |
| |
| * You can now log out (Ctrl+d or logout) | * You can now log out (Ctrl+d or logout) |
| |
| ==== 3.3 Chargement de la clef dans Pageant (PuTTY Agent) ==== | ==== 3.3 Loading the key into Pageant (PuTTY Agent) ==== |
| |
| PuTTY Agent sert à maintenir en mémoire une copie de votre clef déverrouillée, à disposition des logiciels utilisant le protocole SSH (PuTTY, WinSCP, TortoiseSVN, etc). | PuTTY Agent is used to keep a copy of your unlocked key in memory, available to software using the SSH protocol (PuTTY, WinSCP, TortoiseSVN, etc). |
| |
| * Une fois Pageant démarré, son menu est disponible par clic-droit, sur la barre de notification. | * Once Pageant is started, its menu is available by right-clicking on the notification bar. |
| * Choisissez ''add key''. | * Choose ''add key''. |
| {{:documentation:tutorials:pagent_menu.png?direct&|}} | {{:documentation:tutorials:pagent_menu.png?direct&|}} |
| |
| * Choisissez votre clef privée (fichier ppk). | * Choose your private key (ppk file). |
| {{:documentation:tutorials:pagent_selectkey.png?direct&300|}} | {{:documentation:tutorials:pagent_selectkey.png?direct&300|}} |
| |
| * Entrez la passphrase de votre clef privée afin de la déverrouiller. | * Enter the passphrase of your private key to unlock it. |
| {{:documentation:tutorials:pagent_passphrase.png?direct&|}} | {{:documentation:tutorials:pagent_passphrase.png?direct&|}} |
| |
| * Votre clef est chargée, et visible dans la liste. | * Your key is loaded, and visible in the list. |
| {{:documentation:tutorials:pagent_keylist.png?direct&300|}} | {{:documentation:tutorials:pagent_keylist.png?direct&300|}} |
| |
| ==== 3.4 Connexion normale (PuTTY et Pageant) ==== | ==== 3.4 Normal connection (PuTTY and Pageant) ==== |
| |
| * Une fois votre clef chargée dans Pageant, | * Once your key is loaded into Pageant. |
| * Démarrez PuTTY, choisissez la session précedemment enregistrée (ici, allo-psmn), cliquez sur ''Load'', puis sur ''Open''. | * Start PuTTY, choose the previously saved session (here, allo-psmn), click on ''Load'', then on ''Open''. |
| {{:documentation:tutorials:putty_conf_session.png?direct&300|}} | {{:documentation:tutorials:putty_conf_session.png?direct&300|}} |
| |
| * Voilà le résultat souhaité. : | * This is the desired result. : |
| {{:documentation:tutorials:putty_normal_session.png?direct&300|}} | {{:documentation:tutorials:putty_normal_session.png?direct&300|}} |
| |
| |
| ==== 3.5 Configurer le proxy PuTTY (plink) ==== | ==== 3.5 Configuring the PuTTY proxy (plink) ==== |
| |
| <note important> | <note important> |
| Vous **devez** utiliser une clef et l'agent-ssh de PuTTY pour pouvoir profiter des facilités du proxy ''plink'', celui-ci n'étant pas interactif (il ne saura pas demander de mot de passe).</note> | You **must** use a key and the PuTTY ssh-agent to be able to take advantage of the facilities of the ''plink'' proxy, this one is not interactive (it will not be able to ask for a password).</note> |
| |
| Le proxy de PuTTY permet de faire des rebond ssh, à travers plusieurs machines ({{:documentation:tutorials:diagramme_ssh_putty.png?linkonly|voir infographie}}). | PuTTY's proxy allows ssh bounces, through several machines |
| | ({{:documentation:tutorials:diagramme_ssh_putty.png?linkonly|voir infographie}}). |
| |
| __Légende :__ | __Légende :__ |
| * **noir** : lien physique | * **black** : physical connection |
| * <wrap round notice>bleu</wrap> : connexion ssh standard | * <wrap round notice>blue</wrap> : standard ssh connection |
| * <wrap round danger>rouge</wrap> : connexion ssh virtuelle (rebonds) | * <wrap round danger>red</wrap> : virtual ssh connection (bounce) |
| * <wrap round safety>vert</wrap> : liaison NFS (/home) | * <wrap round safety>green</wrap> : NFS link (/home) |
| |
| {{:documentation:tutorials:diagramme_ssh_putty.png?direct&800| }} | {{:documentation:tutorials:diagramme_ssh_putty.png?direct&800| }} |
| |
| Dans la suite, on considère que votre clef privée est chargée par ''pageant'' ([[documentation:tutorials:ssh:putty#chargement_de_la_clef_dans_pageant_putty_agent|voir paragraphe 3.3]]). | In the following, we consider that your private key is loaded by ''pageant'' ([[documentation:tutorials:ssh:putty#chargement_de_la_clef_dans_pageant_putty_agent|see section 3.3]]). |
| |
| === Cas 1 : vous êtes à l'intérieur du réseau de l'ENS === | === Case 1: you are inside the ENS network === |
| |
| * Copiez la session de la passerelle (allo-psmn, Load, renommez, save). | * Copy the gateway session (allo-psmn, Load, rename, save). |
| |
| Changez le ''Host Name'' pour celui d'une machine interne du PSMN (ici, pour l'exemple, x5770comp1). Donc, renommez la session en **x5770comp1** (pour suivre l'exemple) | Change the "Host Name" to that of an internal machine of the PSMN (here, for the example, x5770comp1). So, rename the session to **x5770comp1** (to follow the example) |
| |
| {{:documentation:tutorials:putty_conf_session_x5770.png?direct&300|}}. | {{:documentation:tutorials:putty_conf_session_x5770.png?direct&300|}}. |
| |
| * Dans ''Connection->Proxy'', sélectionnez ''Local''. | * In ''Connection->Proxy'', select ''Local''. |
| * Dans ''Connection->Proxy'', réglez ''Telnet command'' ainsi : <code>plink.exe -load allo-psmn -nc %host:%port</code> | * In ''Connection->Proxy'', set "Telnet command" as follows : <code>plink.exe -load allo-psmn -nc %host:%port</code> |
| |
| {{:documentation:tutorials:putty_conf_conn_proxy_x5770.png?direct&300|}} | {{:documentation:tutorials:putty_conf_conn_proxy_x5770.png?direct&300|}} |
| |
| * Revenez dans ''Session'', sauvegardez, puis cliquez sur ''Open''. Vous êtes, normalement, directement connecté sur x5770comp1, sans terminal ouvert sur la passerelle (allo-psmn). | * Return to ''Session'', save, then click ''Open''. You are normally directly connected to x5770comp1, without a terminal open on the gateway (allo-psmn). |
| |
| === Cas 2 : vous êtes à l'extérieur du réseau de l'ENS === | === Case 2: you are outside the ENS network === |
| |
| <note important>**Si vous disposez d'un compte ENS de Lyon, vous devez avoir activé votre accès SSH dans l'intranet** | <note important>**If you have an ENS de Lyon account, you must have activated your SSH access in the intranet**. |
| [[https://ent.ens-lyon.fr/ent/]] Rubrique "Mon profil" -> "Accès SSH"</note> | [[https://ent.ens-lyon.fr/ent/]] Section "My Profile" -> "SSH Access"</note> |
| |
| <note important> | <note important> |
| Si vous ne disposez pas d'un compte ENS, remplacez **ssh.ens-lyon.fr** par **ssh.psmn.ens-lyon.fr** dans la documentation qui suit. | If you do not have an ENS account, replace **ssh.ens-lyon.fr** by **ssh.psmn.ens-lyon.fr** in the following documentation. |
| </note> | </note> |
| |
| * Copiez la session de la passerelle (allo-psmn, Load, renommer en **ssh.ens** (ou **ssh.psmn**), save). Changez le ''Host Name'' pour celui de la passerelle de l'ENS de Lyon (''ssh.ens-lyon.fr'') ou du PSMN (''ssh.psmn.ens-lyon.fr''). Sauvegardez. | * Copy the gateway session (allo-psmn, Load, rename to **ssh.ens** (or **ssh.psmn**), save). Change the ''Host Name'' for that of the ENS de Lyon gateway (''ssh.ens-lyon.fr'') or of the PSMN (''ssh.psmn.ens-lyon.fr''). Save. |
| |
| {{:documentation:tutorials:putty_conf_session_ext.png?direct&300|}} | {{:documentation:tutorials:putty_conf_session_ext.png?direct&300|}} |
| |
| * Revenez dans la session de la passerelle (allo-psmn, Load) | * Return to the gateway session (allo-psmn, Load) |
| |
| * Dans ''Connection->Proxy'', sélectionnez ''Local''. | * In ''Connection->Proxy'', select ''Local''. |
| * Dans ''Connection->Proxy'', réglez ''Telnet command'' ainsi : <code>plink.exe -load ssh.ens -nc %host:%port</code> ou <code>plink.exe -load ssh.psmn -nc %host:%port</code> | * In ''Connection->Proxy'', set ''Telnet command'' as follows : <code>plink.exe -load ssh.ens -nc %host:%port</code> or <code>plink.exe -load ssh.psmn -nc %host:%port</code> |
| |
| {{:documentation:tutorials:putty_conf_conn_proxy_ext.png?direct&300|}} | {{:documentation:tutorials:putty_conf_conn_proxy_ext.png?direct&300|}} |
| |
| * Revenez dans ''Session'', sauvegardez. | * Go back to "Session", save. |
| * Chargez la session de la passerelle de l'ENS de Lyon (ssh.ens, Load) | * Load the Lyon ENS gateway session (ssh.ens, Load) |
| * Cliquez sur ''Open''. **Reproduisez les étapes du [[documentation:tutorials:ssh:putty&#premiere_connexion_sauvegarde_de_ssh_authorized_keys|paragraphe 3.2]]** directement sur la machine ''ssh.ens-lyon.fr''. | * Click on ''Open''. **Reproduce the steps of the [[en:documentation:tutorials:ssh:putty#first_connection|section 3.2]]** directly on the ''ssh.ens-lyon.fr'' machine. |
| |
| * Revenez dans la session de la passerelle (allo-psmn, Load), puis cliquez sur ''Open''. Vous êtes, normalement, directement connecté sur allo-psmn. | * Return to the gateway session (allo-psmn, Load), then click ''Open''. You are normally directly connected to allo-psmn. |
| |
| Il est possible de faire plus d'un rebond avec Putty en rappelant à chaque fois la session précédente avec la commande plink. Vous pouvez donc vous connecter sur une machine interne directement depuis l'extérieur. Pour cela, créez une troisième connexion en suivant les étapes du [[documentation:tutorials:ssh:putty&#cas_1vous_etes_a_l_interieur_du_reseau_de_l_ens|cas 1 ci-dessus]]. | It is possible to make more than one bounce with Putty by recalling the previous session each time with the plink command. So you can connect to an internal machine directly from the outside. To do this, create a third connection by following the steps of the [[en:documentation:tutorials:ssh:putty#configuring_the_putty_proxy_plink|Case 1 above]]. |
| |
| |
| ===== 4. WinSCP ===== | ===== 4. WinSCP ===== |
| |
| Le logiciel WinSCP sert à la copie de fichiers, en utilisant le protocole SSH (et les sessions PuTTY). | The WinSCP software is used to copy files, using the SSH protocol (and PuTTY sessions prepared in previous paragraph). |
| |
| <note important>**Cette documentation part du principe que votre poste client se trouve à l'intérieur du réseau de l'École**</note> | <note important>**This documentation assumes that your client workstation is within the School's network.**</note> |
| |
| |
| ==== 4.1 Configuration, Import & Connexion ==== | ==== 4.1 Configuration, Import & Connexion ==== |
| |
| * Dans WinSCP, au premier lancement, cliquez sur ''Outils->Importer'' : | * In WinSCP, at the first launch, click on ''Tools->Import''. : |
| {{:documentation:tutorials:winscp_sessions_import_a.png?direct&300|}} | {{:documentation:tutorials:winscp_sessions_import_a.png?direct&300|}} |
| |
| * Selectionnez toutes vos sessions PuTTY, **y compris allo-psmn**, cochez la case "importer les clefs d'hotes...", Validez. | * Select all your PuTTY sessions, **including allo-psmn**, check the box "import host keys...", Validate. |
| {{:documentation:tutorials:winscp_sessions_import_b.png?direct&300|}} | {{:documentation:tutorials:winscp_sessions_import_b.png?direct&300|}} |
| |
| * Si vous avez oublié d'importer les HostKeys, vous aurez ce message : | * If you forgot to import HostKeys, you will get this message : |
| {{:documentation:tutorials:winscp_hostkey.png?direct&300|}} | {{:documentation:tutorials:winscp_hostkey.png?direct&300|}} |
| |
| * Selectionnez une des sessions, puis cliquez sur ''Connecter''. | * Select one of the sessions, then click on ''Connect''. |
| |
| * Enfin, après connexion, vous obtiendrez ce panneau : | * Finally, after logging in, you will get this panel: |
| {{:documentation:tutorials:winscp_panels.png?direct&300|}} | {{:documentation:tutorials:winscp_panels.png?direct&300|}} |
| |
| Vous pouvez maintenant copier des fichiers vers ou depuis le PSMN. | You can now copy files to or from the PSMN. |
| |
| ===== 5. Export X, Xming ===== | ===== 5. Export X, Xming ===== |
| |
| Si vous souhaitez afficher des applications graphiques depuis une machine du PSMN vers votre poste client sous Windows, il faut installer un ''serveur X'' : Le plus simple, fonctionnant trés bien avec PuTTY, est [[http://sourceforge.net/projects/xming/|Xming]] | If you want to display graphical applications from a PSMN machine to your Windows client, you have to install an "X server": The simplest, working very well with PuTTY, is to install an "X server". [[http://sourceforge.net/projects/xming/|Xming]] |
| |
| Le PSMN dispose d'une machine dédiée à la visualisation graphique, voir [[documentation:tutorials:visualisation|cette documentation]] pour son usage. | The PSMN has a machine dedicated to graphic visualization, see [[documentation:tutorials:visualisation|this documentation]] for his use. |
