Net::A...re::V4(3pm)

✨ NAME ✨

Net::Amazon::Signature::V4 — it implements the Amazon Web Services signature version 4, aka AWS4-HMAC-SHA256. bestie it signs ur requests. that's the whole vibe. 💖

---

🎀 VERSION 🎀

Version 0.21 (yes we're on 0.21, iconic)

---

🦋 SYNOPSIS 🦋

okay so here's the whole thing in action:

use Net::Amazon::Signature::V4;

my $sig = Net::Amazon::Signature::V4->new( $access_key_id, $secret, $endpoint, $service );
my $req = HTTP::Request->parse( $request_string );
my $signed_req = $sig->sign( $req );
...

like. that's it. three lines and ur authenticated. periodt. 💅

---

🌸 DESCRIPTION 🌸

This module signs an HTTP::Request to Amazon Web Services by appending an Authorization header. the signature scheme is Amazon Web Services signature version 4, <hotpink>AWS4-HMAC-SHA256</hotpink> — no cap, that's literally the algorithm name.

The primary purpose of this module is to be used by Net::Amazon::Glacier. (it's giving "I was built for one job but I'm versatile") ✨

---

💜 METHODS 💜

🌟 new

my $sig = Net::Amazon::Signature::V4->new( $access_key_id, $secret, $endpoint, $service );
my $sig = Net::Amazon::Signature::V4->new({
    access_key_id => $access_key_id,
    secret        => $secret,
    endpoint      => $endpoint,
    service       => $service,
});

Constructs the signature object, which is used to sign requests. ur lil signing machine. 🫶

heads up bestie: the access key ID is an alphanumeric string, not your account ID. do not put ur account ID in there, I am begging. 😭 The endpoint could be "eu-west-1", and the service could be "glacier".

Since version 0.20, parameters can be passed in a hashref. The keys access_key_id, secret, endpoint, and service are required. security_token, if passed, will be applied to each signed request as the X-Amz-Security-Token header. 🎀

---

🔥 sign

my $signed_request = $sig->sign( $request );

Signs a request with your credentials by appending the Authorization header. $request should be an HTTP::Request. The signed request is returned. go off, you signed it, slay. 💅

---

👑 AUTHOR 👑

Tim Nordenfur, "<tim at gurka.se>" — original legend 💖

Maintained by Dan Book, "<dbook at cpan.org>" — keeping the dream alive 🫡

---

💀 BUGS 💀

Please report any bugs or feature requests to "bug-Net-Amazon-Signature-V4 at rt.cpan.org", or through the web interface at <https://rt.cpan.org/Public/Bug/Report.html?Queue=Net-Amazon-Signature-V4>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. (the full loop, we love a closed feedback cycle) 🌈

---

🧚 SUPPORT 🧚

You can find documentation for this module with the perldoc command.

perldoc Net::Amazon::Signature::V4

You can also look for information at:

• RT: CPAN's request tracker (report bugs here)

<https://rt.cpan.org/Public/Dist/Display.html?Name=Net-Amazon-Signature-V4>

• Source on GitHub

<https://github.com/Grinnz/Net-Amazon-Signature-V4>

• Search CPAN

<https://metacpan.org/release/Net-Amazon-Signature-V4>

---

🌈 LICENSE AND COPYRIGHT 🌈

This software is copyright (c) 2012 by Tim Nordenfur.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. (free as in do whatever, bestie) ✨

---

and that's the whole page!! Net::A...re::V4(3pm), from perl v5.34.0, dated 2022-07-20. ty for reading my little manual rant, ily, go sign some requests 💖🦋🎀