certificate term has validity

(< | > | !=) timespan

Purpose

Warns when the specified website certificate's total term of validity (how long the certificate is valid; the certificate term ending date & time minus the certificate term starting date & time) does not conform to the specified timespan. For remaining certificate term validity, see certificate term has remaining validity requirement.

Notes

This requirement may be repeated in the same section.

A timespan is an expression of a length of time without a specific date. "4 days 2 hours 3 minutes" indicates a timespan of 4 days, 2 hours, and 3 minutes. Only the units with non-zero values need to be listed. A timespan unit is any combination of seconds, minutes, hours, days, weeks, and years. The trailing 's' on each timespan unit is optional. Weeks are defined as the given number of weeks × 7 days. Years are defined as the given number of years × 365 days.

Example configuration

# Warns when the website certificate validity is under 1 year and 1 day.
[certificate:https://illinois.edu]
certificate term has validity > 1 year 1 day

Example output

Line 5: 1 certificate validity is less than 366 days:

Serial Number	Starting	Ending	Hostnames	Validity Length	Remaining Validity
05954D787776425893DBBB28C0A4FAD76236	Fri 2025-07-04 6:05:06 AM	Thu 2025-10-02 6:05:05 AM	2 hostnames: illinois.edu, www.illinois.edu	89 days, 23 hours, 59 minutes, and 59 seconds	50 days, 10 hours, 22 minutes, 24 seconds, and 576 milliseconds