Webhook on client query

[alexdelprete]

Hello,

first of all, let me tell you I simply love AdGuardHome, impressive piece of sw, very reliable and simple to use (one exec and one config file) and with a nice GUI. Congrats to all devs, keep up the great job.

I want to achieve something that seems out-of-scope for a dns server, but maybe AdGuardHome can allow me to do it:

• I have an EZVIZ DB1 doorbell, it's a wireless device, and I'd like to intercept when someone rings pressing the button, to send an event to my Home Assistant. RIght now I'm using a hardware device to do this, but I'd prefer a software solution.
• Unfortunately the doorbell doesn't have an open interface, and even using its cloud API, the push button event is not managed
• Someone noticed that everytime the button is pressed, the doorbell does a specific DNS query:

• the alarm string is always there, only the second part can change based on geography
• I'm looking for a way for AGH to send a callback to HA via webhook everytime it is queried from that specific client for that specific query (containing the string alarm)

So questions are:

• does AGH support webhooks? I'd like to use those for my HA automations
• is this even possible with AGH?
• if it's possible, what's the proper way to do it?

Thanks for any help or advice,

Alessandro

[ameshkov]

AGH does not support webhooks, at least not at this moment. But I think this is indeed possible using the API. You'll need to poll the query log (rather often, every second maybe?) for new records and look for this domain there.

[alexdelprete]

Thanks for the answer. I wanted to avoid polling. I'll wait for webhooks to be available.

[FlorianObermayer]

FWIW:

Here is a home assistant configuration example I use to wake up my NAS on DNS query:

# configuration.yaml
sensor:
  - platform: rest
    name: "Last DNS Query (nas.mydomain.com)"
    resource: "http://<ADGUARD_SERVER_IP>/control/querylog?search=nas.mydomain.com&limit=1"
    authentication: basic
    username: "<USERNAME>"
    password: "<PASSWORD>"
    scan_interval: 5
    value_template: "{{ value_json.oldest }}"
    unique_id: "<UUID>"

# template binary sensor state template

{{ now() - states('sensor.last_dns_query_nas_mydomain_com') | as_datetime(default=0) < timedelta(seconds=11) }}

[davidnewhall]

Hello! I integrate software for a living. Web hooks, pollers, you name it. One of my users asked me to add an AdGuard Home integration. Being unfamiliar with the software, I stuck "AdGuard webhooks" into google and found my way here.

I'd like to point out two things. Forgive my bluntness.

1. Sending web hooks for dns queries is probably very dangerous. It'd be a quick way for an attacker to exploit your system with a denial of service attack. If this feature comes to fruition, please guard it with a rate limit.

2. Webhooks are the future. Everyone wants data now. One of my largest projects focuses on sending notifications to users about events they report to us. It's a million times easier to send a notification about an event when the event generator (in this case AdGuardHome) propagates the event to a handler. This can be as a simple as sending a small packet to a broadcast address, or as complicated as a queueing and aggregation system with a many-to-many architecture. Please consider implementing an event notification system that can direct events to web hooks with the ability to add arbitrary (authentication) headers, like an api key.

In the meantime, we'll try to learn your api and figure out how to integrate with it remotely (since the developers do not run this software).

Cheers.