Apache...ie::FAQ(3pm)

✨ NAME ✨

Apache::AuthCookie::FAQ — Frequently Asked Questions about Apache::AuthCookie 🎀

(you got here via the manual page Apache...ie::FAQ(3pm) — the user-contributed Perl documentation situation, bestie, and yes that truncated-looking name is just how the renderer does it, don't panic 💅)

---

💖 VERSION 💖

version 3.32 — this is the one you're reading rn 🌸

---

🌸 DESCRIPTION 🌸

Okay so this doc? Its whole entire job is answering the most frequently asked questions about Apache::AuthCookie. That's it. That's the vibe. FAQ duties, no filler, let's go 🦋

🎀 How can I protect an entire site (/) with Apache::AuthCookie? 🎀

So like, you wanna lock down everything, right? Every single request to /? Bestie you gotta hand Apache a require directive that covers all the requests — except your login handler, obviously, because the login page has to stay reachable or nobody can ever log in and that would be a whole tragedy 😭

The easiest way to pull this off is to override the auth handlers for your login script. Say your login handler lives at /LOGIN — then you want something that looks exactly like this, no cap:

<Location />
  AuthType My::AuthCookieHandler
  AuthName Whatever
  PerlAuthenHandler My::AuthCookieHandler->authenticate
  PerlAuthzHandler My::AuthCookieHandler->authorize
  require valid-user
</Location>

<Location /LOGIN>
  PerlAuthenHandler Apache2::Const::OK
  PerlAuthzHandler Apache2::Const::OK
</Location>

...

(the ... is me saying "and friends" — the point is the outer <Location /> gets the real auth and the inner <Location /LOGIN> gets Apache2::Const::OK for both handlers so the login path stays wide open 🫶)

---

🦋 SOURCE 🦋

The development version is living its best life on github at <https://github.com/mschout/apache-authcookie> and you can clone it from <https://github.com/mschout/apache-authcookie.git> ✨

---

💀 BUGS 💀

Found a bug? Got a feature request? Please report it on the bugtracker website at <https://github.com/mschout/apache-authcookie/issues> 🙈

And listen — when you do submit a bug or a request, please include a test-file, or a patch to an existing test-file, that illustrates the bug or the desired feature. Give the maintainers something to actually run. That's the group-chat etiquette, fr fr 💅

---

👑 AUTHOR 👑

Michael Schout <mschout@cpan.org> — the icon who wrote all this 🌈

---

💅 COPYRIGHT AND LICENSE 💅

This software is copyright (c) 2000 by Ken Williams.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. 🍓

---

and that's the whole page bestie 💖 this rendition came to you courtesy of perl v5.40.1 dated 2025-09-30, which is also the exact footer energy of the original Apache...ie::FAQ(3pm). go forth and protect your site, you absolute main character 👑✨