Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Net::Proxy::Connector:UsernContributed PeNet::Proxy::Connector::connect_ssl(3)

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_ssl 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.

METHODS
       The Net::Proxy::Connector::connect_ssl connector	has an extra method,
       obtained	from Net::Proxy::Connector::ssl:

   upgrade_SSL
	   $connector->upgrade_SSL( $sock )

       This method will	upgrade	a cleartext socket to SSL.  If the socket is
       already in SSL, it will "carp()".

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
       Copyright 2007-2014 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.24.1			  2014-11Net::Proxy::Connector::connect_ssl(3)

NAME | SYNOPSIS | DESCRIPTION | CONNECTOR OPTIONS | "out" | METHODS | AUTHOR | HISTORY | COPYRIGHT | LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Net::Proxy::Connector::connect_ssl&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help