Skip to main content

Signature verification

Every canonical feed update is an independently signed envelope.

Verification has two layers:

  1. Marking authority signs the feed-key certificate.
  2. The certified feed key signs each canonical update.

Fetch trust material:

curl https://api.marking.fyi/.well-known/marking.json

Then verify:

  • certificate signature;
  • certificate validity window;
  • feed authorization;
  • revocation status;
  • update signature;
  • payload feed ID and freshness.

The canonical payload is deterministic. Consumers should canonicalize the payload exactly before verifying the signature.

Minimal acceptance checklist​

An automated consumer should reject an update if:

  • the envelope signature is invalid;
  • the feed key is not certified by a trusted Marking authority;
  • the feed key is revoked or expired;
  • the certificate is not authorized for that feed;
  • the update is stale for the consumer’s policy;
  • the update breaks signed sequence continuity and cannot be replayed/resynced.