| 1 | package Mail::BIMI::VMC::Chain; | ||||||||||||||||||||||||||||
| 2 | # ABSTRACT: Class to model a VMC Chain | ||||||||||||||||||||||||||||
| 3 | 29 | our $VERSION = '3.20260302'; # VERSION | |||||||||||||||||||||||||||
| 4 | 29 | ▶ | use 5.20.0; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 5 | 29 | ▶ | use Moose; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 6 | 29 | ▶ | use Mail::BIMI::Prelude; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 7 | 29 | ▶ | use Mail::BIMI::VMC::Cert; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 8 | 29 | ▶ | use Crypt::OpenSSL::X509 1.812; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 9 | 29 | ▶ | use Crypt::OpenSSL::Verify 0.20; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 10 | 29 | ▶ | use File::Slurp qw{ read_file write_file }; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 11 | 29 | ▶ | use File::Temp; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 12 | 29 | ▶ | use Mozilla::CA; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 13 | 29 | ▶ | use Term::ANSIColor qw{ :constants }; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 14 | |||||||||||||||||||||||||||||
| 15 | 29 | extends 'Mail::BIMI::Base'; | |||||||||||||||||||||||||||
| 16 | 29 | with( | |||||||||||||||||||||||||||
| 17 | 'Mail::BIMI::Role::Data', | ||||||||||||||||||||||||||||
| 18 | 'Mail::BIMI::Role::HasError', | ||||||||||||||||||||||||||||
| 19 | ); | ||||||||||||||||||||||||||||
| 20 | 29 | has cert_list => ( is => 'rw', isa => 'ArrayRef', | |||||||||||||||||||||||||||
| 21 | documentation => 'ArrayRef of individual Certificates in the chain' ); | ||||||||||||||||||||||||||||
| 22 | 29 | has cert_object_list => ( is => 'rw', isa => 'ArrayRef', lazy => 1, builder => '_build_cert_object_list', | |||||||||||||||||||||||||||
| 23 | documentation => 'ArrayRef of Crypt::OpenSSL::X509 objects for the Certificates in the chain' ); | ||||||||||||||||||||||||||||
| 24 | 29 | has is_valid => ( is => 'rw', lazy => 1, builder => '_build_is_valid', | |||||||||||||||||||||||||||
| 25 | documentation => 'Does the VMC of this chain validate back to root?' ); | ||||||||||||||||||||||||||||
| 26 | |||||||||||||||||||||||||||||
| 27 | |||||||||||||||||||||||||||||
| 28 | ▶ | sub _default_root_certs($self) { | |||||||||||||||||||||||||||
|
Subroutine
_default_root_certs: not called CC=2 SCAR=17.9
| |||||||||||||||||||||||||||||
| 29 | 0 | my @ca; | |||||||||||||||||||||||||||
| 30 | 0 | my $manifest = $self->get_data_from_file('CA.manifest'); | |||||||||||||||||||||||||||
| 31 | 0 | for my $ca_file (split "\n", $manifest) { | |||||||||||||||||||||||||||
| 32 | 0 | push @ca, $self->get_data_from_file("CA/$ca_file"); | |||||||||||||||||||||||||||
| 33 | } | ||||||||||||||||||||||||||||
| 34 | 0 | return join "\n", @ca; | |||||||||||||||||||||||||||
| 35 | } | ||||||||||||||||||||||||||||
| 36 | |||||||||||||||||||||||||||||
| 37 | ▶ | sub _build_is_valid($self) { | |||||||||||||||||||||||||||
|
Subroutine
_build_is_valid: not called CC=20 SCAR=60.4
| |||||||||||||||||||||||||||||
| 38 | # Start with root cert validations | ||||||||||||||||||||||||||||
| 39 | 0 | ▶ | return 0 if !$self->vmc; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 40 | |||||||||||||||||||||||||||||
| 41 | 0 | my $ssl_root_cert = $self->bimi_object->options->ssl_root_cert; | |||||||||||||||||||||||||||
| 42 | 0 | my $unlink_root_cert_file = 0; | |||||||||||||||||||||||||||
| 43 | 0 | ▶ | if ( !$ssl_root_cert ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 44 | 0 | my $mozilla_root = scalar read_file Mozilla::CA::SSL_ca_file; | |||||||||||||||||||||||||||
| 45 | 0 | state $bimi_root = $self->_default_root_certs; | |||||||||||||||||||||||||||
| 46 | 0 | my $temp_fh = File::Temp->new(UNLINK=>0); | |||||||||||||||||||||||||||
| 47 | 0 | $ssl_root_cert = $temp_fh->filename; | |||||||||||||||||||||||||||
| 48 | 0 | $unlink_root_cert_file = 1; | |||||||||||||||||||||||||||
| 49 | 0 | print $temp_fh join("\n",$mozilla_root,$bimi_root); | |||||||||||||||||||||||||||
| 50 | 0 | close $temp_fh; | |||||||||||||||||||||||||||
| 51 | } | ||||||||||||||||||||||||||||
| 52 | |||||||||||||||||||||||||||||
| 53 | 0 | my $root_ca = Crypt::OpenSSL::Verify->new($ssl_root_cert,{noCApath=>0,strict_certs=>0}); | |||||||||||||||||||||||||||
| 54 | 0 | my $root_ca_ascii = scalar read_file $ssl_root_cert; | |||||||||||||||||||||||||||
| 55 | 0 | foreach my $cert ( $self->cert_object_list->@* ) { | |||||||||||||||||||||||||||
| 56 | 0 | my $i = $cert->index; | |||||||||||||||||||||||||||
| 57 | 0 | ▶ | if ($cert->is_expired) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 58 | 0 | $self->log_verbose("Certificate $i is expired"); | |||||||||||||||||||||||||||
| 59 | 0 | next; | |||||||||||||||||||||||||||
| 60 | } | ||||||||||||||||||||||||||||
| 61 | 0 | ▶ | if ( !$cert->is_valid ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 62 | 0 | $self->log_verbose("Certificate $i is not valid"); | |||||||||||||||||||||||||||
| 63 | 0 | next; | |||||||||||||||||||||||||||
| 64 | } | ||||||||||||||||||||||||||||
| 65 | 0 | ▶ | if ( !$cert->has_valid_usage ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 66 | 0 | $self->log_verbose("Certificate $i does not have valid usage flags for BIMI"); | |||||||||||||||||||||||||||
| 67 | 0 | next; | |||||||||||||||||||||||||||
| 68 | } | ||||||||||||||||||||||||||||
| 69 | 0 | my $is_valid = 0; | |||||||||||||||||||||||||||
| 70 | 0 | eval { | |||||||||||||||||||||||||||
| 71 | 0 | $root_ca->verify($cert->x509_object); | |||||||||||||||||||||||||||
| 72 | 0 | $is_valid = 1; | |||||||||||||||||||||||||||
| 73 | }; | ||||||||||||||||||||||||||||
| 74 | 0 | ▶ | if ( !$is_valid ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 75 | 0 | $self->log_verbose("Certificate $i not directly validated to root"); | |||||||||||||||||||||||||||
| 76 | # NOP | ||||||||||||||||||||||||||||
| 77 | } | ||||||||||||||||||||||||||||
| 78 | else { | ||||||||||||||||||||||||||||
| 79 | 0 | $self->log_verbose("Certificate $i directly validated to root"); | |||||||||||||||||||||||||||
| 80 | 0 | $cert->validated_by($root_ca_ascii); | |||||||||||||||||||||||||||
| 81 | 0 | $cert->validated_by_id(0); | |||||||||||||||||||||||||||
| 82 | 0 | $cert->is_valid_to_root(1); | |||||||||||||||||||||||||||
| 83 | } | ||||||||||||||||||||||||||||
| 84 | } | ||||||||||||||||||||||||||||
| 85 | |||||||||||||||||||||||||||||
| 86 | 0 | my $iteration_did_no_work; | |||||||||||||||||||||||||||
| 87 | 0 | ▶ | do { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 88 | 0 | $iteration_did_no_work = 1; | |||||||||||||||||||||||||||
| 89 | VALIDATED_CERT: | ||||||||||||||||||||||||||||
| 90 | 0 | foreach my $validated_cert ( $self->cert_object_list->@* ) { | |||||||||||||||||||||||||||
| 91 | 0 | ▶ | next VALIDATED_CERT if ! $validated_cert->is_valid_to_root; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 92 | 0 | my $validated_i = $validated_cert->index; | |||||||||||||||||||||||||||
| 93 | VALIDATING_CERT: | ||||||||||||||||||||||||||||
| 94 | 0 | foreach my $validating_cert ( $self->cert_object_list->@* ) { | |||||||||||||||||||||||||||
| 95 | 0 | ▶ | next VALIDATING_CERT if $validating_cert->is_valid_to_root; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 96 | 0 | my $validating_i = $validating_cert->index; | |||||||||||||||||||||||||||
| 97 | 0 | ▶ | if ($validating_cert->is_expired) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 98 | 0 | $self->log_verbose("Certificate $validating_i is expired"); | |||||||||||||||||||||||||||
| 99 | 0 | next; | |||||||||||||||||||||||||||
| 100 | } | ||||||||||||||||||||||||||||
| 101 | 0 | ▶ | if ( !$validating_cert->is_valid ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 102 | 0 | $self->log_verbose("Certificate $validating_i is not valid"); | |||||||||||||||||||||||||||
| 103 | 0 | next VALIDATING_CERT; | |||||||||||||||||||||||||||
| 104 | } | ||||||||||||||||||||||||||||
| 105 | 0 | eval{ | |||||||||||||||||||||||||||
| 106 | 0 | $validated_cert->verifier->verify($validating_cert->x509_object); | |||||||||||||||||||||||||||
| 107 | 0 | $self->log_verbose("Certificate $validating_i validated to root via certificate $validated_i"); | |||||||||||||||||||||||||||
| 108 | 0 | $validating_cert->validated_by($validated_cert->full_chain); | |||||||||||||||||||||||||||
| 109 | 0 | $validating_cert->validated_by_id($validated_i); | |||||||||||||||||||||||||||
| 110 | 0 | $validating_cert->is_valid_to_root(1); | |||||||||||||||||||||||||||
| 111 | 0 | $iteration_did_no_work = 0; | |||||||||||||||||||||||||||
| 112 | }; | ||||||||||||||||||||||||||||
| 113 | } | ||||||||||||||||||||||||||||
| 114 | } | ||||||||||||||||||||||||||||
| 115 | } until $iteration_did_no_work; | ||||||||||||||||||||||||||||
| 116 | 0 | ▶ | if ( !$self->vmc->is_valid_to_root ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 117 | 0 | $self->add_error('VMC_PARSE_ERROR','Could not verify VMC'); | |||||||||||||||||||||||||||
| 118 | } | ||||||||||||||||||||||||||||
| 119 | |||||||||||||||||||||||||||||
| 120 | 0 | ▶ | if ( $unlink_root_cert_file && -f $ssl_root_cert ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$unlink_root_cert_file and -f $ssl_root_cert
MC/DC0%0/2
$unlink_root_cert_file and -f $ssl_root_cert
$unlink_root_cert_file
-f $ssl_root_cert
Truth table0%0/3
A and B
A= $unlink_root_cert_fileB= -f $ssl_root_cert
| |||||||||||||||||||||||||||||
| 121 | 0 | ▶ | unlink $ssl_root_cert or warn "Unable to unlink temporary chain file: $!"; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 122 | } | ||||||||||||||||||||||||||||
| 123 | |||||||||||||||||||||||||||||
| 124 | 0 | ▶ | return 0 if $self->errors->@*; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 125 | 0 | return 1; | |||||||||||||||||||||||||||
| 126 | } | ||||||||||||||||||||||||||||
| 127 | |||||||||||||||||||||||||||||
| 128 | |||||||||||||||||||||||||||||
| 129 | ▶ | sub vmc($self) { | |||||||||||||||||||||||||||
|
Subroutine
vmc: not called CC=8 SCAR=42.8
Pod
documented
| |||||||||||||||||||||||||||||
| 130 | 0 | my $vmc; | |||||||||||||||||||||||||||
| 131 | 0 | foreach my $cert ( $self->cert_object_list->@* ) { | |||||||||||||||||||||||||||
| 132 | 0 | my $x509_object = $cert->x509_object; | |||||||||||||||||||||||||||
| 133 | 0 | ▶ | next if !$x509_object; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 134 | 0 | my $exts = eval{ $x509_object->extensions_by_oid() }; | |||||||||||||||||||||||||||
| 135 | 0 | ▶ | next if !$exts; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 136 | 0 | ▶ | if ( $cert->has_valid_usage && exists $exts->{&LOGOTYPE_OID()}) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$cert->has_valid_usage and exists $$exts{&LOGOTYPE_OID()}
MC/DC0%0/2
$cert->has_valid_usage and exists $$exts{&LOGOTYPE_OID()}
$cert->has_valid_usage
exists $$exts{&LOGOTYPE_OID()}
Truth table0%0/3
A and B
A= $cert->has_valid_usageB= exists $$exts{&LOGOTYPE_OID()}
| |||||||||||||||||||||||||||||
| 137 | # Has both extended usage and embedded Indicator | ||||||||||||||||||||||||||||
| 138 | 0 | ▶ | $self->add_error('VMC_VALIDATION_ERROR','Multiple VMCs found in chain') if $vmc; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 139 | 0 | $vmc = $cert; | |||||||||||||||||||||||||||
| 140 | } | ||||||||||||||||||||||||||||
| 141 | } | ||||||||||||||||||||||||||||
| 142 | 0 | ▶ | if ( !$vmc ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 143 | 0 | $self->add_error('VMC_VALIDATION_ERROR','No valid VMC found in chain'); | |||||||||||||||||||||||||||
| 144 | } | ||||||||||||||||||||||||||||
| 145 | 0 | return $vmc; | |||||||||||||||||||||||||||
| 146 | } | ||||||||||||||||||||||||||||
| 147 | |||||||||||||||||||||||||||||
| 148 | ▶ | sub _build_cert_object_list($self) { | |||||||||||||||||||||||||||
|
Subroutine
_build_cert_object_list: not called CC=2 SCAR=17.9
| |||||||||||||||||||||||||||||
| 149 | 0 | my @objects; | |||||||||||||||||||||||||||
| 150 | 0 | my $i = 1; | |||||||||||||||||||||||||||
| 151 | 0 | foreach my $cert ( $self->cert_list->@* ) { | |||||||||||||||||||||||||||
| 152 | 0 | push @objects, Mail::BIMI::VMC::Cert->new( | |||||||||||||||||||||||||||
| 153 | bimi_object => $self->bimi_object, | ||||||||||||||||||||||||||||
| 154 | chain => $self, | ||||||||||||||||||||||||||||
| 155 | ascii_lines => $cert, | ||||||||||||||||||||||||||||
| 156 | index => $i++, | ||||||||||||||||||||||||||||
| 157 | ); | ||||||||||||||||||||||||||||
| 158 | } | ||||||||||||||||||||||||||||
| 159 | 0 | return \@objects; | |||||||||||||||||||||||||||
| 160 | } | ||||||||||||||||||||||||||||
| 161 | |||||||||||||||||||||||||||||
| 162 | |||||||||||||||||||||||||||||
| 163 | ▶ | sub app_validate($self) { | |||||||||||||||||||||||||||
|
Subroutine
app_validate: not called CC=19 SCAR=59.4
Pod
documented
| |||||||||||||||||||||||||||||
| 164 | 0 | ▶ | say 'Certificate Chain Returned: '.($self->is_valid ? GREEN."\x{2713}" : BRIGHT_RED."\x{26A0}").RESET; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 165 | 0 | foreach my $cert ( $self->cert_object_list->@* ) { | |||||||||||||||||||||||||||
| 166 | 0 | my $i = $cert->index; | |||||||||||||||||||||||||||
| 167 | 0 | my $obj = $cert->x509_object; | |||||||||||||||||||||||||||
| 168 | 0 | say ''; | |||||||||||||||||||||||||||
| 169 | 0 | ▶ | say YELLOW.' Certificate '.$i.WHITE.': '.($cert->is_valid ? GREEN."\x{2713}" : BRIGHT_RED."\x{26A0}").RESET; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 170 | 0 | ▶ | if ( $obj ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 171 | 0 | ▶ | say YELLOW.' Subject '.WHITE.': '.CYAN.($obj->subject//'-none-').RESET; | ||||||||||||||||||||||||||
|
Condition0%0/2
$obj->subject // "-none-"
MC/DC0%0/1
$obj->subject // "-none-"
$obj->subject
Truth table0%0/2
A
A= $obj->subject
| |||||||||||||||||||||||||||||
| 172 | 0 | ▶ | say YELLOW.' Not Before '.WHITE.': '.CYAN.($obj->notBefore//'-none-').RESET; | ||||||||||||||||||||||||||
|
Condition0%0/2
$obj->notBefore // "-none-"
MC/DC0%0/1
$obj->notBefore // "-none-"
$obj->notBefore
Truth table0%0/2
A
A= $obj->notBefore
| |||||||||||||||||||||||||||||
| 173 | 0 | ▶ | say YELLOW.' Not After '.WHITE.': '.CYAN.($obj->notAfter//'-none-').RESET; | ||||||||||||||||||||||||||
|
Condition0%0/2
$obj->notAfter // "-none-"
MC/DC0%0/1
$obj->notAfter // "-none-"
$obj->notAfter
Truth table0%0/2
A
A= $obj->notAfter
| |||||||||||||||||||||||||||||
| 174 | 0 | ▶ | say YELLOW.' Issuer '.WHITE.': '.CYAN.($obj->issuer//'-none-').RESET; | ||||||||||||||||||||||||||
|
Condition0%0/2
$obj->issuer // "-none-"
MC/DC0%0/1
$obj->issuer // "-none-"
$obj->issuer
Truth table0%0/2
A
A= $obj->issuer
| |||||||||||||||||||||||||||||
| 175 | 0 | ▶ | say YELLOW.' Expired '.WHITE.': '.($obj->checkend(0)?BRIGHT_RED.'Yes':GREEN.'No').RESET; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 176 | 0 | ▶ | say YELLOW.' Experimental '.WHITE.': '.($cert->is_experimental?BRIGHT_RED.'Yes':GREEN.'No').RESET; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 177 | 0 | my $exts = eval{ $obj->extensions_by_oid() }; | |||||||||||||||||||||||||||
| 178 | 0 | ▶ | if ( $exts ) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 179 | 0 | ▶ | my $alt_name = exists $exts->{'2.5.29.17'} ? $exts->{'2.5.29.17'}->to_string : '-none-'; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 180 | 0 | ▶ | say YELLOW.' Alt Name '.WHITE.': '.CYAN.($alt_name//'-none-').RESET; | ||||||||||||||||||||||||||
|
Condition0%0/2
$alt_name // "-none-"
MC/DC0%0/1
$alt_name // "-none-"
$alt_name
Truth table0%0/2
A
A= $alt_name
| |||||||||||||||||||||||||||||
| 181 | 0 | ▶ | say YELLOW.' Has LogotypeExtn '.WHITE.': '.CYAN.(exists($exts->{&LOGOTYPE_OID()})?GREEN.'Yes':BRIGHT_RED.'No').RESET; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 182 | } | ||||||||||||||||||||||||||||
| 183 | else { | ||||||||||||||||||||||||||||
| 184 | 0 | say YELLOW.' Extensions '.WHITE.': '.BRIGHT_RED.'NOT FOUND'.RESET; | |||||||||||||||||||||||||||
| 185 | } | ||||||||||||||||||||||||||||
| 186 | 0 | ▶ | say YELLOW.' Has Valid Usage '.WHITE.': '.CYAN.($cert->has_valid_usage?GREEN.'Yes':BRIGHT_RED.'No').RESET; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 187 | } | ||||||||||||||||||||||||||||
| 188 | 0 | ▶ | say YELLOW.' Valid to Root '.WHITE.': '.CYAN.($cert->is_valid_to_root?GREEN.($cert->validated_by_id == 0?'Direct':'Via cert '.$cert->validated_by_id):BRIGHT_RED.'No').RESET; | ||||||||||||||||||||||||||
|
Branch: 2 branches
| |||||||||||||||||||||||||||||
| 189 | 0 | ▶ | say YELLOW.' Is Valid '.WHITE.': '.CYAN.($cert->is_valid?GREEN.'Yes':BRIGHT_RED.'No').RESET; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 190 | } | ||||||||||||||||||||||||||||
| 191 | } | ||||||||||||||||||||||||||||
| 192 | |||||||||||||||||||||||||||||
| 193 | 29 | 1; | |||||||||||||||||||||||||||
| 194 | |||||||||||||||||||||||||||||
| 195 | __END__ | ||||||||||||||||||||||||||||
| 196 | |||||||||||||||||||||||||||||
| 197 | =pod | ||||||||||||||||||||||||||||
| 198 | |||||||||||||||||||||||||||||
| 199 | =encoding UTF-8 | ||||||||||||||||||||||||||||
| 200 | |||||||||||||||||||||||||||||
| 201 | =head1 NAME | ||||||||||||||||||||||||||||
| 202 | |||||||||||||||||||||||||||||
| 203 | Mail::BIMI::VMC::Chain - Class to model a VMC Chain | ||||||||||||||||||||||||||||
| 204 | |||||||||||||||||||||||||||||
| 205 | =head1 VERSION | ||||||||||||||||||||||||||||
| 206 | |||||||||||||||||||||||||||||
| 207 | version 3.20260302 | ||||||||||||||||||||||||||||
| 208 | |||||||||||||||||||||||||||||
| 209 | =head1 DESCRIPTION | ||||||||||||||||||||||||||||
| 210 | |||||||||||||||||||||||||||||
| 211 | Class for representing, retrieving, validating, and processing a VMC Certificate Chain | ||||||||||||||||||||||||||||
| 212 | |||||||||||||||||||||||||||||
| 213 | =head1 ATTRIBUTES | ||||||||||||||||||||||||||||
| 214 | |||||||||||||||||||||||||||||
| 215 | These values are derived from lookups and verifications made based upon the input values, it is however possible to override these with other values should you wish to, for example, validate a record before it is published in DNS, or validate an Indicator which is only available locally | ||||||||||||||||||||||||||||
| 216 | |||||||||||||||||||||||||||||
| 217 | =head2 cert_list | ||||||||||||||||||||||||||||
| 218 | |||||||||||||||||||||||||||||
| 219 | is=rw | ||||||||||||||||||||||||||||
| 220 | |||||||||||||||||||||||||||||
| 221 | ArrayRef of individual Certificates in the chain | ||||||||||||||||||||||||||||
| 222 | |||||||||||||||||||||||||||||
| 223 | =head2 cert_object_list | ||||||||||||||||||||||||||||
| 224 | |||||||||||||||||||||||||||||
| 225 | is=rw | ||||||||||||||||||||||||||||
| 226 | |||||||||||||||||||||||||||||
| 227 | ArrayRef of Crypt::OpenSSL::X509 objects for the Certificates in the chain | ||||||||||||||||||||||||||||
| 228 | |||||||||||||||||||||||||||||
| 229 | =head2 errors | ||||||||||||||||||||||||||||
| 230 | |||||||||||||||||||||||||||||
| 231 | is=rw | ||||||||||||||||||||||||||||
| 232 | |||||||||||||||||||||||||||||
| 233 | =head2 is_valid | ||||||||||||||||||||||||||||
| 234 | |||||||||||||||||||||||||||||
| 235 | is=rw | ||||||||||||||||||||||||||||
| 236 | |||||||||||||||||||||||||||||
| 237 | Does the VMC of this chain validate back to root? | ||||||||||||||||||||||||||||
| 238 | |||||||||||||||||||||||||||||
| 239 | =head2 warnings | ||||||||||||||||||||||||||||
| 240 | |||||||||||||||||||||||||||||
| 241 | is=rw | ||||||||||||||||||||||||||||
| 242 | |||||||||||||||||||||||||||||
| 243 | =head1 CONSUMES | ||||||||||||||||||||||||||||
| 244 | |||||||||||||||||||||||||||||
| 245 | =over 4 | ||||||||||||||||||||||||||||
| 246 | |||||||||||||||||||||||||||||
| 247 | =item * L<Mail::BIMI::Role::Data> | ||||||||||||||||||||||||||||
| 248 | |||||||||||||||||||||||||||||
| 249 | =item * L<Mail::BIMI::Role::Data|Mail::BIMI::Role::HasError> | ||||||||||||||||||||||||||||
| 250 | |||||||||||||||||||||||||||||
| 251 | =item * L<Mail::BIMI::Role::HasError> | ||||||||||||||||||||||||||||
| 252 | |||||||||||||||||||||||||||||
| 253 | =back | ||||||||||||||||||||||||||||
| 254 | |||||||||||||||||||||||||||||
| 255 | =head1 EXTENDS | ||||||||||||||||||||||||||||
| 256 | |||||||||||||||||||||||||||||
| 257 | =over 4 | ||||||||||||||||||||||||||||
| 258 | |||||||||||||||||||||||||||||
| 259 | =item * L<Mail::BIMI::Base> | ||||||||||||||||||||||||||||
| 260 | |||||||||||||||||||||||||||||
| 261 | =back | ||||||||||||||||||||||||||||
| 262 | |||||||||||||||||||||||||||||
| 263 | =head1 METHODS | ||||||||||||||||||||||||||||
| 264 | |||||||||||||||||||||||||||||
| 265 | =head2 I<vmc()> | ||||||||||||||||||||||||||||
| 266 | |||||||||||||||||||||||||||||
| 267 | Locate and return the VMC object from this chain. | ||||||||||||||||||||||||||||
| 268 | |||||||||||||||||||||||||||||
| 269 | =head2 I<app_validate()> | ||||||||||||||||||||||||||||
| 270 | |||||||||||||||||||||||||||||
| 271 | Output human readable validation status of this object | ||||||||||||||||||||||||||||
| 272 | |||||||||||||||||||||||||||||
| 273 | =head1 REQUIRES | ||||||||||||||||||||||||||||
| 274 | |||||||||||||||||||||||||||||
| 275 | =over 4 | ||||||||||||||||||||||||||||
| 276 | |||||||||||||||||||||||||||||
| 277 | =item * L<Crypt::OpenSSL::Verify|Crypt::OpenSSL::Verify> | ||||||||||||||||||||||||||||
| 278 | |||||||||||||||||||||||||||||
| 279 | =item * L<Crypt::OpenSSL::X509|Crypt::OpenSSL::X509> | ||||||||||||||||||||||||||||
| 280 | |||||||||||||||||||||||||||||
| 281 | =item * L<File::Slurp|File::Slurp> | ||||||||||||||||||||||||||||
| 282 | |||||||||||||||||||||||||||||
| 283 | =item * L<File::Temp|File::Temp> | ||||||||||||||||||||||||||||
| 284 | |||||||||||||||||||||||||||||
| 285 | =item * L<Mail::BIMI::Prelude|Mail::BIMI::Prelude> | ||||||||||||||||||||||||||||
| 286 | |||||||||||||||||||||||||||||
| 287 | =item * L<Mail::BIMI::VMC::Cert|Mail::BIMI::VMC::Cert> | ||||||||||||||||||||||||||||
| 288 | |||||||||||||||||||||||||||||
| 289 | =item * L<Moose|Moose> | ||||||||||||||||||||||||||||
| 290 | |||||||||||||||||||||||||||||
| 291 | =item * L<Mozilla::CA|Mozilla::CA> | ||||||||||||||||||||||||||||
| 292 | |||||||||||||||||||||||||||||
| 293 | =item * L<Term::ANSIColor|Term::ANSIColor> | ||||||||||||||||||||||||||||
| 294 | |||||||||||||||||||||||||||||
| 295 | =back | ||||||||||||||||||||||||||||
| 296 | |||||||||||||||||||||||||||||
| 297 | =head1 AUTHOR | ||||||||||||||||||||||||||||
| 298 | |||||||||||||||||||||||||||||
| 299 | Marc Bradshaw <marc@marcbradshaw.net> | ||||||||||||||||||||||||||||
| 300 | |||||||||||||||||||||||||||||
| 301 | =head1 COPYRIGHT AND LICENSE | ||||||||||||||||||||||||||||
| 302 | |||||||||||||||||||||||||||||
| 303 | This software is copyright (c) 2020 by Marc Bradshaw. | ||||||||||||||||||||||||||||
| 304 | |||||||||||||||||||||||||||||
| 305 | This is free software; you can redistribute it and/or modify it under | ||||||||||||||||||||||||||||
| 306 | the same terms as the Perl 5 programming language system itself. | ||||||||||||||||||||||||||||
| 307 | |||||||||||||||||||||||||||||
| 308 | =cut | ||||||||||||||||||||||||||||