Webhook, bir olay gerçekleştiğinde sağlayıcının sizin belirlediğiniz bir adrese HTTP isteği göndermesidir. Sertifika süreçlerinde "yayınlandı", "doğrulama tamamlandı" veya "iptal edildi" gibi olayları sorgulamadan öğrenmenin yoludur.
Webhook mı, sorgulama mı?
- Sorgulama (polling): Basit, ama gecikmeli ve gereksiz istek üretir.
- Webhook: Anlık bildirim, daha az yük; ancak dışarıdan erişilebilir bir uç nokta gerektirir.
Her sağlayıcı webhook sunmaz. Sunmuyorsa düzenli bir zamanlanmış görevle durum sorgulayıp kendi içinizde olay üretmek eşdeğer sonuç verir.
Güvenli bir alıcı uç noktası
- Yalnızca HTTPS üzerinden erişilebilir olsun.
- İstek imzasını (varsa HMAC başlığı) paylaşılan gizli anahtarla doğrulayın.
- Zaman damgasını kontrol edip eski istekleri reddedin (tekrar saldırısına karşı).
- Hızlı yanıt verin (200) ve ağır işi kuyruğa bırakın.
- Aynı olay tekrar gelebilir; işlemi idempotent tasarlayın.
// imza doğrulama mantığı (kavramsal)
beklenen = HMAC_SHA256(gizli_anahtar, ham_govde)
if !sabit_zamanli_karsilastir(beklenen, gelen_imza) { return 401 }Olaydan ne üretilebilir?
- Sertifika yayınlanınca sunucuya otomatik dağıtım tetiklemek
- Ekip kanalına veya e-postaya bildirim göndermek
- Envanter kaydını güncellemek
Webhook'un ulaşmadığı durumlar için mutlaka yedek bir kontrol (günlük durum sorgusu) bulundurun. Sertifikanın canlıda doğru kurulduğunu SSL denetleyici ile teyit edin. Bayi entegrasyonu ve bildirim seçenekleri için iletişim sayfamızdan yazabilirsiniz.
Test etmek
Geliştirme aşamasında yerel uç noktanızı dışarıdan erişilebilir yapan bir tünel aracı kullanabilirsiniz, ancak canlıya geçmeden önce kalıcı bir HTTPS adresi ve imza doğrulaması şarttır. Örnek bir istek gönderip alıcınızın 200 yanıtı verdiğini ve aynı olayı ikinci kez işlemediğini doğrulayın.