LWP::Protocol::https(3User Contributed Perl DocumentaLWP::Protocol::https(3pm)
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, Crypt::SSLeay, Mozilla::CA
COPYRIGHT & LICENSE
Copyright (c) 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.32.0 2020-12-21 LWP::Protocol::https(3pm)
Generated by dwww version 1.15 on Thu Jun 20 14:26:23 CEST 2024.