Scripts de connexion aux serveurs mandataires FTP

Le script de connexion définit comment le client FTP doit communiquer avec le serveur mandataire FTP pour atteindre le serveur FTP voulu. Le mandataire se comporte comme un serveur FTP. Le client s’y connecte et envoie les paramètres nécessaires : nom d’utilisateur et mot de passe du mandataire (facultatifs), adresse et port du serveur FTP voulu, et nom d’utilisateur et mot de passe de ce serveur. Le mandataire se connecte alors au serveur FTP et transmet toutes les commandes et réponses entre lui et le client.

Description du script de connexion

La première ligne du script est toujours « Connect to: », suivie d’une adresse de serveur et d’un port séparés par « : ». Ils définissent la destination de connexion du client FTP. L’adresse est obligatoire. Si le port n’est pas défini, la valeur 21 est utilisée.

Toutes les autres lignes contiennent les commandes envoyées au serveur, une seule par ligne. Elles peuvent contenir des variables développées avant l’envoi.

Il existe des variables facultatives et obligatoires. La différence apparaît lorsqu’une variable utilisée dans une commande n’est pas définie par l’utilisateur. Pour une variable facultative, la ligne entière est ignorée. Pour une variable obligatoire, une boîte demande une valeur à l’utilisateur, qui peut aussi annuler la connexion. Les variables commencent par « $ » et sont entourées de parenthèses, par exemple « $(Password) ». La séquence d’échappement du caractère « $ » est « $$ ».

Les lignes commençant par « 3xx: » sont ignorées si la commande précédente a été ignorée ou si sa réponse n’était pas 3xx. Une réponse 3xx commence par « 3 » et signifie « succès partiel ». Dans une séquence de commandes, elle indique de poursuivre avec la commande suivante : par exemple, le nom d’utilisateur est accepté, il faut donc envoyer le mot de passe.

Restrictions de la première ligne : l’adresse du serveur doit être du texte sans variable ou contenant uniquement ProxyHost ou Host ; le port doit être un nombre décimal ou la variable ProxyPort ou Port.

La connexion est considérée comme réussie si aucune réponse aux commandes envoyées n’est 4xx ou 5xx (erreur temporaire ou permanente respectivement) et si la réponse à la dernière commande est 2xx, indiquant un succès.

Variables

Les variables suivantes sont disponibles :

Variable	Description
ProxyHost	obligatoire ; nom ou adresse IP du serveur mandataire (pare-feu)
ProxyPort	toujours défini ; numéro du port d’écoute du serveur mandataire (pare-feu) ; par défaut 21 si l’utilisateur ne le précise pas
ProxyUser	facultatif ; nom d’utilisateur du serveur mandataire (pare-feu)
ProxyPassword	obligatoire ; mot de passe du serveur mandataire (pare-feu)
Host	toujours défini ; nom ou adresse IP du serveur FTP voulu
Port	toujours défini ; numéro du port d’écoute du serveur FTP voulu ; par défaut 21 si l’utilisateur ne le précise pas
User	obligatoire ; nom d’utilisateur du serveur FTP voulu
Password	obligatoire ; mot de passe du serveur FTP voulu
Account	obligatoire ; compte du serveur FTP voulu

Exemples

Script de connexion directe, sans serveur mandataire :

Connect to: $(Host):$(Port)
USER $(User)
3xx: PASS $(Password)
3xx: ACCT $(Account)

Script pour le type de serveur mandataire FTP « USER user@host:port » :

Connect to: $(ProxyHost):$(ProxyPort)
USER $(ProxyUser)
3xx: PASS $(ProxyPassword)
USER $(User)@$(Host):$(Port)
3xx: PASS $(Password)
3xx: ACCT $(Account)

Voir aussi

Boîte Ajouter/modifier un serveur mandataire