diff --git a/docs/examples.md b/docs/examples.md index ee1de244..450001ff 100644 --- a/docs/examples.md +++ b/docs/examples.md @@ -641,6 +641,32 @@ or by simply providing traccar with a valid username/password combination. mypass ``` +## Flowtriq DDoS detection +[Flowtriq](https://flowtriq.com) is a real-time DDoS detection and mitigation platform. Its Linux agent, ftagent, +supports webhook alerts that can POST directly to an ntfy topic, so you get push notifications on your phone +whenever an attack is detected. + +Configure the webhook URL in your ftagent configuration to point to your ntfy topic: + +```yaml +# /etc/ftagent/ftagent.yml +alerts: + webhooks: + - url: https://ntfy.sh/flowtriq-attacks + method: POST +``` + +You can also use curl to test the integration manually with a sample attack alert: + +```bash +curl \ + -H "Title: DDoS Attack Detected" \ + -H "Priority: urgent" \ + -H "Tags: rotating_light" \ + -d "Attack detected on 203.0.113.5: 14.2 Gbps UDP flood from 3,482 sources" \ + ntfy.sh/flowtriq-attacks +``` + ## Terminal Notifications for Long-Running Commands This example provides a simple way to send notifications using [ntfy.sh](https://ntfy.sh) when a terminal command completes. It includes success or failure indicators based on the command's exit status. diff --git a/docs/integrations.md b/docs/integrations.md index 57e0a85e..c9210a58 100644 --- a/docs/integrations.md +++ b/docs/integrations.md @@ -54,6 +54,7 @@ I've added a ⭐ to projects or posts that have a significant following, or had - [Proxmox-Ntfy](https://github.com/qtsone/proxmox-ntfy) - Python script that monitors Proxmox tasks and sends notifications using the Ntfy service. - [Scrutiny](https://github.com/AnalogJ/scrutiny) - WebUI for smartd S.M.A.R.T monitoring. Scrutiny includes shoutrrr/ntfy integration ([see integration README](https://github.com/AnalogJ/scrutiny?tab=readme-ov-file#notifications)) - [UptimeObserver](https://uptimeobserver.com) - Uptime Monitoring tool for Websites, APIs, SSL Certificates, DNS, Domain Names and Ports. [Integration Guide](https://support.uptimeobserver.com/integrations/ntfy/) +- [Flowtriq](https://flowtriq.com) - Real-time DDoS detection and mitigation platform (integration via [webhook alerts](https://flowtriq.com)) ## [UnifiedPush](https://unifiedpush.org/users/apps/) integrations