Accéder à votre compte en SSH

SSH permet de gérer les fichiers et d'exécuter les outils de votre hébergement via une connexion chiffrée. C'est utile pour Git, Composer, les imports et les tâches qui nécessitent un terminal. Les commandes s'exécutent avec les droits de votre compte d'hébergement.

N'oubliez pas que l'accès SSH doit être activé depuis les options du service d'hébergement disponibles dans l'espace client.

Terminal intégré à cPanel

cPanel inclut un terminal intégré, qui facilite l'accès si vous ne voulez pas configurer de client SSH.

Se connecter à votre compte en SSH

Si vous débutez avec le terminal ou si l'accès sera occasionnel, nous vous recommandons d'utiliser le terminal intégré à cPanel.

La méthode de connexion dépend du système d'exploitation que vous utilisez ; voici les étapes pour chaque cas.

• Le port SSH habituel chez Hostsuar est le 93. Vérifiez la donnée du service ; un port différent ne remplace pas l'authentification par une clé protégée.

Windows

Téléchargez PuTTYgen depuis son site officiel :

• Télécharger PuTTY depuis son site officiel

Dans PuTTYgen, générez une clé de type EdDSA avec la courbe Ed25519, protégez-la avec une phrase de passe longue et unique et enregistrez la clé privée .ppk uniquement sur votre ordinateur. Copiez la clé publique, accédez à cPanel, section SSH Access → Manage SSH Keys, importez-la et cliquez sur Manage Authorization pour l'autoriser. N'envoyez et ne téléversez jamais la clé privée.

Pour terminer, ouvrez PuTTY et allez dans Connection → SSH → Auth → Credentials. Dans Private key file for authentication, cliquez sur Browse et sélectionnez la clé privée enregistrée avec PuTTYgen.

Allez maintenant dans Session et remplacez le port par 93, saisissez dans Host Name le nom du serveur qui figure dans les données techniques de l'hébergement, puis cliquez sur Open. Avant d'accepter l'alerte, comparez l'empreinte affichée avec l'empreinte du serveur obtenue par un canal indépendant et de confiance ; ne cliquez jamais sur Yes sans l'avoir vérifiée. Saisissez ensuite l'utilisateur cPanel et la phrase de passe de la clé. Vous pouvez charger la clé dans Pageant pour ne pas taper la phrase à chaque connexion, sans l'enregistrer dans des sessions ou des scripts.

Linux et macOS

Ouvrez le terminal ou la console sur votre ordinateur et exécutez la commande suivante pour générer les clés publique et privée (si vous ne les avez pas déjà) :

ssh-keygen -t ed25519 -a 100

Si une clé existe déjà à l'emplacement proposé, ne l'écrasez pas : choisissez un autre nom et utilisez ce chemin dans les commandes suivantes. Saisissez une phrase de passe longue et unique lorsqu'elle vous est demandée. À la fin, deux fichiers auront été créés dans le répertoire .ssh : id_ed25519 et id_ed25519.pub ; le premier est la clé privée et ne doit jamais quitter votre ordinateur, le second est la clé publique.

C'est cette clé publique qu'il faut « envoyer » sur votre compte d'hébergement pour que le service SSH vous permette de vous connecter avec cette identité. La phrase de passe protège la clé privée et est différente du mot de passe de cPanel.

Accédez à cPanel, section « SSH Access », et cliquez sur « Manage SSH Keys »

Allez dans l'option Import Key et collez le contenu de id_ed25519.pub dans « Paste the public key into the following text box: »

Revenez à la page précédente : la clé importée apparaît dans la liste ; cliquez sur Manage Authorization pour autoriser cette clé.

Si aucun agent n'est déjà disponible dans la session, vous pouvez le démarrer avec la première commande. Ajoutez ensuite la clé pour que la phrase de passe ne soit pas écrite dans des commandes ni enregistrée dans des scripts :

eval "$(ssh-agent -s)"
ssh-add "$HOME/.ssh/id_ed25519"

Avant la première connexion, obtenez l'empreinte de la clé du serveur par un canal indépendant et de confiance. Comparez cette empreinte avec celle qu'affiche le client SSH et annulez si elle ne correspond pas ; ne répondez pas yes à l'aveugle. Vous pourrez ensuite vous connecter :

ssh -p 93 -i "$HOME/.ssh/id_ed25519" usuario_cpanel@servidor.example.com

Erreurs possibles

• Toutes les étapes se déroulent correctement, vous parvenez à vous connecter, mais le message suivant s'affiche :

Shell access is not enabled on your account!
If you need shell access please contact support.

Dans ce cas, l'accès Shell est désactivé ; vous pouvez activer l'accès SSH depuis l'espace client.

• Quand je tape le mot de passe, rien ne s'affiche.

Le terminal n'affiche ni caractères ni astérisques lorsque vous saisissez un mot de passe ou une phrase de passe. Tapez-le et appuyez sur Entrée ; l'accès aboutira si l'authentification est valide.

Autres erreurs fréquentes

• Timeout ou Connection refused : vérifiez l'hôte, le port et la sortie réseau. Un domaine derrière Cloudflare peut ne pas diriger SSH vers le serveur d'hébergement.
• Permission denied (publickey) : vérifiez l'utilisateur cPanel, la clé privée sélectionnée et l'autorisation de sa partie publique. L'importer ne l'autorise pas toujours automatiquement.
• REMOTE HOST IDENTIFICATION HAS CHANGED : confirmez auprès de l'assistance si la clé du serveur a changé avant de modifier known_hosts.

Pour quitter, utilisez exit. Si vous n'utilisez plus une clé ou si l'ordinateur est perdu, révoquez son autorisation dans cPanel. Changer le mot de passe de cPanel ne révoque pas à lui seul une clé publique autorisée.