Skip to content

Security: JosephDoUrden/webhook-hmac-kit

Security

SECURITY.md

Security Policy

Supported Versions

Version Supported
1.x

Reporting a Vulnerability

If you discover a security vulnerability in webhook-hmac-kit, please report it responsibly.

Do not open a public GitHub issue for security vulnerabilities.

Instead, please send an email to the maintainers or use GitHub's private vulnerability reporting.

What to include

  • Description of the vulnerability
  • Steps to reproduce
  • Potential impact
  • Suggested fix (if any)

Response timeline

  • Acknowledgment: within 48 hours
  • Initial assessment: within 7 days
  • Fix and release: as soon as practical, typically within 14 days for critical issues

Security Design

This library follows these security principles:

  • Constant-time comparison using crypto.timingSafeEqual to prevent timing attacks
  • Timestamp validation to limit the replay window
  • Nonce support for full replay protection (storage is consumer-provided)
  • Zero runtime dependencies to minimize supply chain risk
  • Input validation on security-critical parameters (secret, timestamp, tolerance)

There aren’t any published security advisories