lib/Mail/DKIM2/Signature.pm

filter: Statementstmt 53.6% 211 / 393 Branchbran 41.1% 74 / 180 Conditioncond 26.7% 23 / 86 MC/DCmcdc 8.0% 4 / 50 Subroutinesub 59.0% 39 / 66 Podpod 100% 42 / 42 totaltotal 48.1% 393 / 817 CC 133 SCAR 23.1
CC
133
Cov
47%
new
35.4
new
35.4
check_duplicates
14.5
CRAP 10.1
« lib/Mail/DKIM2/Common.pm ↑ Summary lib/Mail/DKIM2/Chain.pm »
1 package Mail::DKIM2::Signature;
2 186 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
3 186 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
4  
5 186 our $VERSION = '0.33';
6  
7 186 ▶use MIME::Base64 qw(encode_base64 decode_base64);
Subroutine BEGIN: called CC=1 SCAR=0.0
8 186 ▶use Carp;
Subroutine BEGIN: called CC=1 SCAR=0.0
9  
10 186 ▶use Mail::DKIM2::Common ();
Subroutine BEGIN: called CC=1 SCAR=0.0
11 186 ▶use Mail::DKIM2::Util ();
Subroutine BEGIN: called CC=1 SCAR=0.0
12 186 ▶use Mail::DKIM2::Address qw(to_rfc5321_path to_alabel);
Subroutine BEGIN: called CC=1 SCAR=0.0
13 186 ▶use Mail::DKIM2::Fold qw(fold_header);
Subroutine BEGIN: called CC=1 SCAR=0.0
14  
15 186 ▶use base 'Mail::DKIM2::TagValueList';
Subroutine BEGIN: called CC=1 SCAR=0.0
16  
17 # Indices into the 3-element signature item arrays [selector, algorithm, value]
18 186 ▶use constant SIG_SELECTOR => 0;
Subroutine BEGIN: called CC=1 SCAR=0.0
19 186 ▶use constant SIG_ALGORITHM => 1;
Subroutine BEGIN: called CC=1 SCAR=0.0
20 186 ▶use constant SIG_VALUE => 2;
Subroutine BEGIN: called CC=1 SCAR=0.0
21  
22 # --- Construction ---
23  
24 3914 ▶sub new {
Subroutine new: called CC=13 SCAR=35.7
Pod documented
25 0 ▶ my ($class, %args) = @_;
Subroutine new: not called CC=13 SCAR=35.7
Pod documented
26 0 Mail::DKIM2::Util::check_options("$class->new", \%args,
27 qw(Domain Flags MailFrom NextDomain Nonce RcptTo Sequence Signatures
28 Timestamp Version));
29  
30 0 my $self = $class->SUPER::new();
31 0 bless $self, $class;
32  
33 0 ▶ $self->set_tag('i', $args{Sequence}) if defined $args{Sequence};
Branch: 2 branches
BranchTrueFalseTotal
if defined $args{"Sequence"} 779 3134 3913
if defined $args{"Sequence"} 0 0 0
34 0 ▶ $self->set_tag('m', $args{Version}) if defined $args{Version};
Branch: 2 branches
BranchTrueFalseTotal
if defined $args{"Version"} 776 3137 3913
if defined $args{"Version"} 0 0 0
35 0 ▶ $self->set_tag('t', $args{Timestamp}) if defined $args{Timestamp};
Branch: 2 branches
BranchTrueFalseTotal
if defined $args{"Timestamp"} 778 3135 3913
if defined $args{"Timestamp"} 0 0 0
36 0 ▶ $self->set_tag('d', $args{Domain}) if defined $args{Domain};
Branch: 2 branches
BranchTrueFalseTotal
if defined $args{"Domain"} 797 3116 3913
if defined $args{"Domain"} 0 0 0
37 # nd= (-09 §10.7) replaces mf=/rt= for an imaginary forwarding hop.
38 0 ▶ $self->set_tag('nd', $args{NextDomain}) if defined $args{NextDomain};
Branch: 2 branches
BranchTrueFalseTotal
if defined $args{"NextDomain"} 37 3876 3913
if defined $args{"NextDomain"} 0 0 0
39 0 ▶ $self->set_tag('n', $args{Nonce}) if defined $args{Nonce};
Branch: 2 branches
BranchTrueFalseTotal
if defined $args{"Nonce"} 0 3913 3913
if defined $args{"Nonce"} 0 0 0
40  
41 0 ▶ if (defined $args{Flags}) {
Branch: 2 branches
BranchTrueFalseTotal
if (defined $args{"Flags"}) 20 3893 3913
if (defined $args{"Flags"}) 0 0 0
42 0 $self->set_tag('f', join(',', @{$args{Flags}}));
43 }
44  
45 # mf= and rt= are base64-encoded SMTP addresses; mutually exclusive with nd=
46 0 ▶ if (!defined $args{NextDomain}) {
Branch: 2 branches
BranchTrueFalseTotal
unless (defined $args{"NextDomain"}) 3876 37 3913
unless (defined $args{"NextDomain"}) 0 0 0
47 0 ▶ if (defined $args{MailFrom}) {
Branch: 2 branches
BranchTrueFalseTotal
if (defined $args{"MailFrom"}) 637 3239 3876
if (defined $args{"MailFrom"}) 0 0 0
48 0 $self->set_tag('mf', encode_base64(_path($args{MailFrom}), ''));
49 }
50 0 ▶ if (defined $args{RcptTo}) {
Branch: 2 branches
BranchTrueFalseTotal
if (defined $args{"RcptTo"}) 637 3239 3876
if (defined $args{"RcptTo"}) 0 0 0
51 0 my @encoded = map { encode_base64(_path($_), '') } @{$args{RcptTo}};
52 0 $self->set_tag('rt', join(',', @encoded));
53 }
54 }
55  
56 0 ▶ if (defined $args{Signatures}) {
Branch: 2 branches
BranchTrueFalseTotal
if (defined $args{"Signatures"}) 637 3276 3913
if (defined $args{"Signatures"}) 0 0 0
57 # Encode as sel:alg:sig,sel2:alg2:sig2,...
58 0 my @parts;
59 0 for my $item (@{$args{Signatures}}) {
60 0 push @parts, join(':', @$item);
61 }
62 0 $self->set_tag('s', join(',', @parts));
63 }
64  
65 0 return $self;
66 }
67  
68 # An address as mf= or rt= records it: an RFC 5321 path in angle brackets
69 # (-09 sections 10.5, 10.6), its domain written as A-labels (section 18).
70 1283 ▶sub _path {
Subroutine _path: called CC=1 SCAR=1.2
71 0 ▶ my ($addr) = @_;
Subroutine _path: not called CC=1 SCAR=1.2
72 0 my $path = to_rfc5321_path($addr);
73 0 $path =~ s/\@([^@>]*)>\z/"\@" . to_alabel($1) . ">"/e;
74 0 return $path;
75 }
76  
77 # --- Parse from header line ---
78  
79 3116 ▶sub parse {
Subroutine parse: called CC=2 SCAR=10.0
Pod documented
80 0 ▶ my ($class, $header_line) = @_;
Subroutine parse: not called CC=2 SCAR=10.0
Pod documented
81 # Strip "DKIM2-Signature:" prefix if present
82 0 $header_line =~ s/^\s*DKIM2-Signature:\s*//i;
83 0 my $self = $class->SUPER::parse($header_line);
84 0 ▶ bless $self, ref($class) || $class;
Condition33%2/6
ref $class || $class
l!l&&r!l&&!r
231140
ref $class || $class
l!l&&r!l&&!r
000
MC/DC0%0/2
ref $class || $class
ref $class $class
MC/DC0%0/2
ref $class || $class
ref $class $class
Truth table66%2/3
A || B
A= ref $classB= $class
ABresult
1X1
011
000
Truth table0%0/3
A || B
A= ref $classB= $class
ABresult
1X1
011
000
85 0 return $self;
86 }
87  
88 # --- Tag accessors ---
89  
90 3197 ▶sub sequence {
Subroutine sequence: called CC=2 SCAR=11.6
Pod documented
91 0 ▶ my $self = shift;
Subroutine sequence: not called CC=2 SCAR=11.6
Pod documented
92 0 ▶ if (@_) { $self->set_tag('i', shift) }
Branch: 2 branches
BranchTrueFalseTotal
if (@_) 0 3197 3197
if (@_) 0 0 0
93 0 return $self->get_tag('i');
94 }
95  
96 11825 ▶sub version {
Subroutine version: called CC=2 SCAR=11.6
Pod documented
97 0 ▶ my $self = shift;
Subroutine version: not called CC=2 SCAR=11.6
Pod documented
98 0 ▶ if (@_) { $self->set_tag('m', shift) }
Branch: 2 branches
BranchTrueFalseTotal
if (@_) 0 11825 11825
if (@_) 0 0 0
99 0 return $self->get_tag('m');
100 }
101  
102 1246 ▶sub timestamp {
Subroutine timestamp: called CC=2 SCAR=11.6
Pod documented
103 0 ▶ my $self = shift;
Subroutine timestamp: not called CC=2 SCAR=11.6
Pod documented
104 0 ▶ if (@_) { $self->set_tag('t', shift) }
Branch: 2 branches
BranchTrueFalseTotal
if (@_) 0 1246 1246
if (@_) 0 0 0
105 0 return $self->get_tag('t');
106 }
107  
108 3023 ▶sub domain {
Subroutine domain: called CC=2 SCAR=11.6
Pod documented
109 0 ▶ my $self = shift;
Subroutine domain: not called CC=2 SCAR=11.6
Pod documented
110 0 ▶ if (@_) { $self->set_tag('d', shift) }
Branch: 2 branches
BranchTrueFalseTotal
if (@_) 0 3023 3023
if (@_) 0 0 0
111 0 return $self->get_tag('d');
112 }
113  
114 # nd= the domain that signs the next DKIM2-Signature (-09 §10.7). Present
115 # only for an imaginary forwarding hop, where it replaces mf=/rt=.
116 2689 ▶sub next_domain {
Subroutine next_domain: called CC=2 SCAR=11.6
Pod documented
117 0 ▶ my $self = shift;
Subroutine next_domain: not called CC=2 SCAR=11.6
Pod documented
118 0 ▶ if (@_) { $self->set_tag('nd', shift) }
Branch: 2 branches
BranchTrueFalseTotal
if (@_) 0 2689 2689
if (@_) 0 0 0
119 0 return $self->get_tag('nd');
120 }
121  
122 39 ▶sub nonce {
Subroutine nonce: called CC=3 SCAR=14.2
Pod documented
123 0 ▶ my $self = shift;
Subroutine nonce: not called CC=3 SCAR=14.2
Pod documented
124 0 ▶ if (@_) {
Branch: 2 branches
BranchTrueFalseTotal
if (@_) 3 36 39
if (@_) 0 0 0
125 0 my $val = shift;
126 0 ▶ Carp::croak "nonce must not exceed 64 characters" if length($val) > 64;
Branch: 2 branches
BranchTrueFalseTotal
if length $val > 64 1 2 3
if length $val > 64 0 0 0
127 0 $self->set_tag('n', $val);
128 }
129 0 return $self->get_tag('n');
130 }
131  
132 # Where the grammar allows FWS inside a value -- within a base64string
133 # (§2.13: a signature value folded across lines), and around the "," and ":"
134 # that separate s= items and their parts (§10.9's sig-set) -- it is not part
135 # of the value.
136 11498 ▶sub _strip_fws {
Subroutine _strip_fws: called CC=2 SCAR=10.3
137 0 ▶ my ($v) = @_;
Subroutine _strip_fws: not called CC=2 SCAR=10.3
138 0 ▶ return $v unless defined $v;
Branch: 2 branches
BranchTrueFalseTotal
unless defined $v 0 11498 11498
unless defined $v 0 0 0
139 0 $v =~ s/[ \t\r\n]//g;
140 0 return $v;
141 }
142  
143 # f= is a comma-separated list of flags (§10.10). Get as an arrayref, or set
144 # from one.
145 632 ▶sub flags {
Subroutine flags: called CC=4 SCAR=18.6
Pod documented
146 0 ▶ my $self = shift;
Subroutine flags: not called CC=4 SCAR=18.6
Pod documented
147 0 ▶ if (@_) {
Branch: 2 branches
BranchTrueFalseTotal
if (@_) 1 631 632
if (@_) 0 0 0
148 0 my $list = shift;
149 0 ▶ $self->set_tag('f', join(',', ref $list eq 'ARRAY' ? @$list : ($list)));
Branch: 2 branches
BranchTrueFalseTotal
ref $list eq 'ARRAY' ? : 1 0 1
ref $list eq 'ARRAY' ? : 0 0 0
150 }
151 0 my $f = $self->get_tag('f');
152 0 ▶ return unless defined $f;
Branch: 2 branches
BranchTrueFalseTotal
unless defined $f 620 12 632
unless defined $f 0 0 0
153 0 return [grep { length } map { _strip_fws($_) } split /,/, $f];
154 }
155  
156 # One s= item (§10.9): selector [FWS] ":" [FWS] sig-name [FWS] ":"
157 # message-sig. FWS is trimmed from around the selector and algorithm and
158 # removed from inside the base64 value -- and nowhere else: whitespace inside
159 # a selector or algorithm name makes the item malformed, never a different
160 # name ("rsa- sha256" is not rsa-sha256; follow-up review F4). A Selector is
161 # a Domain (§3.6) and a sig-name a textstring of letters, digits, "-" and "_".
162 186 my $FWS = qr/[ \t\r\n]*/;
163 11482 ▶sub _parse_sig_item {
Subroutine _parse_sig_item: called CC=3 SCAR=14.2
164 0 ▶ my ($part) = @_;
Subroutine _parse_sig_item: not called CC=3 SCAR=14.2
165 0 my ($sel, $alg, $val) = $part =~ /\A$FWS([^:]*?)$FWS:$FWS([^:]*?)$FWS:(.*)\z/s;
166 0 ▶ return ([split(/:/, _strip_fws($part), 3)], 0) unless defined $val;
Branch: 2 branches
BranchTrueFalseTotal
unless defined $val 2 11480 11482
unless defined $val 0 0 0
167 0 ▶ my $ok = $sel =~ /\A[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*\z/
Condition50%3/6
$sel =~ /\A[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*\z/ && $alg =~ /\A[A-Za-z0-9_-]+\z/
!ll&&!rl&&r
3211475
$sel =~ /\A[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*\z/ && $alg =~ /\A[A-Za-z0-9_-]+\z/
!ll&&!rl&&r
000
MC/DC100%2/2
$sel =~ /\A[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*\z/ && $alg =~ /\A[A-Za-z0-9_-]+\z/
$sel =~ /\A[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*\z/ $alg =~ /\A[A-Za-z0-9_-]+\z/
MC/DC0%0/2
$sel =~ /\A[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*\z/ && $alg =~ /\A[A-Za-z0-9_-]+\z/
$sel =~ /\A[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*\z/ $alg =~ /\A[A-Za-z0-9_-]+\z/
Truth table100%3/3
A && B
A= $sel =~ /\A[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*\z/B= $alg =~ /\A[A-Za-z0-9_-]+\z/
ABresult
0X0
100
111
Truth table0%0/3
A && B
A= $sel =~ /\A[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*\z/B= $alg =~ /\A[A-Za-z0-9_-]+\z/
ABresult
0X0
100
111
168 && $alg =~ /\A[A-Za-z0-9_-]+\z/;
169 0 return ([$sel, $alg, _strip_fws($val)], $ok);
170 }
171  
172 # The s= items and whether they all parsed: (\@items, $ok, \@groups). s= is
173 # sig-all lists joined by "|" (-09 §10.9), each sig-set *("," sig-set); the
174 # items are in s= order and @groups lists each group's item indices. An
175 # empty member (a leading, trailing or doubled "|" or ",") is a syntax
176 # error (the -08 contract, D2), and the items are then the ","-split ones.
177 2828 ▶sub _parse_sig_items {
Subroutine _parse_sig_items: called CC=6 SCAR=23.5
178 0 ▶ my ($s) = @_;
Subroutine _parse_sig_items: not called CC=6 SCAR=23.5
179 0 my $split = Mail::DKIM2::Common::split_any_all($s);
180 0 my (@items, @groups, $bad);
181 0 ▶ for my $group ($split ? @$split : [ split /,/, $s, -1 ]) {
Branch: 2 branches
BranchTrueFalseTotal
$split ? : 2824 4 2828
$split ? : 0 0 0
182 0 my @idx;
183 0 for my $part (@$group) {
184 0 my ($item, $ok) = _parse_sig_item($part);
185 0 ▶ $bad = 1 unless $ok;
Branch: 2 branches
BranchTrueFalseTotal
unless $ok 7 11475 11482
unless $ok 0 0 0
186 0 push @idx, scalar @items;
187 0 push @items, $item;
188 }
189 0 push @groups, \@idx;
190 }
191 0 ▶ $bad = 1 unless $split;
Branch: 2 branches
BranchTrueFalseTotal
unless $split 4 2824 2828
unless $split 0 0 0
192 0 return (\@items, !$bad, \@groups);
193 }
194  
195 1000 ▶sub signatures_data {
Subroutine signatures_data: called CC=3 SCAR=17.0
Pod documented
196 0 ▶ my $self = shift;
Subroutine signatures_data: not called CC=3 SCAR=17.0
Pod documented
197 0 my $s = $self->get_tag('s');
198 0 ▶ return unless defined $s && length $s;
Branch: 2 branches
BranchTrueFalseTotal
unless defined $s and length $s 0 1000 1000
unless defined $s and length $s 0 0 0
Condition16%1/6
defined $s and length $s
!ll&&!rl&&r
001000
defined $s and length $s
!ll&&!rl&&r
000
MC/DC0%0/2
defined $s and length $s
defined $s length $s
MC/DC0%0/2
defined $s and length $s
defined $s length $s
Truth table33%1/3
A and B
A= defined $sB= length $s
ABresult
0X0
100
111
Truth table0%0/3
A and B
A= defined $sB= length $s
ABresult
0X0
100
111
199 0 my ($items) = _parse_sig_items($s);
200 0 return $items;
201 }
202  
203 # The s= groups (-09 §10.9): an arrayref of the "|" groups, each an arrayref
204 # of the indices of its ","-joined items, as selector() and friends take.
205 795 ▶sub sig_groups {
Subroutine sig_groups: called CC=3 SCAR=17.0
Pod documented
206 0 ▶ my $self = shift;
Subroutine sig_groups: not called CC=3 SCAR=17.0
Pod documented
207 0 my $s = $self->get_tag('s');
208 0 ▶ return [] unless defined $s && length $s;
Branch: 2 branches
BranchTrueFalseTotal
unless defined $s and length $s 0 795 795
unless defined $s and length $s 0 0 0
Condition16%1/6
defined $s and length $s
!ll&&!rl&&r
00795
defined $s and length $s
!ll&&!rl&&r
000
MC/DC0%0/2
defined $s and length $s
defined $s length $s
MC/DC0%0/2
defined $s and length $s
defined $s length $s
Truth table33%1/3
A and B
A= defined $sB= length $s
ABresult
0X0
100
111
Truth table0%0/3
A and B
A= defined $sB= length $s
ABresult
0X0
100
111
209 0 my (undef, undef, $groups) = _parse_sig_items($s);
210 0 return $groups;
211 }
212  
213 # Malformed anywhere: the tag list itself (TagValueList), or an s= item.
214 1038 ▶sub syntax_error {
Subroutine syntax_error: called CC=3 SCAR=15.0
Pod documented
215 0 ▶ my ($self) = @_;
Subroutine syntax_error: not called CC=3 SCAR=15.0
Pod documented
216 0 ▶ return 1 if $self->SUPER::syntax_error;
Branch: 2 branches
BranchTrueFalseTotal
if $self->SUPER::syntax_error 5 1033 1038
if $self->SUPER::syntax_error 0 0 0
217 0 my $s = $self->get_tag('s');
218 0 ▶ return 0 unless defined $s;
Branch: 2 branches
BranchTrueFalseTotal
unless defined $s 0 1033 1033
unless defined $s 0 0 0
219 0 my (undef, $ok) = _parse_sig_items($s);
220 0 return !$ok;
221 }
222  
223 # --- Envelope accessors (mf= and rt= tags) ---
224  
225 # mf= and rt= are base64-encoded RFC 5321 paths; both are excluded by nd=
226 # (§10.7), which marks an imaginary forwarding hop with no envelope of its
227 # own. Setting either on an nd= signature is therefore a caller error.
228 7 ▶sub _croak_if_nd {
Subroutine _croak_if_nd: called CC=2 SCAR=9.2
229 0 ▶ my ($self, $tag) = @_;
Subroutine _croak_if_nd: not called CC=2 SCAR=9.2
230 0 ▶ croak "cannot set $tag= on a signature carrying nd= (-09 §10.7)"
Branch: 2 branches
BranchTrueFalseTotal
if defined $self->get_tag("nd") 2 5 7
if defined $self->get_tag("nd") 0 0 0
231 if defined $self->get_tag('nd');
232 }
233  
234 1956 ▶sub mail_from {
Subroutine mail_from: called CC=3 SCAR=14.2
Pod documented
235 0 ▶ my $self = shift;
Subroutine mail_from: not called CC=3 SCAR=14.2
Pod documented
236 0 ▶ if (@_) {
Branch: 2 branches
BranchTrueFalseTotal
if (@_) 3 1953 1956
if (@_) 0 0 0
237 0 $self->_croak_if_nd('mf');
238 0 $self->set_tag('mf', encode_base64(_path(shift), ''));
239 }
240 0 my $mf = $self->get_tag('mf');
241 0 ▶ return unless defined $mf;
Branch: 2 branches
BranchTrueFalseTotal
unless defined $mf 111 1844 1955
unless defined $mf 0 0 0
242 0 return decode_base64($mf);
243 }
244  
245 # rt= is the only tag that differs between recipients of the same message.
246 # §12.8 signs solely the Message-Instance and DKIM2-Signature header fields, so
247 # the body hash, the header-fields hash and the Message-Instance are all
248 # recipient-invariant: re-signing for another recipient means changing this tag
249 # and nothing else. See Mail::DKIM2::Signer::sign_for_recipient. Takes one
250 # address or an arrayref of them; always returns an arrayref.
251 1394 ▶sub rcpt_to {
Subroutine rcpt_to: called CC=5 SCAR=20.9
Pod documented
252 0 ▶ my $self = shift;
Subroutine rcpt_to: not called CC=5 SCAR=20.9
Pod documented
253 0 ▶ if (@_) {
Branch: 2 branches
BranchTrueFalseTotal
if (@_) 4 1390 1394
if (@_) 0 0 0
254 0 $self->_croak_if_nd('rt');
255 0 my $rcpt = shift;
256 0 ▶ my @list = ref $rcpt eq 'ARRAY' ? @$rcpt : ($rcpt);
Branch: 2 branches
BranchTrueFalseTotal
ref $rcpt eq 'ARRAY' ? : 2 1 3
ref $rcpt eq 'ARRAY' ? : 0 0 0
257 0 ▶ croak "rcpt_to requires at least one recipient" unless @list;
Branch: 2 branches
BranchTrueFalseTotal
unless @list 1 2 3
unless @list 0 0 0
258 $self->set_tag('rt',
259 0 join(',', map { encode_base64(_path($_), '') } @list));
260 }
261 0 my $rt = $self->get_tag('rt');
262 0 ▶ return unless defined $rt;
Branch: 2 branches
BranchTrueFalseTotal
unless defined $rt 70 1322 1392
unless defined $rt 0 0 0
263 0 return [map { decode_base64($_) } split /,/, $rt];
264 }
265  
266 # --- Convenience methods for signature items ---
267  
268 # The s= items, parsed once per s= value: selector(), algorithm() and
269 # signature_value() take an index, and the verifier calls them for every
270 # item, so reparsing the whole list each time was quadratic in its length
271 # (review R1). The cache is keyed on the raw value, so set_tag('s', ...)
272 # invalidates it.
273 12799 ▶sub _sig_items {
Subroutine _sig_items: called CC=5 SCAR=23.0
274 0 ▶ my ($self) = @_;
Subroutine _sig_items: not called CC=5 SCAR=23.0
275 0 my $s = $self->get_tag('s');
276 0 my $c = $self->{_sig_cache};
277 0 ▶ return $c->[1] if $c && defined $s && defined $c->[0] && $c->[0] eq $s;
Branch: 2 branches
BranchTrueFalseTotal
if $c and defined $s and defined $c->[0] and $c->[0] eq $s 11800 999 12799
if $c and defined $s and defined $c->[0] and $c->[0] eq $s 0 0 0
Condition33%6/18
$c and defined $s and defined $c->[0] and $c->[0] eq $s
!ll&&!rl&&r
999011800
$c and defined $s and defined $c->[0]
!ll&&!rl&&r
999011800
$c and defined $s
!ll&&!rl&&r
999011800
$c and defined $s and defined $c->[0] and $c->[0] eq $s
!ll&&!rl&&r
000
$c and defined $s and defined $c->[0]
!ll&&!rl&&r
000
$c and defined $s
!ll&&!rl&&r
000
MC/DC25%1/4
$c and defined $s and defined $c->[0] and $c->[0] eq $s
$c defined $s defined $c->[0] $c->[0] eq $s
MC/DC0%0/4
$c and defined $s and defined $c->[0] and $c->[0] eq $s
$c defined $s defined $c->[0] $c->[0] eq $s
Truth table40%2/5
A and B and C and D
A= $cB= defined $sC= defined $c->[0]D= $c->[0] eq $s
ABCDresult
0XXX0
10XX0
110X0
11100
11111
Truth table0%0/5
A and B and C and D
A= $cB= defined $sC= defined $c->[0]D= $c->[0] eq $s
ABCDresult
0XXX0
10XX0
110X0
11100
11111
278 0 my $items = $self->signatures_data;
279 0 $self->{_sig_cache} = [$s, $items];
280 0 return $items;
281 }
282  
283 1830 ▶sub selector {
Subroutine selector: called CC=4 SCAR=21.7
Pod documented
284 0 ▶ my ($self, $idx) = @_;
Subroutine selector: not called CC=4 SCAR=21.7
Pod documented
285 0 ▶ $idx //= 0;
Condition25%1/4
$idx //= 0
l!l
18300
$idx //= 0
l!l
00
MC/DC0%0/1
$idx //= 0
$idx
MC/DC0%0/1
$idx //= 0
$idx
Truth table50%1/2
A
A= $idx
Aresult
11
00
Truth table0%0/2
A
A= $idx
Aresult
11
00
286 0 my $sigs = $self->_sig_items;
287 0 ▶ return unless $sigs && $sigs->[$idx];
Branch: 2 branches
BranchTrueFalseTotal
unless $sigs and $sigs->[$idx] 0 1830 1830
unless $sigs and $sigs->[$idx] 0 0 0
Condition16%1/6
$sigs and $sigs->[$idx]
!ll&&!rl&&r
001830
$sigs and $sigs->[$idx]
!ll&&!rl&&r
000
MC/DC0%0/2
$sigs and $sigs->[$idx]
$sigs $sigs->[$idx]
MC/DC0%0/2
$sigs and $sigs->[$idx]
$sigs $sigs->[$idx]
Truth table33%1/3
A and B
A= $sigsB= $sigs->[$idx]
ABresult
0X0
100
111
Truth table0%0/3
A and B
A= $sigsB= $sigs->[$idx]
ABresult
0X0
100
111
288 0 return $sigs->[$idx][SIG_SELECTOR];
289 }
290  
291 1108 ▶sub algorithm {
Subroutine algorithm: called CC=4 SCAR=20.7
Pod documented
292 0 ▶ my ($self, $idx) = @_;
Subroutine algorithm: not called CC=4 SCAR=20.7
Pod documented
293 0 ▶ $idx //= 0;
Condition50%2/4
$idx //= 0
l!l
11053
$idx //= 0
l!l
00
MC/DC100%1/1
$idx //= 0
$idx
MC/DC0%0/1
$idx //= 0
$idx
Truth table100%2/2
A
A= $idx
Aresult
11
00
Truth table0%0/2
A
A= $idx
Aresult
11
00
294 0 my $sigs = $self->_sig_items;
295 0 ▶ return unless $sigs && $sigs->[$idx];
Branch: 2 branches
BranchTrueFalseTotal
unless $sigs and $sigs->[$idx] 0 1108 1108
unless $sigs and $sigs->[$idx] 0 0 0
Condition16%1/6
$sigs and $sigs->[$idx]
!ll&&!rl&&r
001108
$sigs and $sigs->[$idx]
!ll&&!rl&&r
000
MC/DC0%0/2
$sigs and $sigs->[$idx]
$sigs $sigs->[$idx]
MC/DC0%0/2
$sigs and $sigs->[$idx]
$sigs $sigs->[$idx]
Truth table33%1/3
A and B
A= $sigsB= $sigs->[$idx]
ABresult
0X0
100
111
Truth table0%0/3
A and B
A= $sigsB= $sigs->[$idx]
ABresult
0X0
100
111
296 0 return $sigs->[$idx][SIG_ALGORITHM];
297 }
298  
299 6008 ▶sub signature_value {
Subroutine signature_value: called CC=4 SCAR=21.7
Pod documented
300 0 ▶ my ($self, $idx) = @_;
Subroutine signature_value: not called CC=4 SCAR=21.7
Pod documented
301 0 ▶ $idx //= 0;
Condition25%1/4
$idx //= 0
l!l
60080
$idx //= 0
l!l
00
MC/DC0%0/1
$idx //= 0
$idx
MC/DC0%0/1
$idx //= 0
$idx
Truth table50%1/2
A
A= $idx
Aresult
11
00
Truth table0%0/2
A
A= $idx
Aresult
11
00
302 0 my $sigs = $self->_sig_items;
303 0 ▶ return unless $sigs && $sigs->[$idx];
Branch: 2 branches
BranchTrueFalseTotal
unless $sigs and $sigs->[$idx] 0 6008 6008
unless $sigs and $sigs->[$idx] 0 0 0
Condition16%1/6
$sigs and $sigs->[$idx]
!ll&&!rl&&r
006008
$sigs and $sigs->[$idx]
!ll&&!rl&&r
000
MC/DC0%0/2
$sigs and $sigs->[$idx]
$sigs $sigs->[$idx]
MC/DC0%0/2
$sigs and $sigs->[$idx]
$sigs $sigs->[$idx]
Truth table33%1/3
A and B
A= $sigsB= $sigs->[$idx]
ABresult
0X0
100
111
Truth table0%0/3
A and B
A= $sigsB= $sigs->[$idx]
ABresult
0X0
100
111
304 0 return $sigs->[$idx][SIG_VALUE];
305 }
306  
307 # --- Serialization ---
308  
309 # The field, unfolded.
310 4 ▶sub as_string {
Subroutine as_string: called CC=1 SCAR=1.2
Pod documented
311 0 ▶ my ($self) = @_;
Subroutine as_string: not called CC=1 SCAR=1.2
Pod documented
312 0 return "DKIM2-Signature: " . $self->SUPER::as_string();
313 }
314  
315 # The field folded for insertion into a message, s= last. Where it folds
316 # is not part of what is signed (§12.8 deletes all WSP from the signing
317 # input); fold_header only folds where the grammar allows FWS.
318 1518 ▶sub as_folded_string {
Subroutine as_folded_string: called CC=4 SCAR=18.7
Pod documented
319 0 ▶ my ($self) = @_;
Subroutine as_folded_string: not called CC=4 SCAR=18.7
Pod documented
320  
321 0 my @parts;
322 0 for my $t (@{$self->{order}}) {
323 0 ▶ next if $t eq 's';
Branch: 2 branches
BranchTrueFalseTotal
if $t eq "s" 1518 9073 10591
if $t eq "s" 0 0 0
324 0 push @parts, "$t=$self->{tags}{$t}";
325 }
326 0 ▶ my $s_val = $self->{tags}{s} // '';
Condition25%1/4
$self->{"tags"}{"s"} // ""
l!l
15180
$self->{"tags"}{"s"} // ""
l!l
00
MC/DC0%0/1
$self->{"tags"}{"s"} // ""
$self->{"tags"}{"s"}
MC/DC0%0/1
$self->{"tags"}{"s"} // ""
$self->{"tags"}{"s"}
Truth table50%1/2
A
A= $self->{"tags"}{"s"}
Aresult
11
00
Truth table0%0/2
A
A= $self->{"tags"}{"s"}
Aresult
11
00
327 0 my $line = "DKIM2-Signature: " . join('; ', @parts) . "; s=$s_val;";
328 0 return fold_header($line);
329 }
330  
331 2932 ▶sub sig_count {
Subroutine sig_count: called CC=2 SCAR=10.3
Pod documented
332 0 ▶ my ($self) = @_;
Subroutine sig_count: not called CC=2 SCAR=10.3
Pod documented
333 0 my $sigs = $self->_sig_items;
334 0 ▶ return 0 unless $sigs;
Branch: 2 branches
BranchTrueFalseTotal
unless $sigs 0 2932 2932
unless $sigs 0 0 0
335 0 return scalar @$sigs;
336 }
337  
338 # -09 §10.9 duplicate rule for one DKIM2-Signature s= tag: a Selector MUST
339 # NOT appear more than once, in any group. The same algorithm may appear any
340 # number of times with distinct Selectors (-08 dropped -07's limit of two).
341 # Selectors match without regard to case: a Selector is a Domain (§3.6).
342 #
343 # Returns a list of PERMERROR strings (empty if clean).
344 921 ▶sub check_duplicates {
Subroutine check_duplicates: called CC=6 SCAR=26.7
Pod documented
345 0 ▶ my ($self) = @_;
Subroutine check_duplicates: not called CC=6 SCAR=26.7
Pod documented
346 0 my $sigs = $self->_sig_items;
347 0 ▶ return () unless $sigs && @$sigs;
Branch: 2 branches
BranchTrueFalseTotal
unless $sigs and @$sigs 0 921 921
unless $sigs and @$sigs 0 0 0
Condition16%1/6
$sigs and @$sigs
!ll&&!rl&&r
00921
$sigs and @$sigs
!ll&&!rl&&r
000
MC/DC0%0/2
$sigs and @$sigs
$sigs @$sigs
MC/DC0%0/2
$sigs and @$sigs
$sigs @$sigs
Truth table33%1/3
A and B
A= $sigsB= @$sigs
ABresult
0X0
100
111
Truth table0%0/3
A and B
A= $sigsB= @$sigs
ABresult
0X0
100
111
348  
349 0 my %sel_count;
350 0 ▶ $sel_count{lc($_->[SIG_SELECTOR] // '')}++ for @$sigs;
Condition25%1/4
$_->[0] // ""
l!l
52120
$_->[0] // ""
l!l
00
MC/DC0%0/1
$_->[0] // ""
$_->[0]
MC/DC0%0/1
$_->[0] // ""
$_->[0]
Truth table50%1/2
A
A= $_->[0]
Aresult
11
00
Truth table0%0/2
A
A= $_->[0]
Aresult
11
00
351 0 ▶ return () unless grep { $_ > 1 } values %sel_count;
Branch: 2 branches
BranchTrueFalseTotal
unless grep {$_ > 1;} values %sel_count 914 7 921
unless grep {$_ > 1;} values %sel_count 0 0 0
352 0 return "PERMERROR: DKIM2-Signature i=" . $self->sequence . " has a duplicate selector";
353 }
354  
355 186 1;
356  
357 __END__
« lib/Mail/DKIM2/Common.pm ↑ Summary lib/Mail/DKIM2/Chain.pm »