Comment créer et utiliser un accès SSH dans cPanel Imprimer

L'accès SSH (Secure Shell) permet de se connecter de manière sécurisée à votre compte d'hébergement via une ligne de commande. Cette fonctionnalité est particulièrement utile pour gérer des fichiers, exécuter des scripts, utiliser Git, Composer, WP-CLI ou effectuer des tâches avancées sur votre hébergement.

Prérequis

Avant de commencer :

• L'accès SSH doit être activé sur votre compte d'hébergement.
• Vous devez disposer d'un compte cPanel actif.
• Un client SSH est nécessaire :
  • Windows : PuTTY ou Windows Terminal
  • Linux : Terminal
  • macOS : Terminal

Étape 1 : Accéder au gestionnaire de clés SSH

1. Connectez-vous à votre compte cPanel.
2. Dans la section Sécurité, cliquez sur Gérer les clés SSH.
3. Vous accédez à l'interface de gestion des clés SSH.

Étape 2 : Créer une nouvelle paire de clés SSH

1. Cliquez sur Générer une nouvelle clé.
2. Remplissez les informations suivantes :
   • Nom de la clé : choisissez un nom descriptif.
   • Mot de passe : recommandé pour une sécurité accrue.
   • Type de clé : RSA.
   • Taille de clé : 2048 ou 4096 bits.
3. Cliquez sur Générer une clé.

Une clé publique et une clé privée seront créées automatiquement.

Étape 3 : Autoriser la clé publique

Après la création :

1. Revenez à la page principale du gestionnaire de clés SSH.
2. Dans la section Clés publiques, localisez la clé créée.
3. Cliquez sur Gérer.
4. Cliquez sur Autoriser.

Le statut de la clé doit maintenant afficher Authorized.

Étape 4 : Télécharger la clé privée

1. Dans la section Clés privées, trouvez votre clé.
2. Cliquez sur Afficher/Télécharger.
3. Téléchargez la clé privée sur votre ordinateur.
4. Conservez cette clé dans un endroit sécurisé.

Important : ne partagez jamais votre clé privée.

Étape 5 : Connexion SSH sous Windows avec PuTTY

Conversion de la clé

Si nécessaire :

1. Téléchargez la clé au format PPK depuis cPanel.
2. Ou utilisez PuTTYgen pour convertir la clé privée.

Configuration de PuTTY

1. Ouvrez PuTTY.
2. Entrez le nom du serveur ou votre domaine.
3. Vérifiez que le port SSH est 22.
4. Allez dans :
   Connection → SSH → Auth → Credentials
5. Sélectionnez votre fichier de clé privée (.ppk).
6. Cliquez sur Open.

Connectez-vous avec votre nom d'utilisateur cPanel.

Étape 6 : Connexion SSH sous Linux ou macOS

Placez votre clé privée sur votre ordinateur puis exécutez :

chmod 600 ma-cle-privee

Connectez-vous ensuite :

ssh username@serveur.exemple.com

Remplacez :

• username par votre nom d'utilisateur cPanel
• serveur.exemple.com par le nom d'hôte du serveur

Informations de connexion

Les informations suivantes sont généralement nécessaires :

• Hôte : nom d'hôte du serveur ou domaine
• Port : 22
• Nom d'utilisateur : identifiant cPanel
• Authentification : clé SSH privée

Conseils de sécurité

• Utilisez toujours une clé SSH plutôt qu'un mot de passe lorsque possible.
• Protégez votre clé privée avec un mot de passe.
• Ne partagez jamais votre clé privée.
• Supprimez immédiatement les clés inutilisées.
• Utilisez une taille de clé d'au moins 2048 bits.

Dépannage

Permission denied (publickey)

Cette erreur indique généralement que :

• La clé publique n'est pas autorisée.
• La mauvaise clé privée est utilisée.
• Les permissions de la clé privée sont incorrectes.

Connection refused

Cette erreur peut indiquer que :

• L'accès SSH n'est pas activé sur le compte.
• Le port SSH est bloqué par un pare-feu.
• Le serveur n'accepte pas les connexions SSH.

Si vous rencontrez des difficultés, contactez notre équipe de support technique.