1LWP::Protocol::https(3)User Contributed Perl DocumentatioLnWP::Protocol::https(3)
2
3
4

NAME

6       LWP::Protocol::https - Provide https support for LWP::UserAgent
7

SYNOPSIS

9         use LWP::UserAgent;
10
11         $ua = LWP::UserAgent->new(ssl_opts => { verify_hostname => 1 });
12         $res = $ua->get("https://www.example.com");
13
14         # specify a CA path
15         $ua = LWP::UserAgent->new(
16             ssl_opts => {
17                 SSL_ca_path     => '/etc/ssl/certs',
18                 verify_hostname => 1,
19             }
20         );
21

DESCRIPTION

23       The LWP::Protocol::https module provides support for using https
24       schemed URLs with LWP.  This module is a plug-in to the LWP protocol
25       handling, so you don't use it directly.  Once the module is installed
26       LWP is able to access sites using HTTP over SSL/TLS.
27
28       If hostname verification is requested by LWP::UserAgent's "ssl_opts",
29       and neither "SSL_ca_file" nor "SSL_ca_path" is set, then "SSL_ca_file"
30       is implied to be the one provided by Mozilla::CA.  If the Mozilla::CA
31       module isn't available SSL requests will fail.  Either install this
32       module, set up an alternative "SSL_ca_file" or disable hostname
33       verification.
34
35       This module used to be bundled with the libwww-perl, but it was
36       unbundled in v6.02 in order to be able to declare its dependencies
37       properly for the CPAN tool-chain.  Applications that need https support
38       can just declare their dependency on LWP::Protocol::https and will no
39       longer need to know what underlying modules to install.
40

SEE ALSO

42       IO::Socket::SSL, Crypt::SSLeay, Mozilla::CA
43
45       Copyright (c) 1997-2011 Gisle Aas.
46
47       This library is free software; you can redistribute it and/or modify it
48       under the same terms as Perl itself.
49
50
51
52perl v5.34.0                      2021-07-22           LWP::Protocol::https(3)
Impressum