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


LWP-Protocol-https documentation  | view source Contained in the LWP-Protocol-https distribution.

Index


NAME

Top

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

SYNOPSIS

Top

  use LWP::UserAgent;

  $ua = LWP::UserAgent->new(ssl_opts => { verify_hostname => 1 });
  $res = $ua->get("https://www.example.com");

DESCRIPTION

Top

The LWP::Protocol::https module provide 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

Top

IO::Socket::SSL, Crypt::SSLeay, Mozilla::CA

COPYRIGHT

Top


LWP-Protocol-https documentation  | view source Contained in the LWP-Protocol-https distribution.