Provide https support for LWP::UserAgent
Perl
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib/LWP/Protocol
t
.gitignore
.mailmap
.travis.yml Getting the coverage tests from @moose Jun 4, 2017
CONTRIBUTING.md
Changes
Install
LICENSE
META.json
Makefile.PL
README.md Convert to dzil. Feb 21, 2017
cpanfile
dist.ini
perlcriticrc
perltidyrc Convert to dzil. Feb 21, 2017
tidyall.ini

README.md

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.