Code source wiki de FTP(S)

Modifié par Aurelie Bertrand le 2026/01/12 16:46
Afficher les derniers auteurs
1 {{ddtoc/}}
2
3 ----
4
5 = Prérequis =
6
7 * Un serveur FTP(S) (exemple : FileZilla Server)
8 * Vérifier les paramètres de votre serveur pour pouvoir les appliquer à la configuration du client FTP(S) dans Digdash
9 * Ouvrir les ports nécessaires pour que Digdash puisse communiquer avec votre serveur FTP(S)
10 * Une adresse IP visible depuis l’extérieur pour une connexion FTP en mode passif (voir ci-après)
11 * On appellera dans ce document :
12 ** P : le port du serveur FTP (par défaut 21)
13 ** PE : le port FTP explicite sur TLS (par défaut P = PE = 21)
14 ** PI : le port FTP implicite sur TLS (par défaut 990)(((
15 Vous devrez vous adapter en fonction des ports que vous utilisez si ce ne sont pas ceux par défaut.
16 )))
17
18 = Création d’un nouveau serveur de fichiers FTP(S) =
19
20 Vous pouvez créer un nouveau serveur de fichiers FTP(S)  depuis le Studio.
21
22 1. Dans le Studio, cliquez sur le bouton **Gestionnaires **dans la barre latérale de gauche, puis sélectionnez **Serveurs**.
23 ➡ La boite de dialogue **Gestionnaire de serveurs de fichiers** s'affiche.
24 1. Cliquez sur le bouton **+** à droite de la barre de recherche puis, dans le menu qui s'affiche, sélectionnez le type de serveur : FTP ou FTPS.
25 [[image:Add_server_FTP_Studio_FR.png]]
26 ➡ La boite **Ajouter un serveur** s'affiche.
27 [[image:1762511965880-668.png||alt="Nouveau serveur FTP"]]
28 1. Renseignez les champs comme décrit dans le paragraphe Configuration du serveur ci-dessous.
29
30 = (% style="color:inherit; font-family:inherit; font-size:29px" %)Configuration serveur(%%) =
31
32 == Nom du serveur ==
33
34 Donnez un nom à votre nouveau serveur de documents FTP(S).
35
36 == URL ==
37
38 Indiquez dans ce champ l’adresse IP de votre serveur FTP(S).
39
40 == Chemin des documents de l’utilisateur ==
41
42 C’est à partir de ce chemin sur le serveur FTP(S) que Digdash va explorer les fichiers. Si vide, Digdash explorera depuis la racine.
43
44 == Exploration des sous-dossiers ==
45
46 Vous avez la possibilité de limiter le niveau d’exploration à partir de votre chemin de documents.
47
48 Par défaut, la recherche de documents s’effectue de manière récursive et va explorer tous les sous-dossiers.
49
50 |Champs|//Explorer les sous-dossiers//|(% colspan="2" %)//Niveau des sous-dossiers//
51 |(% rowspan="2" %)Valeurs|Activé|(((
52 Vide
53
54 Valeur par défaut, l’exploration s’opère récursivement dans tous les sous-dossiers
55 )))|(((
56 N > 0
57
58 L’exploration s’effectuera dans les N sous-dossier
59 )))
60 |Désactivé|(% colspan="2" %)(((
61 0
62
63 Pas d’exploration dans les sous-dossiers, seulement dans le répertoire courant
64 )))
65
66 == Lecture seule ==
67
68 Seule la lecture est possible si cette option est activée.
69
70 == Nom ==
71
72 Indiquez dans ce champ le nom de votre utilisateur.
73
74 == Mot de passe ==
75
76 Indiquez dans ce champ le mot de passe de votre utilisateur.
77
78 = Mode actif / mode passif{{id name="Mode_FTP"/}} =
79
80 La notion de mode actif et passif est extrêmement importante pour l'utilisation de FTP avec des pare-feux (firewall) :
81
82 //Source : [[www.slacksite.com>>path:/xwiki/bin/create/www/slacksite/com/WebHome?parent=Digdash.deployment.Document_managers.ftps.WebHome]]
83 Source : [[https:~~/~~/wiki.filezilla-project.org/Network_Configuration>>url:https://wiki.filezilla-project.org/Network_Configuration]]//
84
85 === Mode actif ===
86
87 Du point de vue du pare-feu __**côté Serveur FTP**__, les canaux de communication suivants doivent être ouverts pour supporter le mode actif FTP :
88
89 * le port P (21) depuis n’importe où (le Client initie la connexion)
90 * le port P (21) ouvert aux ports > 1023 (le Serveur répond au port de commande/contrôle du Client)
91 * le port P-1 (20) ouvert aux ports > 1023 (le Serveur initie la connexion de données en destination du pour de données du Client)
92 * le port P-1 (20) depuis les ports > 1023 (le Client envoie une notification au port de données du Serveur)
93
94 **Options du mode acti**
95
96 Par défaut, en mode actif, le Client demande au système d’exploitation l’adresse IP de la machine et un port disponible. Cette configuration ne peut fonctionner que si vous êtes directement connecté à internet sans routeur NAT et configuré votre pare-feu pour laisser passer les connexions entrantes sur les ports > 1024.
97
98 Si vous disposez d’un routeur NAT, vous aurez besoin d’indiquer en option votre adresse IP externe.
99
100 Vous avez également la possibilité de limiter le nombre de ports de communication en mode actif.
101
102 === Mode passif (recommandé) ===
103
104 Du point de vue du pare-feu __**côté serveur FTP**__, les canaux de communication suivants doivent être ouverts pour supporter le mode passif FTP :
105
106 * le port P (21) depuis n’importe où (le Client initie la connexion)
107 * le port P (21) ouvert aux ports > 1023 (le Serveur répond au port de commande/contrôle du Client)
108 * les ports > 1023 depuis n’importe où (le Client initie la connexion de données vers un port aléatoire spécifié par le Serveur)
109 * les ports > 1023 ouverts aux ports > 1023 (le Serveur envoie une notification (et les données) vers le port de données du Client)
110
111 Particulièrement pour le mode passif, le client FTP ne voit par défaut que l’adresse IP locale de la machine serveur, qui n’est pas accessible depuis l’extérieur.
112
113 Il vous faudra configurer les paramètres du mode passif de votre serveur FTP pour mentionner une adresse IP visible depuis l’extérieur. Nous prendrons comme exemple un serveur FTP FileZilla Server pour illustrer nos propos :
114
115 [[image:ftp(s)_fr_html_d3a33387067e1ebb.png||queryString="width=554&height=386" data-xwiki-image-style-alignment="center" height="386" width="554"]]
116
117 = Mode FTP sur TLS{{id name="TLS"/}} =
118
119 Pour travailler avec un serveur FTP sécurisé (FTPS) vous devez choisir le protocole nécessaire dans les paramètres de configuration :
120
121 Source : [[www.attachmate.com>>path:/xwiki/bin/create/www/attachmate/com/WebHome?parent=Digdash.deployment.Document_managers.ftps.WebHome]]
122
123 * **Mode FTP explicite sur TLS** : Par défaut, le client FTP établit des connexions SSL/TLS au moyen de la sécurité explicite. Pour établir la connexion SSL, la sécurité explicite exige que le client FTP envoie une commande spécifique (AUTH TLS) au serveur FTP après avoir établi une connexion. Si le serveur répond correctement, le client commence la négociation TLS. Le port PE utilisé est celui du serveur FTP (21 par défaut).
124
125 * **Mode FTP implicite sur TLS** : Lorsque vous sélectionnez Connexion SSL/TLS implicite, le client FTP utilise la sécurité implicite. La sécurité implicite commence automatiquement par une connexion SSL, dès que le client FTP se connecte au serveur. Aucune commande AUTH TLS n'est envoyée avant la négociation TLS.
126
127 Par défaut, le client FTP utilise le port PI = 990 pour les connexions implicites.
128
129 = Actions possibles{{id name="Actions"/}} =
130
131 Via le **Gestionnaire de fichiers**, vous avez la possibilité d’agir sur les fichiers sur le serveur FTP(S).
132 Consultez la page[[ Gestionnaire de fichiers>>doc:Digdash.user_guide.studio.managers.Files.WebHome]] pour plus de détails.
133
134