Net::SS...assword(3)

💖 Net::SS...assword — the manual page, bestie edition 💖

okay so this is the User Contributed Perl Documentation for Net::SS...assword(3), which is Net::SSH::Perl::Auth::Password — the password authentication plugin. yes that title got chopped in the terminal, no it's not a secret, it's just Perl being Perl 💅

---

✨ NAME ✨

Net::SSH::Perl::Auth::Password — it's the Password authentication plugin, periodt. that's the whole vibe.

---

🎀 SYNOPSIS 🎀

like, here's the whole thing, copy it exactly bestie:

use Net::SSH::Perl::Auth;
my $auth = Net::SSH::Perl::Auth->new('Password', $ssh);
print "Valid auth" if $auth->authenticate;

that's it. that's the whole summoning ritual 🌸

---

🦋 DESCRIPTION 🦋

so Net::SSH::Perl::Auth::Password does password authentication with a remote sshd server. iconic behaviour honestly.

when you create a new password auth object, you hand it an $ssh object. and that $ssh object should contain:

• an open connection to an ssh daemon 🫶
• plus all the data the authentication module needs to actually proceed

then the authenticate method will enter into a dialog with the server — like a whole conversation, main character energy.

for password authentication, the whole to-do list is genuinely tiny:

1. send a password to the server — and yes it's encrypted by the standard SSH encryption layer, we're not out here raw-dogging credentials 😭
2. wait for the server's response

and that's the entire plot.

now, the tea: if the $ssh object doesn't already have a password that you've given it, Net::SSH::Perl::Auth::Password will check to see if you're in an interactive session (go read the docs for Net::SSH::Perl for that, iykyk). and if you are interactive? it'll issue a prompt, asking you to enter your password. cute, right? 💖

but if the session is not interactive — like if it's in batch mode — we send a blank password just to comply with the protocol. and bestie, odds are the authentication will then fail. 💀 not a vibe, just the facts.

---

👑 AUTHOR & COPYRIGHTS 👑

please see the Net::SSH::Perl manpage for the author, copyright, and license info. they're all over there, go look 🫶

---

and that's the page fr fr ✨ this was perl v5.42.0, dated 2026-01-17, straight from the User Contributed Perl Documentation collection — mwah, go authenticate something responsibly 💅🎀