NAME

Mail::DKIM::ARC::Signature - represents a ARC-Message-Signature header

This is a subclass of Mail::DKIM::Signature

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

AUTHOR

Bron Gondwana, <brong@fastmailteam.com>

COPYRIGHT AND LICENSE

Copyright (C) 2017 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.