home-assistant.io/source/_integrations/cert_expiry.markdown

title, description, ha_category, ha_release, ha_iot_class, ha_config_flow, ha_codeowners, ha_domain

title	description	ha_category	ha_release	ha_iot_class	ha_config_flow	ha_codeowners	ha_domain
Certificate Expiry	Instructions on how to set up HTTPS (SSL) certificate expiry sensors within Home Assistant.	Network	0.44	Configurable	true	@Cereal2nd @jjlawren	cert_expiry

The cert_expiry integration fetches the certificate from a configured host and displays its expiration in both timestamp and days-to-expiry sensors.

Configuration

There are 2 options in configuring the cert_expiry sensor:

• Via the Home Assistant user interface where it will let you enter a host and port for the certificate to check.
• Via the Home Assistant configuration.yaml file.

# Example configuration.yaml entry
sensor:
  - platform: cert_expiry
    host: home-assistant.io

{% configuration %} host: description: The host FQDN (or IP) to retrieve certificate from. required: true type: string port: description: The port number where the server is running. required: false default: 443 type: integer {% endconfiguration %}

Attributes

The Certificate Expiry entities provide extra attributes to represent the state of the certificate.

Name	Description
is_valid	If the certificate is able to be validated: True / False.
error	A human-readable error description if the certificate is considered invalid, "None" otherwise.