|
|
connect proxy tunnel 1.3 (Default branch)
01-30-2009
|
|
Net::Proxy::Connector::connect(3pm) User Contributed Perl Documentation Net::Proxy::Connector::connect(3pm) NAME
Net::Proxy::Connector::connect - Create CONNECT tunnels through HTTP proxies SYNOPSIS
# sample proxy using Net::Proxy::Connector::tcp # and Net::Proxy::Connector::connect use Net::Proxy; # listen on localhost:6789 # and proxy to remotehost:9876 through proxy.company.com:8080 # using the given credentials my $proxy = Net::Proxy->new( in => { type => 'tcp', port => '6789' }, out => { type => 'connect', host => 'remotehost', port => '9876', proxy_host => 'proxy.company.com', proxy_port => '8080', proxy_user => 'jrandom', proxy_pass => 's3kr3t', proxy_agent => 'Mozilla/4.04 (X11; I; SunOS 5.4 sun4m)', }, ); $proxy->register(); Net::Proxy->mainloop(); DESCRIPTION
"Net::Proxy::Connecter::connect" is a "Net::Proxy::Connector" that uses the HTTP CONNECT method to ask the proxy to create a tunnel to an outside server. Be aware that some proxies are set up to deny the creation of some outside tunnels (either to ports other than 443 or outside a specified set of outside hosts). This connector is only an "out" connector. CONNECTOR OPTIONS
"Net::Proxy::Connector::connect" accepts the following options: "out" o host The destination host. o port The destination port. o proxy_host The web proxy name or address. o proxy_port The web proxy port. o proxy_user The authentication username for the proxy. o proxy_pass The authentication password for the proxy. o proxy_agent The user-agent string to use when connecting to the proxy. AUTHOR
Philippe 'BooK' Bruhat, "<book@cpan.org>". BUGS
All the authentication schemes supported by "LWP::UserAgent" should be supported (we use an "LWP::UserAgent" internally to contact the proxy). This means we should also support NTLM, since it is supported as from "libwww-perl" 5.66. "Net::Proxy::Connector::connect" has not been actually tested with NTLM, though. Any report of success or failure with a NTLM proxy will be appreciated. HISTORY
This module is based on my script "connect-tunnel", that provided a command-line interface to create tunnels though HTTP proxies. It was first published on CPAN on March 2003. A better version of "connect-tunnel" (using "Net::Proxy") is provided this distribution. COPYRIGHT
Copyright 2006 Philippe 'BooK' Bruhat, All Rights Reserved. LICENSE
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. perl v5.10.1 2009-10-18 Net::Proxy::Connector::connect(3pm)