{"id":"webhook-security-insurance-hmac","slug":"webhook-security-insurance-hmac-best-practices","title":"Webhook Security for Insurance Integrations: HMAC Signing, Replay Protection, and Why It's Non-Negotiable","excerpt":"Insurance webhooks carry PII. If your CRM's webhooks aren't signed, you're one leaked URL away from a breach. Here's the playbook unLocked uses and what to demand from any vendor.","content":"<p>Webhooks are the most overlooked attack surface in CRM integrations. The URL is public by necessity, the payload often contains PII, and most receivers blindly trust whatever arrives. That's a breach waiting to happen.</p>\n\n<h2>The Three Layers of Protection</h2>\n<h3>1. HMAC-SHA256 Signing</h3>\n<p>Every payload includes a header like <code>X-Signature: t=1714000000,v1=&lt;hex&gt;</code>. Your endpoint computes <code>HMAC-SHA256(timestamp + \".\" + raw_body, shared_secret)</code> and constant-time compares. Forgery requires the secret.</p>\n\n<h3>2. Timestamp Freshness</h3>\n<p>Reject requests where the timestamp is more than 5 minutes old. This blocks replay attacks even if a payload is captured in transit.</p>\n\n<h3>3. Per-Subscription Secrets</h3>\n<p>Each webhook subscription has its own rotatable secret. Rotate immediately if any system that knew the secret is decommissioned.</p>\n\n<h2>What to Demand From Any CRM Vendor</h2>\n<ul>\n<li>Stripe-style HMAC signatures (or equivalent)</li>\n<li>Documented timestamp tolerance and replay protection</li>\n<li>Per-subscription secrets, dashboard-rotatable</li>\n<li>Retry ladder with dead-letter queue and dashboard replay</li>\n<li>Test/inspect tooling so you can verify signatures during development</li>\n</ul>\n\n<h2>The Compliance Angle</h2>\n<p>Under HIPAA and most state insurance privacy regimes, \"reasonable security\" is the standard. Unsigned webhooks carrying PII fail that test in any post-incident review.</p>","category":"Engineering","featureLink":"/mcp-server","cluster":"mcp-api","date":"2026-11-18","lastModified":"2026-11-18","readTime":"6 min","author":"unLocked Team"}