Expiração de SSL e domínio

Dias antes de um certificado expira.

Uma verificação diária com openssl e whois sinaliza qualquer certificado ou domínio com menos de N dias restantes. O hostname e a data exata chegam como notificação push no seu celular com 30, 14 e 3 dias de antecedência, com tempo de sobra para renovar.

Verificação diáriaSSL + domínioopenssl · whois · cronAtualizado em
Recursos

Renove antes que expire

Um certificado expirado é uma indisponibilidade causada por você mesmo. Uma verificação diária garante dias de aviso.

SSL e domínios

O openssl cuida do certificado, e o whois cuida do domínio. Um único script diário monitora os dois.

Uma verificação por dia

Uma tarefa cron simples resolve. Sem serviço de monitoramento pago.

Qual certificado, qual data

O hostname e a data exata de expiração aparecem na mensagem, para você saber qual certificado está com o prazo correndo.

Avisos escalonados

Avisos espaçados em 30, 14 e 3 dias. Mesmo se a renovação automática falhar, ainda sobra tempo para corrigir manualmente.

Evite a indisponibilidade

Um certificado expirado gera alertas no navegador e custa a confiança dos usuários. Esta verificação detecta o problema com dias de antecedência.

Funciona em qualquer lugar

Execute pelo cron, pelo systemd ou por uma Action agendada no GitHub.

Primeiros passos

Três passos para alertas de expiração

1

Obtenha a CLI ou a URL

Instale a CLI do Pocket Alert ou pegue sua URL de webhook para uma verificação com curl.

2

Agende a verificação

Adicione uma verificação diária com openssl ou whois que dispara conforme o prazo se aproxima.

3

Renove a tempo

Os avisos chegam com 30, 14 e 3 dias de antecedência. Você renova muito antes de qualquer coisa expirar.

Monitore a expiração de SSL e domínio

1. Instale a CLI e autentique-se

Baixe o binário pocketalert, coloque-o no seu PATH e autentique-se uma vez com sua chave de API.

sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY

2. Certificado SSL (cron diário)

Leia a data de expiração do certificado com openssl, calcule os dias restantes e envie a notificação quando restarem menos de 14.

HOST=example.com
END=$(echo | openssl s_client -connect "${HOST}:443" -servername "$HOST" 2>/dev/null \
  | openssl x509 -noout -enddate | cut -d= -f2)
DAYS=$(( ($(date -d "$END" +%s) - $(date +%s)) / 86400 ))
[ "$DAYS" -lt 14 ] && pocketalert send \
  -t "SSL expiring: $HOST" -m "${DAYS} days left (expires $END)"

3. Expiração do domínio

Leia a data de expiração do registro com whois e encaminhe da mesma forma.

EXP=$(whois example.com | awk -F': ' '/Expir/{print $2; exit}')
pocketalert send -t "Domain expiry: example.com" -m "Registered until $EXP"

4. Agende a verificação

Execute a verificação uma vez por dia pelo cron.

0 8 * * * /usr/local/bin/check-ssl.sh

Não usa a CLI? Troque pocketalert send por um POST com curl para a API de mensagens.

curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"SSL expiring: example.com","message":"13 days left","level":"critical"}'

A documentação cobre o resto.

FAQ

Dúvidas respondidas

Uma verificação diária lê a data de expiração do certificado e faz um POST para o Pocket Alert assim que restarem menos de N dias. Você fica sabendo com tempo de sobra para renovar, e não à meia-noite, quando o certificado já expirou.

Sim. O openssl lê a expiração do certificado e o whois lê a expiração do domínio. Um script curto compara qualquer um dos dois com um limite e avisa você conforme o prazo se aproxima.

Coloque o hostname e a data exata de expiração na mensagem. Assim você sabe qual certificado está expirando e quantos dias restam para renová-lo.

Cron, um timer do systemd ou um agendamento do GitHub Actions funcionam. Qualquer lugar que execute um comando diário e faça uma requisição HTTP serve.

Avise com 30, 14 e 3 dias de antecedência. Se uma renovação automática falhar, essa última janela ainda dá tempo para renovar manualmente antes de o certificado expirar.

Sim, basta definir um nível. Envie o aviso de 30 dias com level=silent para que fique no histórico sem som, e marque os avisos mais urgentes com level=critical: no Android, eles são publicados em um canal que ignora o Não perturbe, e no iPhone aparecem como notificações sensíveis ao tempo que furam o Foco.

Renove antes que o certificado expire.

Uma verificação diária, e você fica sabendo de um certificado ou domínio prestes a expirar com dias de antecedência.