Webhooks

Webhook’lar; otomatik koruma, failban ve kural eşleşmesi gibi olayları JSON olarak kendi endpoint’inize iletir. Her yük HMAC-SHA256 ile imzalanır.

Webhook oluşturma

Konsol → WAF → [alan adı] → API Anahtarları sayfasına gidin ve Webhooks bölümünü açın.
Yeni webhook butonuna tıklayın ve formu doldurun:
- Ad — 3–8 alfanümerik karakter
- URL — http:// veya https:// endpoint’iniz (URL içine kullanıcı adı/parola gömülemez)
- Olay tipi — challenge, failban veya rule
- Throttle penceresi — 1 dakika ile 24 saat arası
- (İsteğe bağlı) Basic Auth kullanıcı adı ve parolası
Kaydedin ve Test butonuyla endpoint’inize örnek bir yük gönderin.

Gelen her isteği X-HEIMWALL-Signature başlığı ile doğrulayın: ham istek gövdesinin webhook secret’ınızla HMAC-SHA256 özetini hesaplayın ve başlıktaki hex değerle karşılaştırın. Eşleşiyorsa yük HEIMWALL’dan gelmiştir ve değiştirilmemiştir.

Olay tipleri ve yük formatları

`challenge` — otomatik koruma açıldı/kapandı

Otomatik veya manuel challenge etkinleştiğinde/devre dışı kaldığında tetiklenir:

{
  "auto_challenge": "on",
  "challenge_type": "js",
  "activation": "2026-10-20T14:32:05Z"
}

auto_challenge: on | off
challenge_type: js | captcha
activation: RFC3339 zaman damgası

`failban` — IP engellendi/engel kalktı

Bir IP failban önbelleğine eklendiğinde veya çıkarıldığında tetiklenir:

{
  "is": "add",
  "ip": "203.0.113.42",
  "expire": "2026-10-20T15:02:05Z",
  "adding": "2026-10-20T14:52:05Z"
}

is: add | delete
ip: engellenen IP
expire: engelin biteceği zaman (RFC3339)
adding: engelin konduğu zaman (RFC3339)

`rule` — webhook aksiyonlu kural eşleşti

İçinde webhook aksiyonu olan bir kural eşleştiğinde tetiklenir:

{
  "rule": "admin-koruma",
  "timestamp": "2026-10-20T14:32:05Z",
  "ray": "7f3a9c2e1b4d",
  "ip": "203.0.113.42",
  "host": "example.com",
  "request": "GET /wp-admin HTTP/2",
  "status": 403,
  "bytes": 1024,
  "duration": 12,
  "tls": "TLS 1.3",
  "referer": "",
  "useragent": "Mozilla/5.0 ...",
  "backend": "default",
  "server": "edge-ist-1"
}

Herhangi bir kurala webhook tetiklemesi eklemek için: Konsol → WAF → [alan adı] → Kurallar → Yeni Kural sayfasında koşullarınızı tanımlayın ve aksiyon olarak webhook’u işaretleyin.

Mobil push bildirimleri

HEIMWALL mobil uygulamasını (iOS ve Android) yükleyip hesabınızla giriş yaptığınızda cihazınız otomatik olarak kaydolur ve push bildirimleri almaya başlar — konsolu kontrol etmeden saldırı veya sunucu arızasından haberdar olursunuz.

Kayıtlı cihazlarınızı Ayarlar → Profil → Cihazlar sekmesinden yönetirsiniz: bir cihazı kaldırabilir (push almayı durdurur) veya test bildirimi gönderebilirsiniz.

Push gönderen olaylar:

Origin sağlığı — origin erişilemez oldu / tekrar çevrimiçi
Bakım modu — açıldı / kapandı
Deployment (ZDD) — başladı / başarılı / başarısız / yarım kaldı
Güvenlik — yeni IP engelleme (failban), otomatik koruma devreye girdi / kalktı, koruma modu değişti, bekleme odası aktif, trafik sıçraması
SSL — sertifika süresi doluyor / otomatik yenileme başarısız
Kota — bant genişliği kullanımı %80 uyarısı / tavana ulaşıldı, domain trafik eşiği uyarı ve kesme bildirimleri

Her olay tipi için push bildirimini ayrı ayrı açıp kapatabilirsiniz. E-posta kanalı push’tan bağımsızdır — aynı olaylar için e-posta bildirimini de ayrıca etkinleştirebilirsiniz.