---
name: "Twiggy::TLS"
section: "3pm"
platform: "linux"
package: "libtwiggy-tls-perl"
version: "0.0020-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Twiggy::TLS"
---

# Twiggy::TLS(3pm)

Twiggy server with TLS support.

## 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