LWP::Protocol::https(3)
NAME
LWP::Protocol::https - Provide https support for LWP::UserAgent
SYNOPSIS
use LWP::UserAgent;
$ua = LWP::UserAgent->new(ssl_opts => { verify_hostname => 1 });
$res = $ua->get("https://www.example.com");
# specify a CA path
$ua = LWP::UserAgent->new(
ssl_opts => {
SSL_ca_path => '/etc/ssl/certs',
verify_hostname => 1,
}
);
DESCRIPTION
The LWP::Protocol::https module provides support for using https
schemed URLs with LWP. This module is a plug-in to the LWP protocol
handling, so you don't use it directly. Once the module is installed
LWP is able to access sites using HTTP over SSL/TLS.
If hostname verification is requested by LWP::UserAgent's "ssl_opts",
and neither "SSL_ca_file" nor "SSL_ca_path" is set, then "SSL_ca_file"
is implied to be the one provided by Mozilla::CA. If the Mozilla::CA
module isn't available SSL requests will fail. Either install this
module, set up an alternative "SSL_ca_file" or disable hostname
verification.
This module used to be bundled with the libwww-perl, but it was
unbundled in v6.02 in order to be able to declare its dependencies
properly for the CPAN tool-chain. Applications that need https support
can just declare their dependency on LWP::Protocol::https and will no
longer need to know what underlying modules to install.
SEE ALSO
IO::Socket::SSL(3), Crypt::SSLeay(3), Mozilla::CA(3)
COPYRIGHT
Copyright 1997-2011 Gisle Aas.
This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
perl v5.24.1 2017-02-20 LWP::Protocol::https(3)
lwp-protocol-https 6.70.0 - Generated Sat Feb 25 06:12:08 CST 2017