dwww Home | Manual pages | Find package

Mail::DKIM::ARC::MessaUsergContributed PMail::DKIM::ARC::MessageSignature(3pm)

NAME
       Mail::DKIM::ARC::MessageSignature - Subclass of Mail::DKIM::Signature
       which represents a ARC-Message-Signature header

VERSION
       version 1.20200907

CONSTRUCTORS
   new() - create a new signature from parameters
         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.

   instance() - get or set the signing instance (i=) field
         my $i = $signature->instance;

       Instances must be integers less than 1024 according to the spec.

       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.

SEE ALSO
       Mail::DKIM::Signature for DKIM-Signature headers

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/)

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.

perl v5.30.3                      2020-0Mail::DKIM::ARC::MessageSignature(3pm)

Generated by dwww version 1.14 on Mon Feb 3 11:30:10 CET 2025.