NAME IO::Stream::Proxy::HTTPS - HTTPS proxy plugin for IO::Stream VERSION This document describes IO::Stream::Proxy::HTTPS version v2.0.1 SYNOPSIS use IO::Stream; use IO::Stream::Proxy::HTTPS; IO::Stream->new({ ... plugin => [ ... proxy => IO::Stream::Proxy::HTTPS->new({ host => 'my.proxy.com', port => 3128, user => 'me', pass => 'mypass', }), ... ], }); DESCRIPTION This module is plugin for IO::Stream which allow you to route stream through HTTPS (also called CONNECT) proxy. You may use several IO::Stream::Proxy::HTTPS plugins for single IO::Stream object, effectively creating proxy chain (first proxy plugin will define last proxy in a chain). EVENTS When using this plugin event RESOLVED will never be delivered to user because target {host} which user provide to IO::Stream will never be resolved on user side (it will be resolved by HTTPS proxy). Event CONNECTED will be generated after HTTPS proxy successfully connects to target {host} (and not when socket will connect to HTTPS proxy itself). INTERFACE new $plugin = IO::Stream::Proxy::HTTPS->new({ host=>$host, port=>$port, }); $plugin = IO::Stream::Proxy::HTTPS->new({ host=>$host, port=>$port, user=>$user, pass=>$pass, }); Connect to proxy $host:$port, optionally using basic authorization. DIAGNOSTICS {host}+{port} required You must provide both {host} and {port} to IO::Stream::Proxy::HTTPS->new(). {user}+{pass} required You have provided either {user} or {pass} to IO::Stream::Proxy::HTTPS->new() while you have to provide either both or none of them. {fh} already connected You have provided {fh} to IO::Stream->new(), but this is not supported by this plugin. Either don't use this plugin or provide {host}+{port} to IO::Stream->new() instead. SUPPORT Bugs / Feature Requests Please report any bugs or feature requests through the issue tracker at https://github.com/powerman/perl-IO-Stream-Proxy-HTTPS/issues. You will be notified automatically of any progress on your issue. Source Code This is open source software. The code repository is available for public review and contribution under the terms of the license. Feel free to fork the repository and submit pull requests. https://github.com/powerman/perl-IO-Stream-Proxy-HTTPS git clone https://github.com/powerman/perl-IO-Stream-Proxy-HTTPS.git Resources * MetaCPAN Search https://metacpan.org/search?q=IO-Stream-Proxy-HTTPS * CPAN Ratings http://cpanratings.perl.org/dist/IO-Stream-Proxy-HTTPS * AnnoCPAN: Annotated CPAN documentation http://annocpan.org/dist/IO-Stream-Proxy-HTTPS * CPAN Testers Matrix http://matrix.cpantesters.org/?dist=IO-Stream-Proxy-HTTPS * CPANTS: A CPAN Testing Service (Kwalitee) http://cpants.cpanauthors.org/dist/IO-Stream-Proxy-HTTPS AUTHOR Alex Efros COPYRIGHT AND LICENSE This software is Copyright (c) 2008- by Alex Efros . This is free software, licensed under: The MIT (X11) License