ingest-webhook-secure

Verify HMAC and asymmetric signatures on raw webhook request bodies.

9|3|Updated Jun 13, 2026
One-click install
npx skills add https://github.com/Sir-chawakorn/sanook-cli --skill ingest-webhook-secure
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ingest-webhook-secure
Source: https://github.com/Sir-chawakorn/sanook-cli/tree/main/skills/ingest-webhook-secure
Command: npx skills add https://github.com/Sir-chawakorn/sanook-cli --skill ingest-webhook-secure

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the challenge of securely receiving, verifying, and processing inbound webhooks from external services, preventing common issues like spoofing, replay attacks, and duplicate event processing.

Core Features & Use Cases

  • Cryptographic Verification: Implements constant-time HMAC and asymmetric signature validation for providers like Stripe, GitHub, and Slack.
  • Resilience & Idempotency: Ensures exactly-once processing through atomic deduplication and robust replay protection using timestamp windows.
  • Use Case: When building a system that integrates with multiple third-party APIs, use this Skill to create a single, hardened intake endpoint that reliably handles retries and rejects malicious traffic.

Quick Start

Use the ingest-webhook-secure skill to implement a signature verification handler for a new Stripe webhook endpoint that processes events asynchronously.

Frequently Asked Questions about ingest-webhook-secure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify webhook signatures to prevent spoofing in my backend API?

Webhook replay protection is achieved by enforcing signed-timestamp windows that reject expired requests. This mechanism, combined with idempotent deduplication, ensures maliciously replayed valid payloads are dropped and prevents duplicate event processing during retry storms.

How do I handle webhook retry storms and ensure exactly-once event processing?

Webhook idempotency handles duplicate events from external services by using atomic deduplication to ensure exactly-once processing. When a provider retries a delivery, the endpoint recognizes the duplicate payload and safely ignores it, preventing duplicate side effects.

What's the best way to build a secure webhook receiver for multiple third-party APIs?

Build a single hardened intake endpoint that centralizes cryptographic signature verification, replay protection, and idempotent deduplication. This approach maintains strict security boundaries and reliably handles retries when integrating with multiple third-party APIs simultaneously.

Does this webhook verification approach work for both HMAC and asymmetric signatures?

Yes, constant-time cryptographic validation supports both HMAC and asymmetric signatures over raw request bodies. This covers provider requirements for platforms like Stripe, GitHub, and Slack, ensuring authenticity regardless of the specific signature scheme used.

Why do I need idempotency and replay protection for inbound webhooks?

Idempotency and replay protection are needed to maintain high-reliability integration endpoints. Replay protection uses signed-timestamp windows to reject malicious traffic, while idempotent deduplication ensures duplicate event processing is avoided during external service retry storms.