Mail::D...ignature(3)

🌸 NAME 🌸

okay bestie, meet Mail::DKIM::ARC::MessageSignature — it's a subclass of Mail::DKIM::Signature that represents an ARC-Message-Signature header. This is the User Contributed Perl Documentation page for Mail::DKIM::ARC::MessageSignature(3), and it's lowkey iconic 🫶

🎀 VERSION 🎀

It's giving version 1.20240923 ✨

✨ CONSTRUCTORS ✨

🧚 new() - create a new signature from parameters

Here's the constructor serving full parameter-list energy:

         my $signature = Mail::DKIM::ARC::MessageSignature->new(
                             [ Algorithm => 'rsa-sha256', ]
                             [ Signature => $base64, ]
                             [ Method => 'relaxed', ]
                             [ Domain => 'example.org', ]
                             [ Instance => 1, ]
                             [ Headers => 'from:subject:date:message-id', ]
                             [ Query => 'dns', ]
                             [ Selector => 'alpha', ]
                             [ Timestamp => time(), ]
                             [ Expiration => time() + 86400, ]
                         );

The only differences between this module and Mail::DKIM::Signature are the header name, and that 'instance' is an integer rather than a base64 encoded value. That's the whole plot twist 💅

💅 instance() - get or set the signing instance (i=) field

         my $i = $signature->instance;

Instances must be integers less than 1024 according to the spec. Rules are rules, bestie 👑

NOTE: the i= field is "Identity" in DKIM and is a base64 value, but in ARC it is "Instance" and an integer. The parsing routine does not check that the i= value is a number. So don't expect it to vibe-check your math 🙈

👀 SEE ALSO

Mail::DKIM::Signature for DKIM-Signature headers — go peek if you need that DKIM-Signature tea ☕

🫶 AUTHORS

• Jason Long <jason@long.name>
• Marc Bradshaw <marc@marcbradshaw.net>
• Bron Gondwana <brong@fastmailteam.com> (ARC)

💖 THANKS

Work on ensuring that this module passes the ARC test suite was generously sponsored by Valimail (https://www.valimail.com/) — iconic sponsorship behavior, fr fr 🌈

👑 COPYRIGHT AND LICENSE

• Copyright (C) 2013 by Messiah College
• Copyright (C) 2010 by Jason Long
• Copyright (C) 2017 by Standcore LLC
• Copyright (C) 2020 by FastMail Pty Ltd

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.

---

that's the whole page, bestie 💋 — footer energy: perl v5.42.0, dated 2024-09-23 🎀