Net::SSLeay 1.36

There is a related module called Net::SSLeay::Handle included in this distribution that you might want to use instead. It has its own pod documentation.<br /><br />Net::SSLeay is a Perl module that offers some high level convenience functions for accessing web pages on SSL servers (for symmetry, the same API is offered for accessing http servers, too), an sslcat() function for writing your own clients, and finally access to the SSL api of the SSLeay/OpenSSL package so you can write servers or clients for more complicated applications.<br /><br />For high level functions it is most convenient to import them into your main namespace as indicated in the synopsis.<br /><br />Case 1 demonstrates the typical invocation of get_https() to fetch an HTML page from secure server. The first argument provides the hostname or IP in dotted decimal notation of the remote server to contact. The second argument is the TCP port at the remote end (your own port is picked arbitrarily from high numbered ports as usual for TCP). The third argument is the URL of the page without the host name part. If in doubt consult the HTTP specifications at http://www.w3c.org.<br /><br />Case 2 demonstrates full fledged use of get_https(). As can be seen, get_https() parses the response and response headers and returns them as a list, which can be captured in a hash for later reference. Also a fourth argument to get_https() is used to insert some additional headers in the request. make_headers() is a function that will convert a list or hash to such headers. By default get_https() supplies Host (to make virtual hosting easy) and Accept (reportedly needed by IIS) headers.<br /><br />Case 2b demonstrates how to get a password protected page. Refer to the HTTP protocol specifications for further details (e.g. RFC-2617).<br /><br />Case 3 invokes post_https() to submit a HTML/CGI form to a secure server. The first four arguments are equal to get_https() (note that the empty string ('') is passed as header argument). The fifth argument is the contents of the form formatted according to CGI specification. In this case the helper function make_https() is used to do the formatting, but you could pass any string. post_https() automatically adds Content-Type and Content-Length headers to the request.<br /><br />Case 4 shows the fundamental sslcat() function (inspired in spirit by the netcat utility :-). It's your swiss army knife that allows you to easily contact servers, send some data, and then get the response. You are responsible for formatting the data and parsing the response - sslcat() is just a transport.<br /><br />Case 5 is a full invocation of sslcat() which allows the return of errors as well as the server (peer) certificate.<br /><br />The $trace global variable can be used to control the verbosity of the high level functions. Level 0 guarantees silence, level 1 (the default) only emits error messages.<br /><br />SYNOPSIS<br /><br /> use Net::SSLeay qw(get_https post_https sslcat make_headers make_form);<br /><br /> ($page) = get_https('www.bacus.pt', 443, '/'); # 1<br /><br /> ($page, $response, %reply_headers)<br /> = get_https('www.bacus.pt', 443, '/', # 2<br /> make_headers(User-Agent => 'Cryptozilla/5.0b1',<br /> Referer => 'https://www.bacus.pt'<br /> ));<br /><br /> ($page, $result, %headers) = # 2b<br /> = get_https('www.bacus.pt', 443, '/protected.html',<br /> make_headers(Authorization =><br /> 'Basic ' . MIME::Base64::encode("$user:$pass",''))<br /> );<br /><br /> ($page, $response, %reply_headers)<br /> = post_https('www.bacus.pt', 443, '/foo.cgi', '', # 3<br /> make_form(OK => '1',<br /> name => 'Sampo'<br /> ));<br /><br /> $reply = sslcat($host, $port, $request); # 4<br /><br /> ($reply, $err, $server_cert) = sslcat($host, $port, $request); # 5<br /><br /> $Net::SSLeay::trace = 2; # 0=no debugging, 1=ciphers, 2=trace, 3=dump data

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Argument,  Demonstrates,  Formatting,  Function,  Functions,  Headers,  Https,  Https Wwwbacuspt,  Invocation,  Level,  Net,  Net Ssleay,  Post Https,  Request,  Response,  Secure,  Server,  Servers,  Specifications,  Sslcat,  Ssleay,  String
Users rating:	0/10