Wallet...:Regex(3pm)

✨ Wallet::ACL::Krb5::Regex ✨

okay bestie, so this is the manual page for Wallet::ACL::Krb5::Regex — it lives in the Wallet...:Regex(3pm) section of the Perl docs (User Contributed Perl Documentation, if you're being fancy) 💖

---

🌸 NAME 🌸

Wallet::ACL::Krb5::Regex — it's the regex wallet ACL verifier for Kerberos principals, and yes that's a whole mouthful, we love her anyway 🎀

---

🦋 SYNOPSIS 🦋

my $verifier = Wallet::ACL::Krb5::Regex->new;
my $status = $verifier->check ($principal, $acl);
if (not defined $status) {
    die "Something failed: ", $verifier->error, "\n";
} elsif ($status) {
    print "Access granted\n";
} else {
    print "Access denied\n";
}

literally the whole vibe in seven lines, no cap 💅

---

👑 DESCRIPTION 👑

Wallet::ACL::Krb5::Regex is the wallet ACL verifier you use to verify ACL lines of type "krb5-regex". The value of one of those ACLs is a Perl regular expression, and here's the tea: the ACL grants access to a given Kerberos principal if and only if that regular expression matches the principal. No match, no access, periodt ✨

---

💅 METHODS 💅

• new() — makes a brand new ACL verifier for you 🫶. For this particular verifier there's no setup work at all, it's giving low-maintenance queen.
• check(PRINCIPAL, ACL) — returns true if the Perl regular expression that the ACL specifies matches the PRINCIPAL, false if it doesn't, and undef when there's an error (go peek at DIAGNOSTICS below for that drama 😭).
• error() — hands you the error back, but only if check() returned undef. Otherwise, nothing to see here 💀.

---

🌈 DIAGNOSTICS 🌈

• malformed krb5-regex ACL — the ACL parameter you passed to check() was a malformed Perl regular expression. it's broken bestie, fix it 😭
• no principal specified — the PRINCIPAL parameter you passed to check() was undef or the empty string. you forgot the principal, babe 🙈
• no ACL specified — the ACL parameter you passed to check() was undef or the empty string. and you forgot the ACL too. iconic, but not in the good way 💀

---

⭐ SEE ALSO ⭐

Wallet::ACL(3), Wallet::ACL::Base(3), Wallet::ACL::Krb5(3), wallet-backend(8)

This module is part of the wallet system 🧚. The current version is available from <https://www.eyrie.org/~eagle/software/wallet/> — go get her 👑

---

🎀 AUTHOR 🎀

Ian Durkacz — thank you for your service, king 🫶

---

and that's a wrap on the Wallet...:Regex(3pm) page, bestie!! this one's perl v5.40.0, dated 2024-11-12, brought to you by User Contributed Perl Documentation 💖✨🦋 go forth and match those principals, mwah 💅🌸