4D Doc Center : IT

4D Internet Commands v14

IT_SetProxy


IT_SetProxy ( protocole ; typeProxy ; nomServeurProxy ; portProxy ; idUtilisateurProxy ) -> Résultat

Paramètre	Type	Description
protocole	Entier	1 = FTP ; 2 = SMTP ; 3 = POP3 ; 4 = IMAP
typeProxy	Entier	0 = Aucun ; 1 = SOCKS
nomServeurProxy	Chaîne	Nom ou adresse IP du serveur proxy SOCKS
portProxy	Entier	Port du proxy auquel se connecter
idUtilisateurProxy	Texte	ID d'utilisateur pour SOCKS
Résultat	Entier	Code d'erreur

Description

La commande IT_SetProxy permet d'ouvrir une connexion au moyen du protocole spécifié, puis d'envoyer toutes les requêtes proposées au protocole spécifié via le serveur SOCKS (Proxy SOCKS). Si vous vous connectez uniquement en Intranet, vous n'aurez généralement pas à passer par le serveur SOCKS, sauf si le paramétrage du firewall ("pare feu") de votre réseau le requiert. La commande IT_SetProxy a une portée interprocess et s'applique à toutes les sessions de communication utilisant le protocole spécifié, quel que soit le process 4D.

Note : Socks (ou "SOCKS") est un protocole utilisable par un serveur proxy. Il permet de filtrer les requêtes des utilisateurs du réseau d'une entreprise, lorsque celles-ci doivent être transmises sur Internet. Si votre poste de travail se trouve derrière un firewall et si vous souhaitez accéder à des informations sur Internet, le serveur SOCKS reçoit votre requête, la transmet à travers le firewall, puis récupère et renvoie les informations à votre application cliente.

Le paramètre protocole définit le protocole qui doit être filtré par le serveur proxy SOCKS spécifié. Passez 1 pour désigner le protocole FTP, 2 pour le protocole SMTP, 3 pour le protocole POP3 et 4 pour le protocole IMAP.

Le paramètre typeProxy indique si le protocole spécifié doit ou non être filtré par un serveur proxy SOCKS. Passez 1 pour faire transiter toutes les requêtes du protocole spécifié par le serveur SOCKS spécifié, sinon passez 0.

Le paramètre nomServeurProxy contient le nom ou l'adresse IP du serveur proxy SOCKS.

Le paramètre portProxy contient le port à utiliser pour que le protocole spécifié communique avec le serveur proxy SOCKS.

Le paramètre idUtilisateurProxy identifie l'utilisateur. L'ID d'utilisateur est attribué par votre administrateur réseau. idUtilisateurProxy peut être un texte vide ("").

Exemple

La méthode suivante permet d'acheminer toutes les connexions FTP via le serveur proxy SOCKS spécifié.

 $err:=IT_SetProxy(1;1;$ajouterProxy;$PortProxy;"") `Proxy SOCKS FTP

 $err:=FTP_Login("ftp.4d.com";"anonymous";"dbody@aol.com";$ftpID)

 $err:=FTP_GetFileInfo($ftpID;$vchemin;$vtaille;$vdateModif)

 $err:=FTP_Receive($ftpID;$vchemin;"";0)

 $err:=FTP_Logout($ftpID)

Note : Par souci de clarté, cet exemple ne contient pas de vérification d'erreur.

L'instruction suivante permet de ne plus passer par le serveur proxy SOCKS lors des requêtes FTP.

$err:=IT_SetProxy(1;0;$ajouterProxy;$portProxy;"")