Serveur de documents FTP(S)

= Prérequis[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=1||class="edit_section" role="button" title="Modifier"]](%%) =

24

25

* Un serveur FTP(S) (exemple : FileZilla Server)

26

* Vérifier les paramètres de votre serveur pour pouvoir les appliquer à la configuration du client FTP(S) dans Digdash

27

* Ouvrir les ports nécessaires pour que Digdash puisse communiquer avec votre serveur FTP(S)

28

* Une adresse IP visible depuis l’extérieur pour une connexion FTP en mode passif (voir ci-après)

29

* On appellera dans ce document :

30

** P : le port du serveur FTP (par défaut 21)

31

** PE : le port FTP explicite sur TLS (par défaut P = PE = 21)

32

** PI : le port FTP implicite sur TLS (par défaut 990)(((

33

Vous devrez vous adapter en fonction des ports que vous utilisez si ce ne sont pas ceux par défaut.

34

)))

35

36

= Accès au connecteur FTP(S)[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=2||class="edit_section" role="button" title="Modifier"]](%%) =

* Via le navigateur

Dans la partie Configuration > Document management

41

42

(% style="text-align:center" %)

43

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_d057beaef5d1f988.png?width=472&height=253&rev=1.1||alt="ftp(s)_fr_html_d057beaef5d1f988.png" height="253" width="472"]]

44

45

46

(% style="text-align:center" %)

47

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_50b6c75132116e78.png?width=486&height=291&rev=1.1||alt="ftp(s)_fr_html_50b6c75132116e78.png" height="291" width="486"]]

48

49

(% style="text-align: center;" %)

50

__Capture : Accès au gestionnaire de documents via le navigateur__

51

52

* Via l’Enterprise Studio Digdash

53

54

Ouvrir l’Enterprise Studio Digdash > **Outils** > **Gestionnaire des serveurs de documents… **> **Nouveau**

55

56

(% style="text-align:center" %)

57

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_d1636be99b64c591.png?width=406&height=122&rev=1.1||alt="ftp(s)_fr_html_d1636be99b64c591.png" height="122" width="406"]]

58

59

60

(% style="text-align:center" %)

61

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_ed5ebcc993927ec3.png?width=487&height=131&rev=1.1||alt="ftp(s)_fr_html_ed5ebcc993927ec3.png" height="131" width="487"]]

62

63

(% style="text-align: center;" %)

64

__Capture : Accès au gestionnaire des serveurs de documents via l’Enterprise Studio__

65

66

|(((

67

(% style="text-align:center" %)

68

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_a403161b37a403b6.png?width=361&height=342&rev=1.1||alt="ftp(s)_fr_html_a403161b37a403b6.png" height="342" width="361"]]

)))|(((

(% style="text-align:center" %)

74

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_bfa64c5e7db89837.png?width=369&height=366&rev=1.1||alt="ftp(s)_fr_html_bfa64c5e7db89837.png" height="366" width="369"]]

)))

|(% style="text-align:center" %)__Capture : Nouveau serveur FTP (studio)__|(% style="text-align:center" %)__Capture : Nouveau serveur FTPS (studio)__

__**OU**__

La version web est également visible dans le Studio

84

85

Ouvrir l’Enterprise Studio Digdash > **Onglet Document**

86

87

(% style="text-align:center" %)

88

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_958acd3e31f7a0a5.png?width=583&height=316&rev=1.1||alt="ftp(s)_fr_html_958acd3e31f7a0a5.png" height="316" width="583"]]

89

90

(% style="text-align: center;" %)

91

__Capture : Création d’un serveur FTP/FTPS via le Studio Digdash__

|(((

(% style="text-align:center" %)

96

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_94460bf500f4e831.png?width=275&height=253&rev=1.1||alt="ftp(s)_fr_html_94460bf500f4e831.png" height="253" width="275"]]

)))|(((

(% style="text-align:center" %)

102

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_651511e290d5b324.png?width=280&height=274&rev=1.1||alt="ftp(s)_fr_html_651511e290d5b324.png" height="274" width="280"]]

)))

|(% style="text-align:center" %)__Capture : Nouveau serveur FTP__|(% style="text-align:center" %)__Capture : Nouveau serveur FTPS__

108

109

= Configuration serveur[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=3||class="edit_section" role="button" title="Modifier"]](%%) =

110

111

== Nom du serveur[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=4||class="edit_section" role="button" title="Modifier"]](%%) ==

112

113

Donnez un nom à votre nouveau serveur de documents FTP(S).

114

115

== URL[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=5||class="edit_section" role="button" title="Modifier"]](%%) ==

116

117

Indiquez dans ce champ l’adresse IP de votre serveur FTP(S).

118

119

== Chemin des documents de l’utilisateur[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=6||class="edit_section" role="button" title="Modifier"]](%%) ==

120

121

C’est à partir de ce chemin sur le serveur FTP(S) que Digdash va explorer les fichiers. Si vide, Digdash explorera depuis la racine.

122

123

== Exploration des sous-dossiers[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=7||class="edit_section" role="button" title="Modifier"]](%%) ==

124

125

Vous avez la possibilité de limiter le niveau d’exploration à partir de votre chemin de documents.

126

127

Par défaut, la recherche de documents s’effectue de manière récursive et va explorer tous les sous-dossiers.

128

129

|Champs|//Explorer les sous-dossiers//|(% colspan="2" %)//Niveau des sous-dossiers//

130

|(% rowspan="2" %)Valeurs|Activé|(((

131

Vide

132

133

Valeur par défaut, l’exploration s’opère récursivement dans tous les sous-dossiers

)))|(((

N > 0

L’exploration s’effectuera dans les N sous-dossier

138

)))

139

|Désactivé|(% colspan="2" %)(((

140

0

141

142

Pas d’exploration dans les sous-dossiers, seulement dans le répertoire courant

143

)))

144

145

__Tableau pour l’exploration des documents pour le connecteur Alfresco__

146

147

== Lecture seule[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=8||class="edit_section" role="button" title="Modifier"]](%%) ==

148

149

Seule la lecture est possible si cette option est activée.

150

151

== Nom[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=9||class="edit_section" role="button" title="Modifier"]](%%) ==

152

153

Indiquez dans ce champ le nom de votre utilisateur.

154

155

== Mot de passe[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=10||class="edit_section" role="button" title="Modifier"]](%%) ==

156

157

Indiquez dans ce champ le mot de passe de votre utilisateur.

158

159

= Mode actif / mode passif[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=11||class="edit_section" role="button" title="Modifier"]](%%) =

160

161

La notion de mode actif et passif est extrêmement importante pour l'utilisation de FTP avec des pare-feux (firewall) :

162

163

//Source : [[www.slacksite.com>>path:/xwiki/bin/create/www/slacksite/com/WebHome?parent=Digdash.deployment.Document_managers.ftps.WebHome]]

164

Source : [[https:~~/~~/wiki.filezilla-project.org/Network_Configuration>>url:https://wiki.filezilla-project.org/Network_Configuration]]//

* //Mode actif//

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 :

169

170

* le port P (21) depuis n’importe où (le Client initie la connexion)

171

* le port P (21) ouvert aux ports > 1023 (le Serveur répond au port de commande/contrôle du Client)

172

* 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)

173

* le port P-1 (20) depuis les ports > 1023 (le Client envoie une notification au port de données du Serveur)

174

175

Options du mode actif

176

177

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.

178

179

Si vous disposez d’un routeur NAT, vous aurez besoin d’indiquer en option votre adresse IP externe.

180

181

Vous avez également la possibilité de limiter le nombre de ports de communication en mode actif.

182

183

|(((

184

(% style="text-align:center" %)

185

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_516857374f4dd826.png?width=281&height=281&rev=1.1||alt="ftp(s)_fr_html_516857374f4dd826.png" height="281" width="281"]]

)))|(((

(% style="text-align:center" %)

191

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_5eba9f40a425ac59.png?width=290&height=282&rev=1.1||alt="ftp(s)_fr_html_5eba9f40a425ac59.png" height="282" width="290"]]

)))

|(% 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)__

197

198

|(((

199

(% style="text-align:center" %)

200

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_39d1b183e51b81b8.png?width=296&height=292&rev=1.1||alt="ftp(s)_fr_html_39d1b183e51b81b8.png" height="292" width="296"]]

)))|(((

(% style="text-align:center" %)

206

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_4ebb168d082339bf.png?width=283&height=291&rev=1.1||alt="ftp(s)_fr_html_4ebb168d082339bf.png" height="291" width="283"]]

)))

|(% 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)__

212

213

* //Mode passif (recommandé)//

214

215

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 :

216

217

* le port P (21) depuis n’importe où (le Client initie la connexion)

218

* le port P (21) ouvert aux ports > 1023 (le Serveur répond au port de commande/contrôle du Client)

219

* 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)

220

* les ports > 1023 ouverts aux ports > 1023 (le Serveur envoie une notification (et les données) vers le port de données du Client)

221

222

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.

223

224

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 :

225

226

(% style="text-align:center" %)

227

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_d3a33387067e1ebb.png?width=554&height=386&rev=1.1||alt="ftp(s)_fr_html_d3a33387067e1ebb.png" height="386" width="554"]]

228

229

(% style="text-align: center;" %)

230

__Capture : Utilisation d’une adresse externe pour une connexion FTP en mode passif__

231

232

= (% class="ID0 annotation annotation-highlight" %)Mode FTP explicite sur TLS(%%)[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=12||class="edit_section" role="button" title="Modifier"]](%%) =

233

234

(% class="ID0 annotation annotation-highlight" %)Mode FTP implicite sur TLS

235

(seulement FTPS)

236

237

(% class="ID0 annotation annotation-highlight" %)Pour travailler avec un serveur FTP sécurisé (FTPS) vous devez choisir le protocole nécessaire dans les paramètres de configuration :

238

239

(% class="ID0 annotation annotation-highlight" %)//Source : //(%%)//[[(% class="ID0 annotation annotation-highlight" %)www.attachmate.com>>path:/xwiki/bin/create/www/attachmate/com/WebHome?parent=Digdash.deployment.Document_managers.ftps.WebHome]]//

240

241

242

* (% class="ID0 annotation annotation-highlight" %)//Mode FTP explicite sur TLS//

243

244

(% class="ID0 annotation annotation-highlight" %)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).

245

246

* (% class="ID0 annotation annotation-highlight" %)//Mode FTP implicite sur TLS//

247

248

(% class="ID0 annotation annotation-highlight" %)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.

249

250

(% class="ID0 annotation annotation-highlight" %)Par défaut, le client FTP utilise le port PI = 990 pour les connexions implicites.

251

252

253

= Actions possibles[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=13||class="edit_section" role="button" title="Modifier"]](%%) =

254

255

Via la version web du gestionnaire des serveurs de documents, vous avez la possibilité d’agir sur les fichiers sur le serveur FTP(S).

256

257

== Téléchargement[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=14||class="edit_section" role="button" title="Modifier"]](%%) ==

258

259

(% style="text-align:center" %)

260

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_b43bc0697c466c3b.png?width=403&height=318&rev=1.1||alt="ftp(s)_fr_html_b43bc0697c466c3b.png" height="318" width="403"]]

261

262

(% style="text-align: center;" %)

263

//__Capture : Icône de téléchargement__//

264

265

C’est une action de base. Chaque utilisateur connecté Digdash est autorisé au minimum au droit de lecture.

266

267

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"]] .

268

269

== Dépôt de documents[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=15||class="edit_section" role="button" title="Modifier"]](%%) ==

270

271

(% style="text-align:center" %)

272

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_40606bee02db7003.png?width=729&height=332&rev=1.1||alt="ftp(s)_fr_html_40606bee02db7003.png" height="332" width="729"]]

273

274

(% style="text-align: center;" %)

275

//__Capture : Dépôt de document dans le serveur de documents Google Drive__//

276

277

278

(% class="box infomessage" %)

279

(((

280

**NB** : Dans Digdash, il est vivement conseillé de déposer des documents avec une extension explicite.

281

)))

282

283

Trois options sont disponibles :

284

285

* **Choisissez un fichier local **: cliquez sur **Parcourir... **pour sélectionner le fichier à ajouter. Cliquez sur **OK**.** **La boîte **Ouvrir **s'affiche

286

* **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...).

287

* **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 ».

288

289

== Édition de documents[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=16||class="edit_section" role="button" title="Modifier"]](%%) ==

290

291

(% style="text-align:center" %)

292

[[image:/xwiki/bin/download/Digdash/deployment/Document_managers/ftps/WebHome/ftp%28s%29_fr_html_3e7a483fbac41cfa.png?width=620&height=279&rev=1.1||alt="ftp(s)_fr_html_3e7a483fbac41cfa.png" height="279" width="620"]]

293

294

(% style="text-align: center;" %)

295

//__Capture : Mise à jour de documents (renommage et mise à jour de contenu)__//

296

297

298

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"]] .

299

300

Il peut s’agir des actions suivantes.

301

302

=== Mise à jour du contenu ===

303

304

Vous avez la possibilité de mettre à jour le contenu d’un document existant en choisissant un fichier depuis votre système.

305

306

[[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.

=== Renommage ===

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.

311

312

== Suppression[[(% class="sr-only" %)Modifier>>path:/xwiki/bin/edit/Digdash/deployment/Document_managers/ftps/WebHome?section=17||class="edit_section" role="button" title="Modifier"]](%%) ==

313

314

Vous avez la possibilité de supprimer un (ou des) document(s) existant(s) dans le Google Drive du compte de service.

315

316

Si l’utilisateur souhaite supprimer plusieurs documents, il pourra les sélectionner grâce aux checkbox.

317

318

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"]] .

Code source wiki de Serveur de documents FTP(S)