Merge commit 'origin/master'
[libwww-perl-eserte.git] / README.SSL
blob66a7b65b3270b4f4f2ba590d16729e64328a71db
1 SSL SUPPORT
2 -----------
4 The libwww-perl package has support for using SSL/TLSv1 with its HTTP
5 client and server classes. This support makes it possible to access
6 https schemed URLs with LWP. Because of the problematic status of
7 encryption software in general and certain encryption algorithms in
8 particular, in several countries, libwww-perl package doesn't include
9 SSL functionality out-of-the-box.
11 Encryption support is obtained through the use of Crypt::SSLeay or
12 IO::Socket::SSL, which can both be found from CPAN. While libwww-perl
13 has "plug-and-play" support for both of these modules (as of v5.45),
14 the recommended module to use is Crypt::SSLeay. In addition to
15 bringing SSL support to the LWP package, IO::Socket::SSL can be used
16 as an object oriented interface to SSL encrypted network sockets.
18 There is yet another SSL interface for perl called Net::SSLeay. It has
19 a more complete SSL interface and can be used for web client
20 programming among other things but doesn't directly support LWP.
22 The underlying SSL support in all of these modules is based on OpenSSL
23 <http://www.openssl.org/> (formerly SSLeay). For WWW-server side SSL
24 support (e.g. CGI/FCGI scripts) in Apache see <http://www.modssl.org/>.