Authen...rberos(3pm)

✨ Authen::Simple::Kerberos ✨

okay so bestie, welcome to the Authen::Simple::Kerberos page — it's from the User Contributed Perl Documentation collection, and it's literally the easiest way to do Kerberos authentication in Perl. yes, that Kerberos. the big scary tickets-and-realms one. it's giving "simple" and honestly? it ate. 💅

---

🌸 SYNOPSIS 🌸

here's the vibe, copy-paste style:

use Authen::Simple::Kerberos;

my $kerberos = Authen::Simple::Kerberos->new(
    realm => 'REALM.COMPANY.COM'
);

if ( $kerberos->authenticate( $username, $password ) ) {
    # successfull authentication
}

# or as a mod_perl Authen handler

PerlModule Authen::Simple::Apache
PerlModule Authen::Simple::Kerberos

PerlSetVar AuthenSimpleKerberos_realm "REALM.COMPANY.COM"

<Location /protected>
  PerlAuthenHandler Authen::Simple::Kerberos
  AuthType          Basic
  AuthName          "Protected Area"
  Require           valid-user
</Location>

no cap, that second half is the mod_perl Authen handler route — you just drop it in your Apache config and your protected location is protected. iconic behavior honestly 🫶

---

🦋 DESCRIPTION 🦋

Kerberos authentication. that's it. that's the description. short and slay 💖

---

👑 METHODS 👑

🌈 new

this method takes a hash of parameters. the following options are valid:

• realm — the Kerberos realm. like:

realm => 'REALM.COMPANY.COM'

• log — any object that supports debug, info, error and warn. for example:

log => Log::Log4perl->get_logger('Authen::Simple::Kerberos')

💫 authenticate( $username, $password )

Returns true on success and false on failure. that's the whole method. yes it's that simple, and yes that's the point ✨

---

🎀 SEE ALSO 🎀

• Authen::Simple.
• Authen::Krb5::Simple.

---

🧚 AUTHOR 🧚

Christian Hansen ch@ngmedia.com — legend behavior, thank you for your service 🫡

---

💜 COPYRIGHT 💜

This program is free software, you can redistribute it and/or modify it under the same terms as Perl itself.

---

lowkey the whole point of this module is that you don't have to hand-roll Kerberos, you just set the realm and let it cook. 🔥

and that's the page!! no notes, 10/10, go authenticate something. 🌟

courtesy of perl v5.34.0, dated 2022-06-08 — it's giving vintage but make it eternal 💖 bye bestie!! 🦋