HTTP::...quired(3pm)

📦
version 0.028 · 2 versions
  • 0.028 · debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking (latest)
  • 0.027 · ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

💅 HTTP::Throwable::Role::Status::ProxyAuthenticationRequired (3pm)

okay bestie, gather round, because this is the manual page for HTTP::Throwable::Role::Status::ProxyAuthenticationRequired — yes that's a whole mouthful, yes it's iconic, and yes it's basically the 407 Proxy Authentication Required status in role form. it's part of the User Contributed Perl Documentation, and it's giving "you shall not pass, but like, politely, through a proxy" 💖

✨ NAME ✨

HTTP::Throwable::Role::Status::ProxyAuthenticationRequired — 407 Proxy Authentication Required. that's the whole vibe. that's the name. slay. 👑

🎀 VERSION 🎀

version 0.028 — that's the number, no cap, don't @ me. 💅

🌸 DESCRIPTION 🌸

okay so this one is similar to 401 (Unauthorized), but here's the twist — it means the client has to first authenticate itself with the proxy. not the server, the proxy. important distinction, bestie, write it down. 📝

The proxy MUST return a Proxy-Authenticate header field containing a challenge applicable to the proxy for the requested resource. like, that's not optional, that's a MUST, capital letters, the RFC said what it said. 🔥

The client MAY repeat the request with a suitable Proxy-Authorization header field. may. as in, allowed. as in, go off, try again with your credentials this time. ✨

🦋 PERL VERSION 🦋

This library should run on perls released even a long time ago. it should work on any version of perl released in the last five years. we love a low-maintenance king. 🫶

Although it may work on older versions of perl, no guarantee is made that the minimum required version will not be increased. The version may be increased for any reason, and there is no promise that patches will be accepted to lower the minimum required perl.

so like… it might run on your ancient perl, but don't come crying if the floor moves. no promises were made. that's the deal. 😭

🧚 ATTRIBUTES 🧚

💜 proxy_authenticate

This is a required string or array of strings that will be used to populate the 'Proxy-Authenticate' header(s) when creating a PSGI response.

required. as in, you have to give it. not optional, not "eh maybe later". it takes one string or an array of strings, and it fills in the 'Proxy-Authenticate' header(s) on your PSGI response. that's the job. that's the whole job. 💅

🌈 SEE ALSO 🌈

go read the RFCs bestie, they're literally right there, iykyk 📚✨

👑 AUTHORS 👑

  • Stevan Little <stevan.little@iinteractive.com>
  • Ricardo Signes <cpan@semiotic.systems>

two absolute legends fr fr, we stan. 🫶

This software is copyright (c) 2011 by Infinity Interactive, Inc.

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 was rendered by perl v5.36.0 on 2023-01-24 — so yeah, that's the version and the date, noted and loved, mwah 💋 go forth and proxy-authenticate responsibly, 407 out 🌸🦋💅

📦 where this page comes from