Code source wiki de Serveur de documents FTP(S)

Modifié par jhurst le 2021/04/21 10:01
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 = Accès au connecteur FTP(S) =
19
20 * Via le navigateur
21
22 Dans la partie Configuration > Document management
23
24 (% style="text-align:center" %)
25 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_d057beaef5d1f988.png?width=472&height=253&rev=1.1||queryString="width=472&height=253" alt="ftp(s)_fr_html_d057beaef5d1f988.png" height="253" width="472"]]
26
27
28 (% style="text-align:center" %)
29 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_50b6c75132116e78.png?width=486&height=291&rev=1.1||queryString="width=486&height=291" alt="ftp(s)_fr_html_50b6c75132116e78.png" height="291" width="486"]]
30
31 (% style="text-align: center;" %)
32 __Capture : Accès au gestionnaire de documents via le navigateur__
33
34 * Via l’Enterprise Studio Digdash
35
36 Ouvrir l’Enterprise Studio Digdash > **Outils** > **Gestionnaire des serveurs de documents… **> **Nouveau**
37
38 (% style="text-align:center" %)
39 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_d1636be99b64c591.png?width=406&height=122&rev=1.1||queryString="width=406&height=122" alt="ftp(s)_fr_html_d1636be99b64c591.png" height="122" width="406"]]
40
41
42 (% style="text-align:center" %)
43 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_ed5ebcc993927ec3.png?width=487&height=131&rev=1.1||queryString="width=487&height=131" alt="ftp(s)_fr_html_ed5ebcc993927ec3.png" height="131" width="487"]]
44
45 (% style="text-align: center;" %)
46 __Capture : Accès au gestionnaire des serveurs de documents via l’Enterprise Studio__
47
48 |(((
49 (% style="text-align:center" %)
50 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_a403161b37a403b6.png?width=361&height=342&rev=1.1||queryString="width=361&height=342" alt="ftp(s)_fr_html_a403161b37a403b6.png" height="342" width="361"]]
51
52
53
54 )))|(((
55 (% style="text-align:center" %)
56 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_bfa64c5e7db89837.png?width=369&height=366&rev=1.1||queryString="width=369&height=366" alt="ftp(s)_fr_html_bfa64c5e7db89837.png" height="366" width="369"]]
57
58
59
60 )))
61 |(% style="text-align:center" %)__Capture : Nouveau serveur FTP (studio)__|(% style="text-align:center" %)__Capture : Nouveau serveur FTPS (studio)__
62
63 __**OU**__
64
65 La version web est également visible dans le Studio
66
67 Ouvrir l’Enterprise Studio Digdash > **Onglet Document**
68
69 (% style="text-align:center" %)
70 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_958acd3e31f7a0a5.png?width=583&height=316&rev=1.1||queryString="width=583&height=316" alt="ftp(s)_fr_html_958acd3e31f7a0a5.png" height="316" width="583"]]
71
72 (% style="text-align: center;" %)
73 __Capture : Création d’un serveur FTP/FTPS via le Studio Digdash__
74
75
76 |(((
77 (% style="text-align:center" %)
78 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_94460bf500f4e831.png?width=275&height=253&rev=1.1||queryString="width=275&height=253" alt="ftp(s)_fr_html_94460bf500f4e831.png" height="253" width="275"]]
79
80
81
82 )))|(((
83 (% style="text-align:center" %)
84 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_651511e290d5b324.png?width=280&height=274&rev=1.1||queryString="width=280&height=274" alt="ftp(s)_fr_html_651511e290d5b324.png" height="274" width="280"]]
85
86
87
88 )))
89 |(% style="text-align:center" %)__Capture : Nouveau serveur FTP__|(% style="text-align:center" %)__Capture : Nouveau serveur FTPS__
90
91 = Configuration serveur =
92
93 == Nom du serveur ==
94
95 Donnez un nom à votre nouveau serveur de documents FTP(S).
96
97 == URL ==
98
99 Indiquez dans ce champ l’adresse IP de votre serveur FTP(S).
100
101 == Chemin des documents de l’utilisateur ==
102
103 C’est à partir de ce chemin sur le serveur FTP(S) que Digdash va explorer les fichiers. Si vide, Digdash explorera depuis la racine.
104
105 == Exploration des sous-dossiers ==
106
107 Vous avez la possibilité de limiter le niveau d’exploration à partir de votre chemin de documents.
108
109 Par défaut, la recherche de documents s’effectue de manière récursive et va explorer tous les sous-dossiers.
110
111 |Champs|//Explorer les sous-dossiers//|(% colspan="2" %)//Niveau des sous-dossiers//
112 |(% rowspan="2" %)Valeurs|Activé|(((
113 Vide
114
115 Valeur par défaut, l’exploration s’opère récursivement dans tous les sous-dossiers
116 )))|(((
117 N > 0
118
119 L’exploration s’effectuera dans les N sous-dossier
120 )))
121 |Désactivé|(% colspan="2" %)(((
122 0
123
124 Pas d’exploration dans les sous-dossiers, seulement dans le répertoire courant
125 )))
126
127 __Tableau pour l’exploration des documents pour le connecteur Alfresco__
128
129 == Lecture seule ==
130
131 Seule la lecture est possible si cette option est activée.
132
133 == Nom ==
134
135 Indiquez dans ce champ le nom de votre utilisateur.
136
137 == Mot de passe ==
138
139 Indiquez dans ce champ le mot de passe de votre utilisateur.
140
141 = Mode actif / mode passif =
142
143 La notion de mode actif et passif est extrêmement importante pour l'utilisation de FTP avec des pare-feux (firewall) :
144
145 //Source : [[www.slacksite.com>>path:/xwiki/bin/create/www/slacksite/com/WebHome?parent=Digdash.deployment.Document_managers.ftps.WebHome]]
146 Source : [[https:~~/~~/wiki.filezilla-project.org/Network_Configuration>>url:https://wiki.filezilla-project.org/Network_Configuration]]//
147
148 * //Mode actif//
149
150 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 :
151
152 * le port P (21) depuis n’importe où (le Client initie la connexion)
153 * le port P (21) ouvert aux ports > 1023 (le Serveur répond au port de commande/contrôle du Client)
154 * 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)
155 * le port P-1 (20) depuis les ports > 1023 (le Client envoie une notification au port de données du Serveur)
156
157 Options du mode actif
158
159 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.
160
161 Si vous disposez d’un routeur NAT, vous aurez besoin d’indiquer en option votre adresse IP externe.
162
163 Vous avez également la possibilité de limiter le nombre de ports de communication en mode actif.
164
165 |(((
166 (% style="text-align:center" %)
167 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_516857374f4dd826.png?width=281&height=281&rev=1.1||queryString="width=281&height=281" alt="ftp(s)_fr_html_516857374f4dd826.png" height="281" width="281"]]
168
169
170
171 )))|(((
172 (% style="text-align:center" %)
173 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_5eba9f40a425ac59.png?width=290&height=282&rev=1.1||queryString="width=290&height=282" alt="ftp(s)_fr_html_5eba9f40a425ac59.png" height="282" width="290"]]
174
175
176
177 )))
178 |(% style="text-align:center" %)__Capture : options en mode actif du serveur FTP (web)__|(% style="text-align:center" %)__Capture : options en mode actif du serveur FTPS (web)__
179
180 |(((
181 (% style="text-align:center" %)
182 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_39d1b183e51b81b8.png?width=296&height=292&rev=1.1||queryString="width=296&height=292" alt="ftp(s)_fr_html_39d1b183e51b81b8.png" height="292" width="296"]]
183
184
185
186 )))|(((
187 (% style="text-align:center" %)
188 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_4ebb168d082339bf.png?width=283&height=291&rev=1.1||queryString="width=283&height=291" alt="ftp(s)_fr_html_4ebb168d082339bf.png" height="291" width="283"]]
189
190
191
192 )))
193 |(% style="text-align:center" %)__Capture : options en mode actif du serveur FTP (studio)__|(% style="text-align:center" %)__Capture : options en mode actif du serveur FTP (studio)__
194
195 * //Mode passif (recommandé)//
196
197 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 :
198
199 * le port P (21) depuis n’importe où (le Client initie la connexion)
200 * le port P (21) ouvert aux ports > 1023 (le Serveur répond au port de commande/contrôle du Client)
201 * 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)
202 * les ports > 1023 ouverts aux ports > 1023 (le Serveur envoie une notification (et les données) vers le port de données du Client)
203
204 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.
205
206 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 :
207
208 (% style="text-align:center" %)
209 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_d3a33387067e1ebb.png?width=554&height=386&rev=1.1||queryString="width=554&height=386" alt="ftp(s)_fr_html_d3a33387067e1ebb.png" height="386" width="554"]]
210
211 (% style="text-align: center;" %)
212 __Capture : Utilisation d’une adresse externe pour une connexion FTP en mode passif__
213
214 = Mode FTP sur TLS =
215
216 Pour travailler avec un serveur FTP sécurisé (FTPS) vous devez choisir le protocole nécessaire dans les paramètres de configuration :
217
218 Source : [[www.attachmate.com>>path:/xwiki/bin/create/www/attachmate/com/WebHome?parent=Digdash.deployment.Document_managers.ftps.WebHome]]
219
220 * //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).
221 * //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.
222
223 Par défaut, le client FTP utilise le port PI = 990 pour les connexions implicites.
224
225 = Actions possibles =
226
227 Via la version web du gestionnaire des serveurs de documents, vous avez la possibilité d’agir sur les fichiers sur le serveur FTP(S).
228
229 == Téléchargement ==
230
231 (% style="text-align:center" %)
232 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_b43bc0697c466c3b.png?width=403&height=318&rev=1.1||queryString="width=403&height=318" alt="ftp(s)_fr_html_b43bc0697c466c3b.png" height="318" width="403"]]
233
234 (% style="text-align: center;" %)
235 //__Capture : Icône de téléchargement__//
236
237 C’est une action de base. Chaque utilisateur connecté Digdash est autorisé au minimum au droit de lecture.
238
239 Le téléchargement est possible via l’icône [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_fb114753cc5d7478.png?rev=1.1||alt="ftp(s)_fr_html_fb114753cc5d7478.png"]] .
240
241 == Dépôt de documents ==
242
243 (% style="text-align:center" %)
244 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_40606bee02db7003.png?width=729&height=332&rev=1.1||queryString="width=729&height=332" alt="ftp(s)_fr_html_40606bee02db7003.png" height="332" width="729"]]
245
246 (% style="text-align: center;" %)
247 //__Capture : Dépôt de document dans le serveur de documents Google Drive__//
248
249
250 (% class="box infomessage" %)
251 (((
252 Dans Digdash Enterprise, il est vivement conseillé de déposer des documents avec une extension explicite.
253 )))
254
255 Trois options sont disponibles :
256
257 * **Choisissez un fichier local **: cliquez sur **Parcourir... **pour sélectionner le fichier à ajouter. Cliquez sur **OK**.**  **La boîte **Ouvrir  **s'affiche
258 * **Entrer une URL** : Entrez l'URL de votre document. Si la case **Ajouter uniquement le lien URL au serveur de documents **est décochée, le contenu pointé par l'URL est téléchargé une seule fois vers le serveur de documents. Si la case **Ajouter uniquement le lien URL au serveur de documents **est cochée, le contenu pointé par l'URL est téléchargé par le serveur à chaque fois qu'il en a besoin (pour une source de données ou sur demande d'un utilisateur). Dans ce dernier cas, l'URL doit être accessible par le serveur. Vous pouvez aussi insérer des variables utilisateur dans l'URL (${user.uid}... voir documentation). Vous pouvez utiliser une URL "file:~/~/", mais dans ce cas le mode **Ajouter uniquement le lien URL au serveur de documents **est forcé. L'URL "file:~/~/" doit être un fichier sur un disque du serveur. Le nom du lien doit se terminer par l'extension propre au type de fichier ajouté (.csv, .html...).
259 * **Créez un nouveau lien **: Créez un nouveau lien vers un document sur le serveur : Le fichier pointé est le dernier document (dans l'ordre alphabétique) correspondant au lien. Par exemple, un lien « document*.csv » pointera vers le dernier fichier CSV commençant par « document ».
260
261 == Édition de documents ==
262
263 (% style="text-align:center" %)
264 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_3e7a483fbac41cfa.png?width=620&height=279&rev=1.1||queryString="width=620&height=279" alt="ftp(s)_fr_html_3e7a483fbac41cfa.png" height="279" width="620"]]
265
266 (% style="text-align: center;" %)
267 //__Capture : Mise à jour de documents (renommage et mise à jour de contenu)__//
268
269
270 L’action est possible via l’icône [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_5bf0156c61aee07c.png?rev=1.1||alt="ftp(s)_fr_html_5bf0156c61aee07c.png"]] .
271
272 Il peut s’agir des actions suivantes.
273
274 === Mise à jour du contenu ===
275
276 Vous avez la possibilité de mettre à jour le contenu d’un document existant en choisissant un fichier depuis votre système.
277
278 [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_391450f0053994db.jpg?rev=1.1||alt="ftp(s)_fr_html_391450f0053994db.jpg"]] Avec seule cette action, le nom du document sur lequel l’opération s’effectue gardera son nom.
279
280 === Renommage ===
281
282 Vous avez la possibilité de renommer un document. Vous préciserez dans le champ prévu à cet effet le nouveau nom à donner au document sans extension.
283
284 == Suppression ==
285
286 Vous avez la possibilité de supprimer un (ou des) document(s) existant(s) dans le Google Drive du compte de service.
287
288 Si l’utilisateur souhaite supprimer plusieurs documents, il pourra les sélectionner grâce aux checkbox.
289
290 L’action est possible via l’icône [[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_3f54b9224a4c4ef3.png?rev=1.1||alt="ftp(s)_fr_html_3f54b9224a4c4ef3.png"]] .