TLS support for Twiggy server
Perl
Latest commit d451889 Jun 24, 2013 @und3f und3f version 0.0019
Permalink
Failed to load latest commit information.
lib version 0.0019 Jun 24, 2013
t fixed outdated certificates Jun 24, 2013
.gitignore init Feb 25, 2012
Changes version 0.0019 Jun 24, 2013
MANIFEST.SKIP development release Mar 1, 2012
Makefile.PL New syntax for repo and tracker resources info May 22, 2012
README.pod documentation updated Mar 26, 2012

README.pod

NAME

Twiggy::TLS - Twiggy server with TLS support.

SYNOPSIS

twiggy --server Twiggy::TLS --tls-key key.pem --tls-cert cert.pem

See "ATTRIBUTES" for more details.

use Twiggy::Server::TLS;

my $server = Twiggy::Server::TLS->new(
    host     => $host,
    port     => $port,
    tls_key  => $key_filename,
    tls_cert => $cert_filename
);
$server->register_service($app);

AE::cv->recv;

DESCRIPTION

Twiggy::TLS extends Twiggy with a TLS support.

ATTRIBUTES

All files must be in PEM format. You can merge multiply entities in a one file (like server key and certificate).

tls_version

Sets the version of the SSL protocol used to transmit data. The default is sslv2/3. Other possible values are sslv2, sslv3 or tlsv1.

tls_ciphers

This directive describes the list of cipher suites the server supports for establishing a secure connection. Cipher suites are specified in the OpenSSL cipherlist format http://www.openssl.org/docs/apps/ciphers.html#CIPHER_STRINGS.

The default is HIGH:!aNULL:!MD5.

tls_key

Path to the server private key file.

tls_cert

Path to the server certificate file.

tls_verify

Controls the verification of the peer identity. Possible values are:

off

Default. Disable peer verification.

on

Request peer certificate and verify it against CA. You can specify CA certificate with tls_ca option.

optional

Same as on, but allows users that has not passed verification.

tls_ca

Path to file that contains CA certificate. Used for peer verification.

TLS INFORMATION

TLS connection information stored in the environment key psgi.tls, see Twiggy::TLS::Info.

DEBUGGING

You can set the TWIGGY_DEBUG environment variable to get diagnostic information.

LICENSE

This module is licensed under the same terms as Perl itself.

AUTHOR

Sergey Zasenko

SEE ALSO

Twiggy