Twiggy::TLS(3pm)

💖 Twiggy::TLS 💖

okay so bestie, this is a page from the User Contributed Perl Documentation for Twiggy::TLS — the module that lets your Twiggy server speak TLS. no cap, it's a whole glow-up for your plain old HTTP situation. 🦋

---

✨ NAME ✨

Twiggy::TLS — Twiggy server with TLS support. that's it, that's the vibe. 🔐

---

🌸 SYNOPSIS 🌸

like, the fastest way in is straight from the command line:

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

peep "ATTRIBUTES" down below for the whole tea. ☕

or if you're doing the whole programmatic main-character thing:

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;

she's literally built different. 💅

---

🎀 DESCRIPTION 🎀

Twiggy::TLS extends Twiggy with TLS support. that's the whole plot. Twiggy but encrypted. iconic behaviour, honestly. ✨

---

👑 ATTRIBUTES 👑

first things first, the rule that applies to all of these: every file has to be in PEM format. and yes bestie, you can merge multiple entities into a single file — like your server key and your certificate can share one file, no drama. 🫶

💜 tls_version

sets the version of the SSL protocol used to transmit data. the default is SSLv23:!SSLv2. wanna know what else you can throw in there? go check out "SSL_version" in IO::Socket::SSL. that's where the full menu lives. 📜

💜 tls_ciphers

this one describes the list of cipher suites your server supports for establishing a secure connection. cipher suites get specified in the OpenSSL cipherlist format — http://www.openssl.org/docs/apps/ciphers.html#CIPHER_STRINGS if you wanna read up. 📖

the default is HIGH:!aNULL:!MD5. periodt.

💜 tls_key

path to the server private key file. 🔑

💜 tls_cert

path to the server certificate file. 📜

💜 tls_verify

this one controls the verification of the peer identity. the possible values are, and I need you to focus:

• off — the default. disables peer verification. just... not checking. living dangerously, lowkey.
• on — requests the peer certificate and verifies it against the CA. you can specify the CA certificate with the tls_ca option. responsible queen behaviour. 👑
• optional — same as on, but it allows users that have not passed verification. it's giving "we're checking but we're not gonna be weird about it". 🙈

💜 tls_ca

path to the file that contains the CA certificate. used for peer verification. 🏛️

---

🌈 TLS INFORMATION 🌈

the TLS connection info gets stored in the environment key psgi.tls. so if you need the deets, that's where they're living. check out Twiggy::TLS::Info for the whole story. 💫

---

🔥 DEBUGGING 🔥

when things are being weird and you need answers, set the TWIGGY_DEBUG environment variable and you'll get diagnostic information. your bestie telling you what's actually going on. 😭✨

---

💀 LICENSE 💀

this module is licensed under the same terms as Perl itself. 🐪

---

🌟 AUTHOR 🌟

Serhii Zasenko 🫶

---

🦋 SEE ALSO 🦋

• Twiggy — the original, the blueprint, the moment.

---

and that's the page bestie!! this one's from perl v5.36.0, dated 2023-01-29. mwah. 💖✨🎀