Net::Proxy::Connector::connect - Create CONNECT tunnels through HTTP proxies
# 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();
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.
Net::Proxy::Connecter::connect
Net::Proxy::Connector
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.
Net::Proxy::Connector::connect accepts the following options:
Net::Proxy::Connector::connect
out
host
The destination host.
port
The destination port.
proxy_host
The web proxy name or address.
proxy_port
The web proxy port.
proxy_user
The authentication username for the proxy.
proxy_pass
The authentication password for the proxy.
proxy_agent
The user-agent string to use when connecting to the proxy.
Philippe 'BooK' Bruhat, <book@cpan.org>.
<book@cpan.org>
All the authentication schemes supported by LWP::UserAgent should be supported (we use an LWP::UserAgent internally to contact the proxy).
LWP::UserAgent
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.
libwww-perl
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.
connect-tunnel
A better version of connect-tunnel (using Net::Proxy) is provided this distribution.
Net::Proxy
Copyright 2006 Philippe 'BooK' Bruhat, All Rights Reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Net::Proxy, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Net::Proxy
CPAN shell
perl -MCPAN -e shell install Net::Proxy
For more information on module installation, please visit the detailed CPAN module installation guide.