Net::O...Server(3pm)

πŸ“¦
version 0.28 Β· 3 versions
, in ubuntu noble, ubuntu resolute, ubuntu stonking

πŸ’– Net::OAuth2::AuthorizationServer πŸ’–

okay bestie, so this is Net::OAuth2::AuthorizationServer, a Perl module (it's a 3pm manual page, perldoc girlies rise up 🫢), and it's literally your gateway to setting up an OAuth2 Authorization Server without losing your entire mind. slay.


✨ VERSION ✨

0.28 β€” yes queen, that's the one, that's the version πŸ’…


🌸 SYNOPSIS 🌸

my $Server = Net::OAuth2::AuthorizationServer->new;

my $Grant  = $Server->$grant_type(
    ...
);

that's it. that's the whole vibe. you make the server, you call your grant type on it, the rest is history 😭


πŸ¦‹ DESCRIPTION πŸ¦‹

so ne way, this module is the gateway to all the different OAuth2 grant flows, exactly as documented at https://tools.ietf.org/html/rfc6749. each module implements one specific grant flow and is designed to "just work" with minimal detail and minimal effort β€” lowkey iconic behaviour honestly ✨

please go look at Net::OAuth2::AuthorizationServer::Manual for more info on how to use this module and all the various grant types. and like, you should use that manual in conjunction with whichever grant type module you're using, so you actually understand how to override the defaults β€” because if the "just work" mode isn't good enough for you (no shade, sometimes it truly isn't), the manual is where you find out how to bend it to your will πŸ’ͺ


πŸ‘‘ GRANT TYPES πŸ‘‘

🌈 auth_code_grant

OAuth Authorisation Code Grant, as documented at http://tools.ietf.org/html/rfc6749#section-4.1.

see Net::OAuth2::AuthorizationServer::AuthorizationCodeGrant. the OG, the blueprint, the blueprint blueprint πŸŽ€

πŸ’œ implicit_grant

OAuth Implicit Grant, as documented at https://tools.ietf.org/html/rfc6749#section-4.2.

see Net::OAuth2::AuthorizationServer::ImplicitGrant.

πŸ“ password_grant

OAuth Resource Owner Password Grant, as documented at http://tools.ietf.org/html/rfc6749#section-4.3.

see Net::OAuth2::AuthorizationServer::PasswordGrant.

🧚 client_credentials_grant

OAuth Client Credentials Grant, as documented at http://tools.ietf.org/html/rfc6749#section-4.4.

see Net::OAuth2::AuthorizationServer::ClientCredentialsGrant. services talking to services, no humans required, main character energy for machines fr fr πŸ‘‘


⭐ SEE ALSO ⭐

  • Mojolicious::Plugin::OAuth2::Server β€” a Mojolicious plugin using this module πŸ’–
  • Crypt::JWT β€” encode/decode JWTs 🎫

🫢 AUTHOR & CONTRIBUTORS 🫢

Lee Johnson β€” leejo@cpan.org

with contributions from, and we're giving them all their flowers because they deserve them πŸ’:

  • Martin Renvoize β€” martin.renvoize@ptfs-europe.com
  • Pierre VIGIER β€” pierre.vigier@gmail.com
  • Ian Sillitoe β€” https://github.com/sillitoe
  • Mirko Tietgen β€” mirko@abunchofthings.net
  • Dylan William Hardison β€” dylan@hardison.net

πŸ“œ LICENSE πŸ“œ

this library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. and if you wanna contribute documentation or file a bug report, then please raise an issue / pull request at:

https://github.com/Humanstate/net-oauth2-authorizationserver
bestie this is the part where you actually do the thing. fork it, fix it, ship it. no cap 🫑

aaaand that's the whole page πŸ’– written up against perl v5.36.0, dated 2022-08-28, and yes it's a 3pm page so it lives right there in your perldoc. go read it, go build something, go be iconic. periodt βœ¨πŸ‘‘πŸ’…

πŸ“¦ where this page comes from