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 SSLv23:!SSLv2. See SSL_version of IO::Socket::SSL for other values.

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

Serhii Zasenko

SEE ALSO

Twiggy

cpanm Twiggy::TLS

perl -MCPAN -e shell
install Twiggy::TLS