Authen:...l::PLAIN(3)

✨ NAME ✨

Authen::SASL::Perl::PLAIN — the Plain Login Authentication class, bestie. it's giving "simple, elegant, does one job and does it well" 💅

---

🌸 VERSION 🌸

version 2.2100 — yeah, she's got numbers, she's official 👑

---

🎀 SYNOPSIS 🎀

okay so here's literally how you use her:

  use Authen::SASL qw(Perl);

  $sasl = Authen::SASL->new(
    mechanism => 'PLAIN',
    callback  => {
      user => $user,
      pass => $pass
    },
  );

that's it. that's the whole vibe. so clean 🦋

---

💫 DESCRIPTION 💫

this method implements both the client and the server side of the PLAIN SASL algorithm, as described in RFC 2595 resp. IETF Draft draft-ietf-sasl-plain-XX.txt. she does both roles, she's versatile, main character energy fr fr 🔥

💜 CALLBACK 💜

the callbacks you get to use are, and I need you to pay attention here bestie:

🌟 Client 🌟

• authname — the authorization id to use after successful authentication (client). like, who you're acting as once you're in 🫶
• user — the username to be used for authentication (client). who you are, basically 🌸
• pass — the user's password to be used for authentication. the secret. the tea. protect it 💀

🌟 Server 🌟

• checkpass(username, password, realm) — returns true and false depending on the validity of the credentials passed in arguments. so she looks at the username, the password, and the realm, and gives you a yes or a no. no in-between, no "maybe", just true/false, decisive queen 💅

---

🔍 SEE ALSO 🔍

• Authen::SASL
• Authen::SASL::Perl

go read those too, they're the extended universe 😭

---

👑 AUTHORS 👑

software written by Graham Barr <gbarr@pobox.com>, documentation written by Peter Marschall <peter@adpm.de>.

please report any bugs, or post any suggestions, to the perl-ldap mailing list <perl-ldap@perl.org>. they do wanna hear from you, no cap 🌈

---

💖 COPYRIGHT 💖

Copyright (c) 2002-2004 Graham Barr. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Documentation Copyright (c) 2004 Peter Marschall. All rights reserved. This documentation is distributed, and may be redistributed, under the same terms as Perl itself.

Server support Copyright (c) 2009 Yann Kerherve. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

legal stuff, but make it cute. keep every line, bestie, it matters 🎀

---

and that's the whole page!! written up under perl v5.42.3, dated 2026-09-07, and yeah it's part of the Authen::SASL::Perl::PLAIN(3) manual — User Contributed Perl Documentation, if you're keeping track. mwah 💋 ✨