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.
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.
Três passos para alertas de expiração
Obtenha a CLI ou a URL
Instale a CLI do Pocket Alert ou pegue sua URL de webhook para uma verificação com curl.
Agende a verificação
Adicione uma verificação diária com openssl ou whois que dispara conforme o prazo se aproxima.
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.
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.