.. _connexion-ssh-sftp:

Se connecter en SSH et SFTP
============================

.. contents:: Sur cette page
   :local:
   :depth: 2

Où trouver les informations de connexion
-----------------------------------------

Toutes les informations nécessaires à la connexion se trouvent dans le
**Dashboard** de votre site :

- **Hôte** (serveur SSH/SFTP)
- **Port**
- **Nom d'utilisateur** (celui que vous avez créé)

.. note::
   Les informations de connexion ne sont disponibles qu'après avoir créé au moins
   un utilisateur SSH/SFTP. Consultez :ref:`creer-utilisateur` si ce n'est pas
   encore fait.

Se connecter en SSH
--------------------

Depuis un terminal (Linux, macOS, Windows PowerShell ou WSL), utilisez la commande
SSH fournie dans votre Dashboard.

Exemple de commande
~~~~~~~~~~~~~~~~~~~

.. code-block:: bash

   ssh demo@web-cloud-ssh.eva-pilote.net -p 49798

.. list-table::
   :header-rows: 1
   :widths: 30 70

   * - Paramètre
     - Description
   * - ``demo``
     - Nom d'utilisateur créé dans votre espace site.
   * - ``web-cloud-ssh.eva-pilote.net``
     - Hôte SSH fourni dans votre Dashboard.
   * - ``49798``
     - Port SSH fourni dans votre Dashboard.

Connexion avec mot de passe
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code-block:: bash

   ssh utilisateur@hote -p PORT
   # Le mot de passe vous sera demandé interactivement

Connexion avec une clé SSH
~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code-block:: bash

   ssh -i /chemin/vers/cle_privee utilisateur@hote -p PORT

.. tip::
   Pour éviter de spécifier le chemin de la clé à chaque fois, ajoutez une entrée
   dans votre fichier ``~/.ssh/config`` :

   .. code-block:: text

      Host mon-cloud-web
          HostName web-cloud-ssh.eva-pilote.net
          User demo
          Port 49798
          IdentityFile ~/.ssh/id_ed25519

   Vous pourrez ensuite vous connecter simplement avec :

   .. code-block:: bash

      ssh mon-cloud-web

Se connecter en SFTP
----------------------------

Pour transférer des fichiers, nous recommandons l'utilisation d'un **client SFTP**
comme `FileZilla <https://filezilla-project.org/>`_ (gratuit, multiplateforme).

SFTP avec mot de passe
~~~~~~~~~~~~~~~~~~~~~~~

Récupérez les informations depuis le **Dashboard** de votre site, puis renseignez
dans FileZilla :

.. list-table::
   :header-rows: 1
   :widths: 35 65

   * - Champ FileZilla
     - Valeur
   * - **Protocole**
     - SFTP — SSH File Transfer Protocol
   * - **Hôte**
     - Adresse fournie dans le Dashboard (ex : ``sftp://web-cloud-ssh.eva-pilote.net``)
   * - **Type d'authentification**
     - Normale
   * - **Nom d'utilisateur**
     - L'utilisateur créé dans **Services → Utilisateurs SFTP**
   * - **Mot de passe**
     - Le mot de passe défini lors de la création de l'utilisateur
   * - **Port**
     - Le port fourni dans le Dashboard

SFTP avec une clé SSH
~~~~~~~~~~~~~~~~~~~~~~

📄 `Se connecter en SFTP avec une clé SSH <https://doc.dri.fr/hebergement-web/publication.html>`_

.. seealso::
   En cas de problème de connexion, vérifiez que le bon port est utilisé et que
   votre utilisateur est bien actif. Vous pouvez ouvrir un ticket depuis l'onglet
   **Tickets** de votre espace site.