Net::Proxy::Connector::connect_ssl.3pm

Langue: en

Autres versions - même langue

Version: 2009-11-06 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

Net::Proxy::Connector::connect_ssl - Create SSL/CONNECT tunnels through HTTP proxies

SYNOPSIS

     # sample proxy using Net::Proxy::Connector::tcp
     #                and Net::Proxy::Connector::connect_ssl
     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_ssl',
             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_ssl" is a "Net::Proxy::Connector" that uses the HTTP CONNECT method to ask the proxy to create a tunnel to an outside server. The data is then encrypted using SSL.

Obviously, you'll need a server that understands SSL (or a proxy using "Net::Proxy::Connector::ssl") at the other end.

This connector is only an ``out'' connector.

In addition to the options listed below, this connector accepts all "SSL_..." options to "IO::Socket::SSL". They are transparently passed through to the appropriate "IO::Socket::SSL" methods when upgrading the socket to SSL.

CONNECTOR OPTIONS

"Net::Proxy::Connector::connect" accepts the following options:

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.

AUTHOR

Philippe 'BooK' Bruhat, "<book@cpan.org>".

HISTORY

Because "Net::Proxy" blocks when it tries to connect to itself, it wasn't possible to pass an SSL-encrypted connection through a proxy with a single script: you needed one for the SSL encapsulation, and another one for bypassing the proxy with the "CONNECT" HTTP method.

See "Net::Proxy::Connector::connect" and "Net::Proxy::Connector::ssl" for details.

Copyright 2007 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.