karawaci.kode

2026-11-30 · 6 min

Monitoring Expiry Sertifikat SSL: Cegah Kedaluwarsa Saat Libur

Insiden paling memalukan yang pernah saya tangani tidak rumit. Tidak ada bug, tidak ada lonjakan trafik. Sebuah sertifikat habis masa berlakunya pada malam libur Natal, dan orang yang tahu cara memperbaikinya sedang di pesawat. Penyebabnya satu: tidak ada monitoring expiry sertifikat ssl yang benar-benar dipantau orang.

Insiden seperti itu sepenuhnya bisa dicegah. Itu sebabnya saya menutup November dengan topik ini. Hari ini Cyber Monday, tutup bulan sedang berjalan, dan libur Natal serta tahun baru tinggal beberapa minggu lagi. Ini waktu yang tepat untuk satu sore audit.

Tulisan ini membahas sertifikat, domain, dan credential pihak ketiga, semuanya dalam bentuk alert berbasis kode. Untuk menjaga alert tetap layak dipercaya, baca juga soal alert fatigue dan tuning Alertmanager dan synthetic monitoring dengan Playwright.

Kenapa Risikonya Naik: Masa Berlaku Sertifikat TLS 2026

Dua hal berubah.

Pertama, masa berlaku sertifikat makin pendek. Keputusan CA/Browser Forum memangkas masa berlaku maksimum sertifikat TLS publik secara bertahap. Untuk masa berlaku sertifikat tls 2026, batasnya sudah turun dari 398 hari menjadi 200 hari untuk sertifikat yang diterbitkan sejak Maret 2026, lalu dijadwalkan turun lagi bertahap hingga 47 hari. Angka dan tanggal pastinya sebaiknya Anda cek langsung di Baseline Requirements di cabforum.org, karena jadwal bisa berubah. Dampaknya jelas: pembaruan makin sering, dan otomatisasi bukan lagi pilihan.

Kedua, Let’s Encrypt sudah menghentikan email pengingat kedaluwarsa. Dulu email itu jadi jaring pengaman yang diam-diam menyelamatkan banyak tim. Sekarang jaring itu tidak ada.

Otomatisasi pembaruan juga bisa gagal diam-diam. Token DNS challenge dicabut. Ingress berubah. Rate limit tercapai. Pembaruan gagal, tidak ada yang tahu, dan tanggal expiry jalan terus. Karena itu yang perlu dipantau bukan hanya pembaruannya, tapi juga tanggal akhir yang dilihat pengguna.

Alert 1: Blackbox Exporter SSL Expiry

Metrik utamanya adalah probe_ssl_earliest_cert_expiry. Ini timestamp expiry sertifikat paling awal dalam rantai yang disajikan server. Pantauan dari luar ini paling jujur, karena yang diukur adalah apa yang benar-benar dilihat klien.

Berikut konfigurasi blackbox exporter ssl expiry yang saya pakai sebagai titik awal.

# blackbox.yml
modules:
  http_2xx:
    prober: http
    timeout: 10s
    http:
      preferred_ip_protocol: ip4
# prometheus.yml (potongan)
scrape_configs:
  - job_name: blackbox-tls
    metrics_path: /probe
    params:
      module: [http_2xx]
    static_configs:
      - targets:
          - https://tokoanda.example
          - https://api.tokoanda.example
          - https://checkout.tokoanda.example
    relabel_configs:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__
        replacement: blackbox-exporter:9115

Lalu aturan alert-nya.

groups:
  - name: tls-expiry
    rules:
      - alert: SertifikatTLSHampirKedaluwarsa
        expr: (probe_ssl_earliest_cert_expiry - time()) / 86400 < 21
        for: 1h
        labels:
          severity: warning
        annotations:
          summary: 'Sertifikat {{ $labels.instance }} habis dalam {{ $value | printf "%.0f" }} hari'
      - alert: SertifikatTLSKritis
        expr: (probe_ssl_earliest_cert_expiry - time()) / 86400 < 7
        for: 10m
        labels:
          severity: critical
        annotations:
          summary: "Sertifikat {{ $labels.instance }} habis kurang dari 7 hari"

Ambang 21 hari bukan angka ajaib. Saya memilihnya agar ada waktu menyelesaikan masalah sebelum libur, bukan saat libur. Untuk periode akhir tahun, saya menaikkan ambang warning sementara, sampai sekitar 35 hari. Dengan begitu pembaruan yang macet terlihat sebelum tim bubar. Caveat penting: ambang harus selalu di bawah masa berlaku sertifikat dan jendela pembaruan otomatisnya. Saat masa berlaku menyusut menuju 47 hari, ambang 35 hari akan menyala terus-menerus, jadi sesuaikan lagi setelah libur.

Satu hal lagi: alert saat probe gagal total. Kalau probe_success == 0 selama beberapa menit, itu juga sinyal, dan sering lebih cepat dari alert expiry.

Alert 2: Cert-Manager Monitoring

Kalau Anda di Kubernetes, cert-manager monitoring melengkapi pantauan dari luar. Dua metrik yang saya andalkan:

  • certmanager_certificate_expiration_timestamp_seconds: kapan sertifikat dalam objek Certificate habis.
  • certmanager_certificate_ready_status: apakah Certificate berstatus siap.

Berikut blok lengkapnya, boleh digabung ke grup tls-expiry di atas atau disimpan sebagai file rule sendiri.

groups:
  - name: cert-manager-expiry
    rules:
      - alert: CertManagerCertificateHampirHabis
        expr: (certmanager_certificate_expiration_timestamp_seconds - time()) / 86400 < 14
        for: 30m
        labels:
          severity: warning
        annotations:
          summary: "Certificate {{ $labels.namespace }}/{{ $labels.name }} habis < 14 hari"
      - alert: CertManagerCertificateTidakSiap
        expr: certmanager_certificate_ready_status{condition="False"} == 1
        for: 15m
        labels:
          severity: critical
        annotations:
          summary: "Certificate {{ $labels.namespace }}/{{ $labels.name }} tidak siap"

Kenapa dua sumber? Karena keduanya bisa berbohong dengan cara berbeda. Metrik cert-manager bisa sehat sementara ingress masih menyajikan sertifikat lama. Probe dari luar bisa hijau sementara pembaruan sudah macet, dan hanya sisa waktu yang menipis. Gabungkan keduanya.

Nama metrik bisa berubah antarversi. Cek endpoint /metrics cert-manager Anda sebelum menyalin rule di atas.

Alert 3: Cek Expired Domain via RDAP

Sertifikat sehat tidak menolong kalau domainnya lepas. Untuk cek expired domain rdap, protokol ini mengembalikan JSON, jadi gampang diolah skrip.

#!/usr/bin/env bash
# cek-domain.sh <domain>
domain="$1"
curl -sL "https://rdap.org/domain/${domain}" \
  | jq -r '.events[] | select(.eventAction=="expiration") | .eventDate'

Lalu ubah jadi metrik lewat textfile collector di node_exporter.

#!/usr/bin/env bash
out=/var/lib/node_exporter/textfile/domain_expiry.prom
: > "$out.tmp"
for d in tokoanda.example tokoanda.co.id; do
  tgl=$(curl -sL "https://rdap.org/domain/${d}" \
    | jq -r '.events[] | select(.eventAction=="expiration") | .eventDate')
  [ -z "$tgl" ] && continue
  ts=$(date -d "$tgl" +%s)
  echo "domain_expiry_timestamp_seconds{domain=\"$d\"} $ts" >> "$out.tmp"
done
mv "$out.tmp" "$out"

Catatan: date -d hanya ada di GNU date (Linux). Di macOS pakai gdate -d dari coreutils, atau date -j -f "%Y-%m-%dT%H:%M:%SZ" "$tgl" +%s.

Perhatikan baris [ -z "$tgl" ] && continue. Tidak semua TLD punya layanan RDAP yang lengkap, dan tidak semua registrar mengisi field expiration. Uji tiap domain Anda satu per satu. Untuk domain yang tidak terjawab, catat tanggalnya manual dari panel registrar ke inventaris, jangan dibiarkan kosong.

Jangan lupa auto-renew. Cek juga kartu pembayaran yang terpasang di registrar. Kartu kedaluwarsa adalah penyebab domain lepas yang klasik.

Alert 4: Inventaris API Key dan Credential

Ini bagian yang paling sering terlewat, karena tidak ada exporter siap pakai. Token pihak ketiga yang kedaluwarsa menghentikan pembayaran, email transaksional, atau webhook, dan tampaknya seperti bug aplikasi.

Solusi saya sederhana: satu file inventaris di repositori, tanpa menyimpan nilai rahasianya.

# inventaris-expiry.yml
- nama: Token API payment gateway
  pemilik: tim-pembayaran
  kedaluwarsa: 2026-12-28
  cara_rotasi: runbook/rotasi-payment.md
- nama: Kunci SMTP transaksional
  pemilik: tim-platform
  kedaluwarsa: 2027-01-10
  cara_rotasi: runbook/rotasi-smtp.md

Satu job CI harian membaca file ini dan gagal bila ada entri yang habis dalam 30 hari. Atau, ubah isinya jadi metrik yang sama bentuknya dengan domain_expiry_timestamp_seconds, supaya semua alert expiry hidup di satu tempat.

Setiap entri wajib punya pemilik dan runbook. Alert tanpa pemilik cuma akan jadi kebisingan.

Checklist Pra-Libur: Satu Sore

Blok waktu tiga sampai empat jam. Urutannya:

  1. Daftar semua hostname publik dan masukkan ke target blackbox. Termasuk subdomain checkout, API, dan webhook.
  2. Jalankan alert expiry dan pastikan tidak ada yang menyala diam-diam. Perpanjang yang jatuh tempo sebelum pertengahan Januari.
  3. Uji rute alert. Kirim satu alert tes ke kanal on-call dan pastikan orangnya benar-benar menerima.
  4. Cek certmanager_certificate_ready_status untuk semua Certificate. Selidiki yang tidak siap.
  5. Jalankan skrip RDAP untuk semua domain. Pastikan auto-renew aktif dan kartu pembayaran masih berlaku.
  6. Perbarui inventaris credential. Rotasi apa pun yang habis sebelum pertengahan Januari, jangan menunggu.
  7. Tulis jadwal on-call libur dan siapa yang punya akses registrar, DNS, dan CA.
  8. Simulasikan satu kegagalan. Matikan satu pembaruan di staging dan lihat apakah alert-nya muncul.

Saya mengerjakannya sendiri setiap akhir November, dan hasilnya selalu sama: setidaknya satu hal ditemukan. Bukan masalah besar hari ini, tapi di tengah libur Natal bisa jadi masalah besar.

Pencegahan ini murah. Beberapa puluh baris YAML dan satu sore. Biaya kegagalannya jauh lebih mahal, dan waktunya hampir selalu jatuh di hari libur.

Ditulis oleh Reza Pradipta