lib/Crypt/Perl/RSA/PKCS1_v1_5.pm

filter: Statementstmt 97.7% 43 / 44 Branchbran 75.0% 3 / 4 Conditioncond n/a MC/DCmcdc n/a Subroutinesub 100% 13 / 13 Podpod 0.0% 0 / 2 totaltotal 93.6% 59 / 63 CC 3 SCAR 2.4
CC
3
Cov
96%
encode
2.1
decode
2.0
BEGIN
1.0
CRAP 1.3
« lib/Crypt/Perl/RSA/KeyBase.pm ↑ Summary lib/Crypt/Perl/X509/Extension/subjectKeyIdentifier.pm »
1 package Crypt::Perl::RSA::PKCS1_v1_5;
2  
3 =encoding utf-8
4  
5 =head1 NAME
6  
7 Crypt::Perl::RSA::PKCS1_v1_5 - PKCS1 v1.5 signature padding
8  
9 =head1 SYNOPSIS
10  
11 my $digest = Digest::SHA::sha256('This is my message.');
12  
13 my $sig = Crypt::Perl::RSA::PKCS1_v1_5::encode(
14 $digest,
15 'sha256', #digest OID; see below
16 2048, #the bit length of the key’s modulus
17 );
18  
19 #This value should match $digest.
20 my $digest_dec = Crypt::Perl::RSA::PKCS1_v1_5::decode(
21 $sig,
22 'sha256',
23 );
24  
25 =head1 LIST OF DIGEST OIDs
26  
27 =over 4
28  
29 =item * sha512
30  
31 =item * sha384
32  
33 =item * sha256
34  
35 =back
36  
37 The following are considered too weak for good security now;
38 they’re included for historical interest.
39  
40 =over 4
41  
42 =item * sha1
43  
44 =item * md5
45  
46 =item * md2
47  
48 =back
49  
50 =cut
51  
52 4 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
53 4 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
54  
55 4 ▶use Crypt::Perl::X ();
Subroutine BEGIN: called CC=1 SCAR=0.0
56  
57 #----------------------------------------------------------------------
58 #RFC 3447, page 42
59  
60 #These are too weak for modern hardware, but we’ll include them anyway.
61 4 ▶use constant DER_header_md2 => "\x30\x20\x30\x0c\x06\x08\x2a\x86\x48\x86\xf7\x0d\x02\x02\x05\x00\x04\x10";
Subroutine BEGIN: called CC=1 SCAR=0.0
62 4 ▶use constant DER_header_md5 => "\x30\x20\x30\x0c\x06\x08\x2a\x86\x48\x86\xf7\x0d\x02\x05\x05\x00\x04\x10";
Subroutine BEGIN: called CC=1 SCAR=0.0
63 4 ▶use constant DER_header_sha1 => "\x30\x21\x30\x09\x06\x05\x2b\x0e\x03\x02\x1a\x05\x00\x04\x14";
Subroutine BEGIN: called CC=1 SCAR=0.0
64  
65  
66 #As of December 2016, the following are considered safe for general use.
67 4 ▶use constant DER_header_sha256 => "\x30\x31\x30\x0d\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x01\x05\x00\x04\x20";
Subroutine BEGIN: called CC=1 SCAR=0.0
68 4 ▶use constant DER_header_sha384 => "\x30\x41\x30\x0d\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x02\x05\x00\x04\x30";
Subroutine BEGIN: called CC=1 SCAR=0.0
69 4 ▶use constant DER_header_sha512 => "\x30\x51\x30\x0d\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x03\x05\x00\x04\x40";
Subroutine BEGIN: called CC=1 SCAR=0.0
70 #----------------------------------------------------------------------
71  
72 #RFC 3447, section 9.2
73 sub encode {
74 268 ▶ my ($digest, $digest_oid, $emLen) = @_;
Subroutine encode: called CC=2 SCAR=7.2
Pod undocumented
75  
76 #print "encoding: [$digest_oid]\n";
77 268 my $encoded = _asn1_DigestInfo( $digest, $digest_oid );
78  
79 268 ▶ if ( $emLen < length($encoded) + 11 ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($emLen < length($encoded) + 11) 0 268 268
80 0 die Crypt::Perl::X::create('Generic', sprintf "intended encoded message length (%d bytes) is too short--must be at least %d bytes", $emLen, 11 + length $encoded);
81 }
82  
83 #NB: The length of $encoded will be a function solely of $digest_oid.
84  
85 268 my $PS = "\x{ff}" x ($emLen - length($encoded) - 3);
86  
87 268 return "\0\1$PS\0$encoded";
88 }
89  
90 #Assume that we already validated the length.
91 sub decode {
92 580 ▶ my ($octets, $digest_oid) = @_;
Subroutine decode: called CC=2 SCAR=6.9
Pod undocumented
93  
94 #printf "$digest_oid - %v02x\n", $octets;
95  
96 580 my $hdr = _get_der_header($digest_oid);
97  
98 580 ▶ $octets =~ m<\A \x00 \x01 \xff+ \x00 \Q$hdr\E >x or do {
Branch: 1 branch
BranchTrueFalseTotal
$octets =~ /\A \x00 \x01 \xff+ \x00 \Q$hdr\E /x or do { my $err = sprintf("Invalid EMSA-PKCS1-v1_5/${digest_oid}: %v02x", $octets); die Crypt::Perl::X::create("Generic", $err) } 56 524 580
99 56 my $err = sprintf "Invalid EMSA-PKCS1-v1_5/$digest_oid: %v02x", $octets;
100 56 die Crypt::Perl::X::create('Generic', $err);
101 };
102  
103 524 return substr( $octets, $+[0] );
104 }
105  
106 sub _get_der_header {
107 848 ▶ my ($oid) = @_;
Subroutine _get_der_header: called CC=1 SCAR=0.0
108  
109 848 return __PACKAGE__->can("DER_header_$oid")->();
110 }
111  
112 sub _asn1_DigestInfo {
113 268 ▶ my ($digest, $oid) = @_;
Subroutine _asn1_DigestInfo: called CC=1 SCAR=0.0
114  
115 268 return _get_der_header($oid) . $digest;
116 }
117  
118 #sub _asn1_DigestInfo {
119 # my ($digest, $algorithm_oid) = @_;
120 #
121 # #We shouldn’t need Convert::ASN1 for this.
122 # my $asn1 = Crypt::Sign::RSA::Convert_ASN1->new();
123 # $asn1->prepare_or_die(
124 # q<
125 # AlgorithmIdentifier ::= SEQUENCE {
126 # algorithm OBJECT IDENTIFIER,
127 # parameters NULL
128 # }
129 #
130 # DigestInfo ::= SEQUENCE {
131 # alg AlgorithmIdentifier,
132 # digest OCTET STRING
133 # }
134 # >,
135 # );
136 #
137 # my $parser = $asn1->find_or_die('DigestInfo');
138 #
139 # return $parser->encode_or_die(
140 # digest => $digest,
141 #
142 # #RFC 3447 says to use “sha256WithRSAEncryption”, but
143 # #OpenSSL’s RSA_sign() uses just “sha256”. (??)
144 # alg => { algorithm => $algorithm_oid, parameters => 1 },
145 # );
146 #}
147  
148 4 1;
« lib/Crypt/Perl/RSA/KeyBase.pm ↑ Summary lib/Crypt/Perl/X509/Extension/subjectKeyIdentifier.pm »