info > LWP::Protocol::https

man perldoc info pydoc3 ri search

Not found locally for LWP::Protocol::https. Try Google search

📛 NAME

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

🚀 Quick Reference

Use Case	Command	Description
🌐 Basic HTTPS Request	$ua = LWP::UserAgent->new; $ua->get('https://example.com');	Perform a simple HTTPS GET using default settings
🔒 Enable Hostname Verification	ssl_opts => { verify_hostname => 1 }	Forces SSL certificate hostname validation
🗂️ Specify CA Path	SSL_ca_path => '/etc/ssl/certs', verify_hostname => 1	Use a custom directory of CA certificates
📄 Specify CA File	SSL_ca_file => '/path/to/cacert.pem', verify_hostname => 1	Use a specific CA bundle file
📦 Dependencies	cpan IO::Socket::SSL Mozilla::CA	Required for HTTPS; Mozilla::CA provides default CA certificates

📝 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)

📛 NAME 🚀 Quick Reference 📝 SYNOPSIS 📖 DESCRIPTION 🔗 SEE ALSO 📜 COPYRIGHT & LICENSE