Full Toolkit for Next-Level Domain Analysis
import { UserFacingError } from './user-facing-error';
export type CertsData = {
issuer_ca_id: number;
issuer_name: string;
common_name: string;
name_value: string;
id: number;
entry_timestamp: string;
not_before: string;
not_after: string;
serial_number: string;
}[];
export const lookupCerts = async (domain: string): Promise<CertsData> => {
let response: Response;
try {
response = await fetch(
'https://crt.sh?' +
new URLSearchParams({
Identity: domain,
output: 'json',
}),
);
} catch (error) {
throw new UserFacingError(
{
title: "Couldn't reach crt.sh",
description:
"We couldn't complete the request to crt.sh. Please try again shortly.",
retryable: true,
},
{ cause: error },
);
}
if (!response.ok) {
throw new UserFacingError(
{
title: 'crt.sh is unavailable',
description:
'crt.sh returned an error and may be temporarily down. Please try again shortly.',
retryable: true,
},
{
cause: new Error(
`crt.sh responded with HTTP ${response.status} ${response.statusText}`,
),
},
);
}
const data: CertsData = await response.json();
return data.filter((cert) =>
cert.name_value
.split(/\n/g)
.some((value) => value === domain || value.endsWith(`.${domain}`)),
);
};
export const lookupRelatedCerts = async (domain: string) => {
const requests = [lookupCerts(domain)];
const hasParentDomain = domain.split('.').filter(Boolean).length > 2;
if (hasParentDomain) {
const parentDomain = domain.split('.').slice(1).join('.');
requests.push(lookupCerts(`*.${parentDomain}`));
}
const responses = await Promise.all(requests);
const certs = responses
.flat()
.toSorted(
(a, b) =>
new Date(b.entry_timestamp).getTime() -
new Date(a.entry_timestamp).getTime(),
);
return certs;
};