Web kancalarının ve HMAC imza doğrulamasının test edilmesi

Webhook alıcıları, dışarıdan gelen verilerle işlem yapan halka açık uç noktalardır; bu da imza doğrulamasını, URL'nizi bilen herkesle aranızdaki tek engel haline getirir. Webhook API'si her teslimatı bir HMAC ile imzalar ve inceleyebileceğiniz ve tekrar oynatabileceğiniz bir teslimat günlüğü tutar; böylece doğrulayıcıya güvenmek yerine onu test edebilirsiniz.

Webhook imza testi — request and response sequence Sequence diagram for Webhook signature testing: GET /webhooks/v1/subscriptions answers 200 OK. POST /webhooks/v1/subscriptions answers 201 Created. DELETE /webhooks/v1/subscriptions/{id} answers 401 Unauthorized. POST /webhooks/v1/deliveries/{id}/replay answers 409 Conflict. Your client Fun API Playground GET /webhooks/v1/subscriptions 200 Tamam Webhook aboneliklerinin listesi (gizli bilgiler gizlenmiştir) POST /webhooks/v1/subscriptions 201 Created Webhook aboneliği kaydı oluşturun DELETE /webhooks/v1/subscriptions/{id} 401 Unauthorized Abonelikten çık POST /webhooks/v1/deliveries/{id}/replay 409 Conflict Replay a delivery attempt — re-sends the real HTTP POST (…
Katalogdaki gerçek uç noktalar — yukarıdaki her istek karşılanıyor ve gösterilen her durum kodu, o uç noktanın gerçekten döndürdüğü bir koddur.

Bunu nasıl uygulayabilirsiniz?

  1. Abonelik kaydedin, olay tetikleyin ve gövdeyi işlemeden önce imzayı ortak sırla doğrulayın.
  2. Yükün bir baytını değiştirin ve imza doğrulamasının başarısız olduğunu kontrol edin.
  3. Kaydedilmiş teslimatı tekrar oynatın; alıcının aynı olayı iki kez işlemeyen idempotent davranışını kontrol edin.
  4. İmza karşılaştırmasında sabit süreli bir yöntem kullanıldığını kontrol edin; sıradan dize karşılaştırmaları zamanlama bilgisi sızdırabilir.
  5. Teslimat günlüğünde gerçekten gelen başlıkları inceleyin; varsayımlarınıza güvenmeyin.

Denemek için API'ler

İlgili durum kodları

Diğer teknikler

Başlangıç rehberi · 39 mock REST API’nin tamamı

Son güncelleme