---
name: "LWP::Protocol::https"
section: "3pm"
platform: "linux"
package: "perl-lwp-protocol-https"
version: "6.17-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/LWP::Protocol::https"
---

# LWP::Protocol::https(3pm)

Provide https support for LWP::UserAgent

## 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.