Code source wiki de FTP(S)

Modifié par Aurelie Bertrand le 2025/03/13 08:56

version	line-number	content
3.1	1	{{ddtoc/}}
1.1	2
2.1	3	----
	4
4.1	5	= Prérequis =
1.1	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
31.2	18	= Création d’un nouveau serveur de fichiers FTP(S) =
1.1	19
34.1	20	Vous pouvez créer un nouveau serveur de fichiers FTP(S) depuis le menu de la page d'accueil ou depuis le Studio.
1.1	21
21.1	22	== Depuis le menu d'accueil ==
1.1	23
55.1	24	1. Depuis la page d'accueil, allez dans Configuration puis Gestion des documents.
21.1	25	➡ La page Gestion des documents s'affiche.
	26	1. Sélectionnez Serveurs dans le menu de gauche.
	27	➡ La liste des serveurs disponibles s'affiche.
60.1	28	[[image:Server_page_FR.png]]
21.1	29	1. Cliquez sur le bouton Nouveau serveur en bas à droite.
	30	➡ La page Ajouter un serveur s'affiche.
	31	1. Sélectionnez le Type de serveur : //FTP //ou //FTPS,// puis renseignez les autres champs comme décrit dans le paragraphe Configuration du serveur ci-dessous.
60.1	32	[[image:Add_server_FTP_FR.png\|\|alt="Ajouter serveur"]]
1.1	33
27.1	34	== Depuis le Studio ==
1.1	35
68.1	36	1. Dans le Studio, cliquez sur le bouton Gestionnaires dans la barre latérale de gauche, puis sélectionnez Serveurs.
69.1	37	➡ La boite de dialogue Gestionnaire de serveurs de fichiers s'affiche.
27.1	38	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.
63.1	39	[[image:Add_server_FTP_Studio_FR.png]]
27.1	40	➡ La boite Ajouter un serveur s'affiche.
64.1	41	[[image:Add_server_FTP_Studio2_FR.png\|\|height="610" width="530"]]
27.1	42	1. Renseignez les champs comme décrit dans le paragraphe Configuration du serveur ci-dessous.
1.1	43
27.2	44	= (% style="color:inherit; font-family:inherit; font-size:29px" %)Configuration serveur(%%) =
1.1	45
5.1	46	== Nom du serveur ==
1.1	47
	48	Donnez un nom à votre nouveau serveur de documents FTP(S).
	49
4.1	50	== URL ==
1.1	51
	52	Indiquez dans ce champ l’adresse IP de votre serveur FTP(S).
	53
4.1	54	== Chemin des documents de l’utilisateur ==
1.1	55
	56	C’est à partir de ce chemin sur le serveur FTP(S) que Digdash va explorer les fichiers. Si vide, Digdash explorera depuis la racine.
	57
4.1	58	== Exploration des sous-dossiers ==
1.1	59
	60	Vous avez la possibilité de limiter le niveau d’exploration à partir de votre chemin de documents.
	61
	62	Par défaut, la recherche de documents s’effectue de manière récursive et va explorer tous les sous-dossiers.
	63
	64	\|Champs\|//Explorer les sous-dossiers//\|(% colspan="2" %)//Niveau des sous-dossiers//
	65	\|(% rowspan="2" %)Valeurs\|Activé\|(((
	66	Vide
	67
	68	Valeur par défaut, l’exploration s’opère récursivement dans tous les sous-dossiers
	69	)))\|(((
	70	N > 0
	71
	72	L’exploration s’effectuera dans les N sous-dossier
	73	)))
	74	\|Désactivé\|(% colspan="2" %)(((
	75	0
	76
	77	Pas d’exploration dans les sous-dossiers, seulement dans le répertoire courant
	78	)))
	79
4.1	80	== Lecture seule ==
1.1	81
	82	Seule la lecture est possible si cette option est activée.
	83
4.1	84	== Nom ==
1.1	85
	86	Indiquez dans ce champ le nom de votre utilisateur.
	87
4.1	88	== Mot de passe ==
1.1	89
	90	Indiquez dans ce champ le mot de passe de votre utilisateur.
	91
13.1	92	= Mode actif / mode passif{{id name="Mode_FTP"/}} =
1.1	93
	94	La notion de mode actif et passif est extrêmement importante pour l'utilisation de FTP avec des pare-feux (firewall) :
	95
	96	//Source : [[www.slacksite.com>>path:/xwiki/bin/create/www/slacksite/com/WebHome?parent=Digdash.deployment.Document_managers.ftps.WebHome]]
	97	Source : [[https:~~/~~/wiki.filezilla-project.org/Network_Configuration>>url:https://wiki.filezilla-project.org/Network_Configuration]]//
	98
27.2	99	=== Mode actif ===
1.1	100
	101	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 :
	102
	103	* le port P (21) depuis n’importe où (le Client initie la connexion)
	104	* le port P (21) ouvert aux ports > 1023 (le Serveur répond au port de commande/contrôle du Client)
	105	* 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)
	106	* le port P-1 (20) depuis les ports > 1023 (le Client envoie une notification au port de données du Serveur)
	107
65.1	108	Options du mode acti
1.1	109
	110	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.
	111
	112	Si vous disposez d’un routeur NAT, vous aurez besoin d’indiquer en option votre adresse IP externe.
	113
	114	Vous avez également la possibilité de limiter le nombre de ports de communication en mode actif.
	115
29.1	116	=== Mode passif (recommandé) ===
1.1	117
	118	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 :
	119
	120	* le port P (21) depuis n’importe où (le Client initie la connexion)
	121	* le port P (21) ouvert aux ports > 1023 (le Serveur répond au port de commande/contrôle du Client)
	122	* 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)
	123	* les ports > 1023 ouverts aux ports > 1023 (le Serveur envoie une notification (et les données) vers le port de données du Client)
	124
	125	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.
	126
	127	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 :
	128
56.1	129	[[image:ftp(s)_fr_html_d3a33387067e1ebb.png\|\|queryString="width=554&height=386" data-xwiki-image-style-alignment="center" height="386" width="554"]]
1.1	130
13.1	131	= Mode FTP sur TLS{{id name="TLS"/}} =
1.1	132
11.1	133	Pour travailler avec un serveur FTP sécurisé (FTPS) vous devez choisir le protocole nécessaire dans les paramètres de configuration :
1.1	134
11.1	135	Source : [[www.attachmate.com>>path:/xwiki/bin/create/www/attachmate/com/WebHome?parent=Digdash.deployment.Document_managers.ftps.WebHome]]
1.1	136
29.1	137	* 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).
	138
	139	* 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.
1.1	140
11.1	141	Par défaut, le client FTP utilise le port PI = 990 pour les connexions implicites.
1.1	142
46.1	143	= Actions possibles{{id name="Actions"/}} =
1.1	144
67.1	145	Via la page Configuration -> Gestion des documents -> Documents, vous avez la possibilité d’agir sur les fichiers sur le serveur FTP(S).
66.1	146	Consultez la page[[ Gérer les documents et serveurs>>doc:Digdash.deployment.configuration.administration.Document_management.WebHome]] pour plus de détails.
1.1	147
42.1	148

Code source wiki de FTP(S)

Sommaire