====== sftp : client ftp pour ssh ======

  * Objet : utilisation de sftp pour transférer des fichiers
  * Niveau requis : {{tag>débutant avisé}}
  * Commentaires : //Le client sftp s'utilise comme un client ftp, mais il permet le transfert de fichier sécurisé via ssh.//
  * Débutant, à savoir : [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] :-)
  * Suivi : {{tag>à-compléter}}{{tag>à-tester}}
    * Création par [[user>smolski]] le 30/12/2012
    * Testé par <...> le <...>
  * Commentaires sur le forum : [[http://debian-facile.org/viewtopic.php?pid=116761#p116761|ici]]((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))

===== Présentation =====

Dans le contexte de Secure Shell (SSH), SFTP décrit ces deux choses-ci :
- un protocole de communication fonctionnant au-dessus de SSH pour transférer et gérer des fichiers à distance
- un programme en ligne de commande qui implémente la partie cliente de ce protocole de communication, comme celui fourni par OpenSSH

Comparé au précédent protocole scp, le protocole SFTP supporte beaucoup plus d'opérations sur des fichiers à distance. Il se comporte plus comme un protocole de système de fichiers. Il est censé être plus indépendant de la plate-forme d'utilisation; par exemple, avec scp, l'extension des wildcards (*) spécifiés par le client sont à la charge du serveur, qui en fait ce qu'il veut, alors que l'architecture de SFTP évite ce genre de problèmes.

Le programme sftp apporte une interface similaire au programme ftp. Le protocole SFTP n'est pas FTP au-dessus de SSL, c'est un protocole conçu intégralement par le groupe de travail IETF SECSH. Certaines implémentations du programme scp utilisent en fait le protocole SFTP à la place du protocole scp.

SFTP est souvent associé au protocole (et au programme) SSH-2, parce qu'ils ont été conçus en même temps par le même groupe.

===== Installation =====

<code root>apt-get update && apt-get install openssh-client</code>

<note info>N'oubliez pas d'installer [[:doc:reseau:ssh|OpenSSH Server]] sur la machine à laquelle vous voulez vous connecter.</note>

===== Connexion =====

<code user>sftp nom_utilisateur_distant@hôte_distant</code>

Exemple
<code user>sftp jojo@192.168.200</code>

===== Utilisation =====

=== Récupérer un fichier ===

<code>get /répertoires_distants/fichier /répertoires_locaux/</code>

=== Récupérer un dossier ===

<code>get -r /répertoires_distants/dossier /répertoires_locaux/</code>

==== Envoyer un fichier ====

<code>put /répertoires_locaux/fichier /répertoires_distants/</code>

==== Envoyer un dossier ====

Il faut au préalable créer le répertoire distant pour l'utiliser :
<code>
mkdir /répertoires_distants/$dossier</code>
<code>put -r /répertoires_locaux/$dossier /répertoires_distants/</code>


===== Voir aussi =====

    * [[:doc:reseau:ssh:tp-sftp-via-openssh-server|Configuration d'OpenSSH comme serveur SFTP]]