Current File : //scripts/check_domain_tls_service_domains.pl
#!/usr/local/cpanel/3rdparty/bin/perl
# cpanel - scripts/check_domain_tls_service_domains.pl
# Copyright 2022 cPanel, L.L.C.
# All rights reserved.
# copyright@cpanel.net http://cpanel.net
# This code is subject to the cPanel license. Unauthorized copying is prohibited
package scripts::check_domain_tls_service_domains;
=encoding utf-8
=head1 NAME
check_domain_tls_service_domains.pl
=head1 USAGE
check_domain_tls_service_domains.pl --help
check_domain_tls_service_domains.pl [--prune] [--verbose]
=head1 DESCRIPTION
When an SSL certificate is installed for an Apache virtual host, the system
copies that certificate into a separate datastore called “Domain TLS”.
Unlike Apache, Domain TLS indexes SSL certificates by FQDN rather than by
virtual host. cPanel-managed SSL services besides Apache match incoming
TLS SNI requests against Domain TLS and, if a match is found, send the
matched certificate to the client in the TLS handshake.
Because most TLS clients nowadays send an SNI string as part of their inital
TLS handshake, most TLS sessions for these services can use a certificate from
Domain TLS.
Domain TLS doesn’t allow installation of expired certificates; however,
certificates in Domain TLS can expire. We generally don’t remove these because
that would cause users to see domain-mismatch warnings; however, for domains
that are secured by service-default certificates (i.e., that are installed via
WHM), we should remove the corresponding Domain TLS entry when the certificate
is about to expire or is otherwise invalid because the service-default
certificate will still cover the domain.
This script executes that check and enforcement, following this logic:
=over
=item Let C<service_certs> be the collection of service-default TLS certificates.
=item Let C<service_domains> be all domains that are on at least one
C<service_certs> certificate.
=item Let C<dtls_domains> be all domains with Domain TLS entries. (This is not
the same as “all domains on all certificates in Domain TLS”; we only care about
the actual FQDN(s) for which a given Domain TLS certificate was installed.)
=item Let C<match_domains> be all C<dtls_domains> that a C<service_domains>
entry completely covers. This EXCLUDES matches between a wildcard
C<dtls_domains> and a non-wildcard C<service_domains>.
=item For each C<match_domains>, verify that the Domain TLS certificate
has at least 25 hours of validity left; if not, print a message. If the
C<--prune> argument was given, delete the Domain TLS entry, and print a
message about it.
=back
The C<--verbose> flag prints extra diagnostic information that you may find
useful.
=head1 CAVEATS
The drawback to this system is that a Domain TLS entry can be removed even
if only one service’s default certificate covers that domain. For this
reason it is strongly recommended that service default certificates all be
the same certificate.
=cut
use strict;
use warnings;
use Try::Tiny;
use parent 'Cpanel::HelpfulScript';
use Cpanel::Domain::TLS ();
use Cpanel::Domain::TLS::ServiceOverlap ();
use Cpanel::Domain::TLS::Write ();
use Cpanel::SSL::Utils ();
use Cpanel::SSL::Verify ();
#mocked in tests
*_get_service_domains = *Cpanel::Domain::TLS::ServiceOverlap::get_service_domains;
__PACKAGE__->new(@ARGV)->run() if !caller;
use constant _OPTIONS => (
'prune',
'verbose',
);
use constant MIN_VALIDITY_LEFT => 86400 + 3600; #25 hours
sub run {
my ($self) = @_;
my @domains_to_verify = $self->_get_service_domains();
if ( !@domains_to_verify ) {
if ( $self->getopt('verbose') ) {
$self->say_maketext('[asis,Domain TLS] has no domains that are on the service default certificates.');
}
return;
}
if ( $self->getopt('verbose') ) {
$self->say_maketext( 'The system will check the [asis,Domain TLS] [numerate,_1,entry,entries] for the following [numerate,_1,domain,domains]: [join,~, ,_2]', 0 + @domains_to_verify, \@domains_to_verify );
}
my $faulty_count = 0;
my $verify = Cpanel::SSL::Verify->new();
for my $domain (@domains_to_verify) {
my $remove_yn = 0;
try {
my @certs = Cpanel::Domain::TLS->get_certificates($domain);
my $v = $verify->verify(@certs);
if ( $v->ok() ) {
my ( $ok, $parse ) = Cpanel::SSL::Utils::parse_certificate_text( $certs[0] );
die $parse if !$ok;
my $validity_left = 1 + $parse->{'not_after'} - time;
if ( $validity_left < MIN_VALIDITY_LEFT ) {
$remove_yn = 1;
my @to_say = $self->locale()->maketext( '“[_1]”’s certificate is valid, but it will expire soon.', $domain );
if ( $self->getopt('prune') ) {
push @to_say, $self->locale()->maketext('The system will remove the certificate now to ensure that no client receives it after it expires.');
}
else {
push @to_say, $self->bold( $self->locale()->maketext('This certificate should be removed or replaced.') );
}
$self->say( join( ' ', @to_say ) );
}
elsif ( $self->getopt('verbose') ) {
$self->say_maketext( '“[_1]”’s certificate is valid.', $domain );
}
}
else {
$self->say_maketext( '“[_1]”’s certificate failed validation: [_2]', $domain, $v->get_error_string() );
$remove_yn = 1;
}
if ($remove_yn) {
$faulty_count++;
if ( $self->getopt('prune') ) {
Cpanel::Domain::TLS::Write->enqueue_unset_tls($domain);
#Technically this is no longer true; the certificate
#still exists until we reap Domain TLS’s unset queue.
$self->say_maketext( '“[_1]”’s certificate is removed. Non-[asis,HTTP] services will no longer use this certificate.', $domain );
}
}
}
catch {
warn "An error occurred while checking “$domain”’s certificate: $_";
};
}
if ( $faulty_count && !$self->getopt('prune') ) {
$self->say(q<>);
$self->say_maketext( '[quant,_1,domain has a certificate,domains have certificates] that should be removed or replaced. Run the following command to do this:', $faulty_count );
$self->say(q<>);
$self->say( $self->bold("$0 --prune") );
}
return;
}
1;
A peticion de nuestros usuarios, hemos decidido crear estas barras en las que puedes crear facilmente los iconos de tus redes sociales orientadas en la PARTE SUPERIOR de los perfiles,…
Diseño perfil Chaturbate - Es muy importante crear tu perfil de modelo en Chaturbate. Muchos de los usuarios buscan un poco mas de información acerca de ti y todavía mas,…
Eleva tu imagen como modelo con un espacio diseñado para provocar, atraer y convertir miradas en deseo. Un perfil impactante no solo transmite estilo y seguridad, sino que anticipa la…
Sutileza, estilo y presencia. Eleva tu imagen como modelo con un perfil limpio, cuidado y sofisticado. Un diseño armonioso transmite seguridad, profesionalismo y una experiencia más exclusiva para tus seguidores.…
Porque tu contenido merece un buen marco: este diseño realza tu perfil, mejora la navegación y deja claro que eres una modelo que se toma su trabajo en serio. Ver…
Eleva tu imagen como modelo: un perfil bien diseñado transmite seriedad, estilo y una experiencia más cuidada para tus seguidores. Ver Demo Las instrucciones con imagenes estan disponibles en este…
Pensado para atraer, retener y fidelizar: un diseño funcional y sexy que acompaña tu show y refuerza tu presencia en Chaturbate. Ver Demo Las instrucciones con imagenes estan disponibles en…
Haz que tu perfil hable por ti: este diseño destaca tu personalidad y crea una conexión inmediata con quienes entran a conocerte. Ver Demo Las instrucciones con imagenes estan disponibles…
Un perfil que vende sin decirlo: estilo sensual y orden visual que comunica valor, exclusividad y profesionalismo. Ver Demo Las instrucciones con imagenes estan disponibles en este articulo. El codido…
Diseño estratégico para modelos ambiciosas: mejora la primera impresión, organiza tu contenido y potencia la interacción con tus viewers. Ver Demo Las instrucciones con imagenes estan disponibles en este articulo.…
Impacto visual que atrae más miradas: una estética pensada para llamar la atención y hacer que tu perfil no pase desapercibido. Ver Demo Las instrucciones con imagenes estan disponibles en…
Tu espacio, tu identidad: este diseño te ayuda a mostrar quién eres, qué ofreces y por qué vale la pena quedarse en tu sala. Ver Demo Las instrucciones con imagenes…