New — Iris AI drafts your firewall, routing & rate-limit rules. Explore AI features →
Changelog
Security

Alert webhooks: always signed, retried, in order

Every alert sent to a webhook is signed in the Standard Webhooks format, tried again when your app doesn't take it, and arrives in the order it happened.

Alert webhooks: always signed, retried, in order

An alert rule can tell a webhook, Slack or Discord when it fires and when it's resolved. Until now a webhook alert was signed only when you had set a secret, and if your app missed it, it was gone.

Now every webhook alert is signed, tried again until your app takes it, and kept in order. Above is a webhook channel with the signing secret ngris made for it, and the page that shows that secret once, right after you save.

The page after saving a rule with a new webhook: the signing secret ngris made, shown once, with Copy.
Copy the secret into your app, then you're done.

What changed

  • Always signed. Each webhook channel has a signing secret, a whsec_ key. Leave it empty and ngris makes one and shows it once. Every alert carries the Standard Webhooks headers, so a ready library in your language checks it, and X-Ngris-Signature as before.
  • Checkable behind ngris. If your app runs behind ngris, check the Standard Webhooks headers: they reach it as sent.
  • Tried again. An alert your app doesn't answer with a 2xx is sent again for about 51 minutes, 6 tries, with the same webhook-id so your app can drop a repeat. A 429 answer's Retry-After is honoured.
  • In order. A channel's alerts arrive in the order they happened: a resolved never overtakes its firing. Slack and Discord get the same retries and order.
  • A test that means it. Send test passes only on what a real alert needs: a 2xx answer, no redirect followed.
  • At most a day late. An alert still not delivered 24 hours after it happened is dropped, and the rule's history says why.

Get started

  1. Open Alerts and create a rule, or edit one.
  2. Add a Webhook channel with your app's https:// address. ngris fills in a signing secret: copy it into your app.
  3. Read the docs: Webhook delivery and Webhook signatures.

Read the docs

Ask an AI to summarise this page
Deploy
App hosting Edge functions Domains & certificates
Connect
Secure tunnels API gateway Multi-region edge
Protect
Bot protection & challenge WAF & firewall Edge login
Observe & AI
Monitoring Inspector & replay Iris AI MCP server AI Gateway
Developers
Developer tools Docs ngrok policy converter Blog Changelog
Compare
Ngris vs ngrok Ngris vs Cloudflare Tunnel Ngris vs Vercel Ngris vs Netlify Expose localhost guide
More
Solutions Pricing Enterprise Sign in Get Started Free