Aanmeldscripts voor FTP-proxyservers

Het aanmeldscript bepaalt hoe de FTP-client met de FTP-proxyserver communiceert om verbinding te maken met de gewenste FTP-server. De proxy gedraagt zich als FTP-server. De client maakt verbinding en stuurt alle benodigde parameters: optioneel gebruikersnaam en wachtwoord voor de proxy, adres en poort van de gewenste FTP-server, en gebruikersnaam en wachtwoord voor die server. De proxy maakt verbinding met de FTP-server en stuurt alle opdrachten en antwoorden tussen client en server door.

Beschrijving van een aanmeldscript

De eerste regel van een aanmeldscript is altijd "Connect to:", gevolgd door het serveradres en de poort, gescheiden door een dubbele punt (:). Deze bepalen waarmee de FTP-client verbinding maakt. Het serveradres is verplicht. Als geen poort wordt opgegeven, wordt 21 gebruikt.

Alle overige regels bevatten opdrachten die naar de server worden gestuurd, één opdracht per regel. Regels kunnen variabelen bevatten die vóór het versturen van de opdracht worden ingevuld.

Er zijn twee soorten variabelen: optioneel en verplicht. Het verschil blijkt wanneer een opdracht een variabele gebruikt waarvoor de gebruiker geen waarde heeft opgegeven. Bij een ontbrekende optionele variabele wordt de hele opdrachtregel overgeslagen. Bij een ontbrekende verplichte variabele verschijnt een dialoogvenster waarin de gebruiker de waarde moet opgeven of de verbinding kan annuleren. Variabelen beginnen met $ en staan tussen haakjes, bijvoorbeeld "$(Password)". De escape-reeks voor een letterlijk dollarteken is "$$".

Regels die met "3xx:" beginnen, worden overgeslagen als de vorige opdracht is overgeslagen of als het antwoord daarop geen 3xx was. Bij een 3xx-antwoord is het eerste cijfer van het FTP-antwoord 3, wat gedeeltelijk succes betekent. In een opdrachtenreeks betekent dit: ga verder met de volgende opdracht, bijvoorbeeld het wachtwoord versturen nadat de gebruikersnaam is geaccepteerd.

Voor de eerste regel gelden beperkingen: het serveradres mag alleen tekst zonder variabelen zijn of tekst met uitsluitend de variabele ProxyHost of Host. De poort mag alleen een decimaal getal of de variabele ProxyPort of Port zijn.

Het aanmelden is geslaagd en de gebruiker is met de FTP-server verbonden als geen antwoord op de verstuurde opdrachten 4xx of 5xx is en het antwoord op de laatste opdracht 2xx is. 4xx betekent een tijdelijke fout, 5xx een permanente fout en 2xx succes.

Variabelen

De volgende variabelen zijn beschikbaar:

Variabele	Beschrijving
ProxyHost	Verplicht; naam of IP-adres van de proxyserver (firewall)
ProxyPort	Altijd ingevuld; poort waarop de proxyserver (firewall) luistert. Standaard is dit 21 als de gebruiker geen poort opgeeft.
ProxyUser	Optioneel; gebruikersnaam voor de proxyserver (firewall)
ProxyPassword	Verplicht; wachtwoord voor de proxyserver (firewall)
Host	Altijd ingevuld; naam of IP-adres van de gewenste FTP-server
Port	Altijd ingevuld; poort waarop de gewenste FTP-server luistert. Standaard is dit 21 als de gebruiker geen poort opgeeft.
User	Verplicht; gebruikersnaam voor de gewenste FTP-server
Password	Verplicht; wachtwoord voor de gewenste FTP-server
Account	Verplicht; account voor de gewenste FTP-server

Voorbeelden

Aanmeldscript voor een rechtstreekse verbinding zonder proxyserver:

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

Aanmeldscript voor het FTP-proxyservertype "USER user@host:port":

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

Zie ook

Dialoogvenster Proxyserver toevoegen/bewerken