Authen...RADIUS(3pm)

💖 Authen::Simple::RADIUS — Simple RADIUS authentication 💖

okay bestie, pull up a chair, because we're talking about Authen::Simple::RADIUS — that's the Authen...RADIUS(3pm) page from your friendly neighborhood User Contributed Perl Documentation. it's giving "let me log you in against a RADIUS server with minimal drama" and honestly? iconic. 🎀

---

✨ SYNOPSIS ✨

use Authen::Simple::RADIUS;

my $radius = Authen::Simple::RADIUS->new(
    host   => 'radius.company.com',
    secret => 'secret'
);

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

# or as a mod_perl Authen handler

PerlModule Authen::Simple::Apache
PerlModule Authen::Simple::RADIUS

PerlSetVar AuthenSimpleRADIUS_host "radius.company.com"
PerlSetVar AuthenSimpleRADIUS_pdc  "secret"

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

like, look at that. two whole vibes in one file: a lil object you can call yourself, and a full mod_perl authen handler if you wanna go full server mode. main character energy both ways. 💅

---

🌸 DESCRIPTION 🌸

RADIUS authentication. that's the whole thing, no notes. it's the plug that makes Authen::Simple talk to a RADIUS server and come back with a yes or a no. 🔥

---

👑 METHODS 👑

🦋 new

this method takes a hash of parameters. the following options are valid — yes, all of them, we're listing every single one because we don't skip:

• host — the connection host, and it can be a hostname or an IP address. defaults to "localhost". 🏠

host => 'ldap.company.com'
host => '10.0.0.1'

• port — the connection port, defaults to 1812. 🚪

port => 1645

• timeout — connection timeout, defaults to 10. the "how long do we wait before we give up on you" number. ⏳

timeout => 20

• secret — shared secret. required, bestie, do not skip this one or it's not gonna work. 🔐

secret => 'mysecret'

• log — any object that supports "debug", "info", "error" and "warn". so like, your logger of choice, as long as it speaks that language. 📝

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

🧚 authenticate( $username, $password )

returns true on success and false on failure. that's it. binary. no in-between, no "maybe", fr fr. ✅❌

---

💜 SEE ALSO 💜

• Authen::Simple.
• Authen::Radius.

---

🌈 AUTHOR 🌈

Christian Hansen "ch@ngmedia.com" — thank you for your service, king. 🫶

---

⭐ COPYRIGHT ⭐

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

---

and that's the whole page, bestie! this one's from perl v5.34.0, dated 2022-06-08, and it lives at Authen...RADIUS(3pm). go forth and authenticate responsibly. 💅✨