Skip to content

Security: Jazzmoon/websub

.github/SECURITY.md

Security Policy

This library verifies HMAC signatures on webhook style content distribution requests and accepts subscription requests over HTTP. Bugs in either area can mean a malicious party forging notifications or hijacking a subscription. Please report those privately.

Reporting a vulnerability

Do not open a public GitHub issue for security reports.

Use GitHub Security Advisories to report privately. Please include:

  • Which module and version is affected (core, adapter/*, storage/*)
  • Whether it affects the Subscriber, Publisher, or Hub role
  • A minimal reproduction if possible
  • The impact as you understand it, for example "a hub without X validates a forged signature" or "a subscriber accepts unsigned content when a secret was configured"

Scope

In scope:

  • Signature verification bypass (signature.go)
  • Subscription request forgery or hijacking: any party other than the legitimate subscriber or hub able to subscribe, unsubscribe, or receive another party's content
  • Denial of service through malformed discovery responses, oversized payloads, or hub delivery retry storms
  • Any storage backend issue that could leak subscription secrets

Generally out of scope:

  • Issues requiring an already compromised HTTP client or a TLS misconfiguration on the consumer's own infrastructure
  • Best practice suggestions without a concrete exploitable impact. Open a normal issue or discussion for those.

Response

We will acknowledge reports within a few days and aim to have a fix or a mitigation plan before any public disclosure. Credit is given in the release notes unless you would prefer otherwise.

There aren't any published security advisories