1Mail::DKIM::ARC::Seal(3U)ser Contributed Perl DocumentatiMoanil::DKIM::ARC::Seal(3)
2
3
4

NAME

6       Mail::DKIM::ARC::Seal - represents a ARC-Seal header
7

CONSTRUCTORS

9   new() - create a new signature from parameters
10         my $signature = Mail::DKIM::ARC::Seal->new(
11                             [ Algorithm => 'rsa-sha256', ]
12                             [ Signature => $base64, ]
13                             [ Domain => 'example.org', ]
14                             [ Instance => 1, ]
15                             [ Chain => 'none', ] # none|fail|pass
16                             [ Query => 'dns', ]
17                             [ Selector => 'alpha', ]
18                             [ Timestamp => time(), ]
19                             [ Expiration => time() + 86400, ]
20                         );
21
22       The ARC-Seal is similar to a DKIM signature but with the following
23       changes:
24
25       https://tools.ietf.org/html/draft-ietf-dmarc-arc-protocol-06
26
27       5.1.1.1.  Tags in the ARC-Seal Header Field Value
28
29          The following tags are the only supported tags for an ARC-Seal field.
30          All of them MUST be present.  Unknown tags MUST be ignored and do not
31          affect the validity of the header.
32
33          o  a = hash algorithm; syntax is the same as the "a=" tag defined in
34             Section 3.5 of [RFC6376];
35
36          o  b = digital signature; syntax is the same as the "b=" tag defined
37             in Section 3.5 of [RFC6376];
38
39          o  cv = chain validation status: valid values:
40
41             *  'none' = no pre-existing chain;
42
43             *  'fail' = the chain as received does not or can not validate; or
44
45             *  'pass' = valid chain received.
46
47          o  d = domain for key; syntax is the same as the "d=" tag defined in
48             Section 3.5 of [RFC6376];
49
50          o  i = "instance" or sequence number; monotonically increasing at
51             each "sealing" entity, beginning with '1', see Section 5.1.1.1.1
52             regarding the valid range
53
54          o  s = selector for key; syntax is the same as the "s=" tag defined
55             in Section 3.5 of [RFC6376];
56
57          o  t = timestamp; syntax is the same as the "t=" tag defined in
58             Section 3.5 of [RFC6376].
59
60   chain() - get or set the chain parameter (cv=) field
61       This must be one of "pass", "fail" or "none".  For a chain to be valid,
62       the very first (i=1) seal MUST be cv=none, and all further seals MUST
63       be cv=pass.
64
65   instance() - get or set the signing instance (i=) field
66         my $i = $signature->instance;
67
68       Instances must be integers less than 1024 according to the spec.
69

SEE ALSO

71       Mail::DKIM::Signature for DKIM-Signature headers
72
73       Mail::DKIM::ARC::MessageSignature for ARC-Message-Signature headers
74

AUTHOR

76       Bron Gondwana, <brong@fastmailteam.com>
77

79       Copyright (C) 2017 by FastMail Pty Ltd
80
81       This library is free software; you can redistribute it and/or modify it
82       under the same terms as Perl itself, either Perl version 5.8.6 or, at
83       your option, any later version of Perl 5 you may have available.
84
85
86
87perl v5.28.0                      2017-12-16          Mail::DKIM::ARC::Seal(3)
Impressum