Self-improving AI Employees for everyone
Python ai-agentsai-employeeai-employeesassistantautonomous-agentsco-employeescompanygrok-botinstinctloop-agentsmuseown-your-datapersonalself-hosted
"""Standard Webhooks (Svix) signature verifier.
Spec: https://www.standardwebhooks.com/
Headers: ``webhook-id``, ``webhook-timestamp``, ``webhook-signature``
Signed payload: ``f"{webhook-id}.{webhook-timestamp}.{raw_body}"``
Algorithm: HMAC-SHA256 of the secret (b64-decoded after the ``whsec_`` prefix
is stripped) over the signed payload, base64-encoded.
``webhook-signature`` may carry multiple space-separated ``v1,<sig>`` entries
to support secret rotation.
A ``webhook-timestamp`` more than five minutes from now is refused, as the
spec requires, so a captured delivery cannot be replayed later.
"""
from __future__ import annotations
import base64
import hashlib
import hmac
import time
from typing import Mapping
from .base import WebhookVerifier
class StandardWebhooksVerifier(WebhookVerifier):
# The spec's replay window, in seconds, either side of the server clock.
tolerance_seconds = 5 * 60
@classmethod
def verify(cls, headers: Mapping[str, str], body: bytes, secret: str) -> None:
msg_id = cls._header(headers, "webhook-id")
timestamp = cls._header(headers, "webhook-timestamp")
sig_header = cls._header(headers, "webhook-signature")
if not (msg_id and timestamp and sig_header):
raise ValueError("Standard Webhooks headers missing")
try:
sent_at = int(timestamp)
except ValueError:
raise ValueError("Standard Webhooks timestamp is not a number") from None
if abs(time.time() - sent_at) > cls.tolerance_seconds:
raise ValueError("Standard Webhooks timestamp is outside the tolerance window")
if secret.startswith("whsec_"):
key = base64.b64decode(secret[len("whsec_") :])
else:
key = secret.encode()
signed = f"{msg_id}.{timestamp}.".encode() + body
expected = base64.b64encode(hmac.new(key, signed, hashlib.sha256).digest()).decode()
candidates: list[str] = []
for part in sig_header.split():
if "," in part:
_, value = part.split(",", 1)
candidates.append(value)
if not any(hmac.compare_digest(expected, c) for c in candidates):
raise ValueError("Standard Webhooks signature mismatch")