> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://docs.nua.ge/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Guide Pratique - Clé SSH

# Guide Pratique - Clé SSH

### Créer une clé SSH

Lorsque vous créez une instance Nua.ge, la méthode de connexion repose sur des clés SSH. Ce type d'authentification garantit une meilleure sécurité que les connexions utilisant un simple couple identifiant et mot de passe.

###### Sous Linux et MacOS

Ouvrez votre Terminal, puis exécutez la commande suivante pour générer une clé SSH de 4096 bits :
```bash
ssh-keygen -t rsa -b 4096
```
Choisissez un nom :
```Generating public/private rsa key pair.
Enter file in which to save the key (/home/user/.ssh/id_rsa):```
Définissez une passphrase :
```Enter passphrase (empty for no passphrase): 
Enter same passphrase again: ```
Attendez sa génération :
```Your identification has been saved in id_rsa.
Your public key has been saved in id_rsa.pub.
The key fingerprint is:
SHA256:+Ct6qRgKuD7cAg3Mvuwe+SaSKcLp32JPvtoWOTG0qTA
The key's randomart image is:
+---[RSA 4096]----+
|                 |
|     .           |
|o   . o          |
|.E   = .         |
|.oo . = S        |
|o.o. + .         |
|B==  .o..        |
|B%oB=.+  .       |
|@=O+BX...        |
+----[SHA256]-----+
```
Vérifiez sa présence dans le dossier .ssh :
```bash
 cat .ssh/id_rsa.pub```
Cela doit vous afficher la contenu de votre clé publique :
```ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDdRTtz1Fz1yWcc1CGmNPThs+EwMxZhLvzuhjwqIhL6wG5RQz0fMRSuwawXXyq81b52FFAVi4zSa42XIRJIb/T8JKYC/Kkle2mmOxhbxBHbgbihXFPf4O8K+2lhZVi9UY+e1XEoEfVVyNfwyFnYpFjyDbPeiclvp2l9AkyRIvClV52IWLrCIO9kw8KxApcnlA8HXJBR+AargNKp39ElkZhzx/3Ksep6lMaFzQC0vlYCl0vG68sZ8ARiC+ufqVV/TZNXhCwWu/wv9EYH3mZPqfu+C5JTonG8POW3mBPQ00FC1+NczTzfF/mDAEp5NGO9PG7hcooEBfhDGYGQGDXiguLhDvFxFDxbmz6mjG0CgEiZjwVJZbP0m11DNeCcRdzY65oSY2uFFif7jgGgUvAK6CSvClzybfoYW9VGGQTH34W1t6gCFAZyQdCk+woDrkLAfykrpt1Rb2/4jYGd9m6uRd/e9PDBts8F2bIVXrDwy88gmHo3lzVZfYfzClyV8nVVZkEXIKArWpVffKqYDkGhTL0Tz8TJsQTspgdW+J0hC0ruhcMlM2DiakXotR4i2IPX+FprnXBVu+8Lh3e5FGmzW6qD94VJtBc7S7B3idIAWzyBGg1GVIKJE80I4f/a8FJo0jOlI/YFa0GS7pwET+2kMalUW7Q+nswnKdZhJ3ifOHSNXw
```

### Importer une clé SSH

Tous les membres peuvent importer des clés SSH dans leur profil.
1. À partir de votre Profil cliquez sur Clés SSH
2. Puis cliquez sur Importer une clé
3. Collez la Clé publique et si vous le souhaitez, précisez un Nom de la clé (optionnel)
4. Puis cliquez sur Importer

Cette clé sera instantanément utilisable et vous la retrouverez dans la page de création d’instance.

| Pour être acceptée par Nua.ge, une clé SSH publique doit être au format OpenSSH (débuter par `ssh-rsa`) et être d’une longueur supérieure à 2048 bits.

**Votre clé SSH ne débute pas par ssh-rsa ?**
* Elle débute par `---- BEGIN SSH2 PUBLIC KEY ----` ? Dans ce cas, il vous faut convertir votre clé du format SSH2 au format OpenSSH via la commande suivante : `ssh-keygen -i -f ssh2.pub > openssh.pub`
* Elle débute par `ssh-dsa` ? Cet ancien format n'est plus accepté pour des raisons de sécurité. il vous faudra créer une nouvelle paire de clés SSH.

### Se connecter à une instance via une clé SSH

1. À partir de la liste des instances, cliquez sur le bouton **SSH** qui est visible à droite de l'IP publique
2. Ouvrez votre terminal, naviguer vers le dossier .ssh et collez le contenu de votre presse papier

```bash
ssh ubuntu@192.168.1.170
```
Ajoutez `-i id_rsa` et appuyez sur la touche **Entrer** de votre clavier.

```
ssh ubuntu@192.168.100.100 -i id_rsa
Welcome to Ubuntu 22.04 LTS
```

Vous êtes maintenant connecté à votre instance :)

||| **ATTENTION **: l'ajout d'une clé ssh dans l'interface ne l'ajoute pas aux vm existantes. Cela ne sert qu'à la création de la vm. Vous devez donc bien utiliser la clé ssh fournie à la création de la vm pour pouvoir vous connecter. Une fois fait, vous devez ajouter les éventuelles autres clés à la main dans le fichier .ssh/authorized_keys

### Supprimer une clé SSH

Vous pouvez supprimer une clé SSH présente dans votre profil. Cela n’impactera en rien les instances créées à partir de cette clé.