Net::S...::SMTP(3pm)

💖 NAME 💖

Net::SSLGlue::SMTP — the lil glow-up that makes Net::SMTP able to use SSL 🦋✨

(also hey hi, this is a User Contributed Perl Documentation page, Net::S...::SMTP(3pm), and bestie it is so useful)

---

🌸 SYNOPSIS 🌸

use Net::SSLGlue::SMTP;
my $smtp_ssl = Net::SMTP->new( $host,
    SSL => 1,
    SSL_ca_path => ...
);

my $smtp_plain = Net::SMTP->new( $host );
$smtp_plain->starttls( SSL_ca_path => ... );

okay so look at that. two whole vibes: straight-in with SSL, or slide into it later with STARTTLS. both iconic 💅

---

✨ DESCRIPTION ✨

Net::SSLGlue::SMTP extends Net::SMTP so you can either start directly with SSL, or switch later to SSL using the STARTTLS command. your call, queen 👑

By default it will take care to verify the certificate according to the rules for SMTP implemented in IO::Socket::SSL. it's got you, it's not gonna let some sketchy cert walk in uninvited 🫶

---

🎀 METHODS 🎀

• new — the new method of Net::SMTP is now able to start directly with SSL when the argument "<SSL =" 1>> is given. In this case it will not create an IO::Socket::INET object but an IO::Socket::SSL object instead. One can give the usual SSL_* parameter of IO::Socket::SSL to Net::SMTP::new. it's giving ✨instant upgrade✨
• starttls — if the connection is not yet SSLified it will issue the STARTTLS command and change the object, so that SSL will now be used. The usual SSL_* parameter of IO::Socket::SSL will be given. glow-up mid-conversation, we love a transformation arc 🧚
• peer_certificate ... — once the SSL connection is established the object is derived from IO::Socket::SSL so that you can use this method to get information about the certificate. See the IO::Socket::SSL documentation. yes bestie, go read the receipts 📜

All of these methods can take the SSL_* parameter from IO::Socket::SSL to change the behavior of the SSL connection. The following parameters are especially useful:

• SSL_ca_path, SSL_ca_file — Specifies the path or a file where the CAs used for checking the certificates are located. This is typically etc/ssl/certs on UNIX systems. that's where the trusted besties live 🏠
• SSL_verify_mode — If set to 0, verification of the certificate will be disabled. By default it is set to 1 which means that the peer certificate is checked. ngl turning this off is a whole choice — know that you're doing it 😭
• SSL_verifycn_name — Usually the name given as the hostname in the constructor is used to verify the identity of the certificate. If you want to check the certificate against another name you can specify it with this parameter. yes you can catfish-check against a different name, it's fine 💅

---

🦋 SEE ALSO 🦋

IO::Socket::SSL, Net::SMTP

(the originals, the icons, the main characters 👑)

---

🌈 COPYRIGHT 🌈

This module is copyright (c) 2008, Steffen Ullrich. All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.

---

and that's the whole page, bestie 🍓 it was perl v5.36.0 flavored and dated 2022-12-06 — ty for reading, mwah 💖✨🎀