Home

Awesome

✨ Falco Plugin - DNS Collector ✨

This project is a falco plugin for the DNS Collector project (https://github.com/dmachard/go-dnscollector).

Supported Fields

Here is the current set of supported fields:

NAMETYPEARGDESCRIPTION
dnscollector.network.familystringNoneIP protocol version INET or INET6.
dnscollector.network.protocolstringNoneProtocol UDP, TCP.
dnscollector.network.query-ipstringNoneDNS query IP address.
dnscollector.network.query-portstringNoneDNS query port.
dnscollector.network.response-ipstringNoneDNS response IP address.
dnscollector.network.response-portstringNoneDNS response port.
dnscollector.network.ip-defragmentedstringNoneIP-Fragmented.
dnscollector.network.tcp-reassembledstringNoneTCP-Reassembled.
dnscollector.dns.lengthuint64NoneLength of the query or response.
dnscollector.dns.opcodeuint64NoneDNS operation code (integer).
dnscollector.dns.rcodestringNoneDNS return code.
dnscollector.dns.qnamestringNoneDNS query name.
dnscollector.dns.qtypestringNoneDNS query type.
dnscollector.dns.flags.qrstringNoneDNS query type value q/r.
dnscollector.dns.flags.tcstringNoneDNS truncated response flag.
dnscollector.dns.flags.aastringNoneDNS authoritive response flag.
dnscollector.dns.flags.rastringNoneDNS recursion available flag.
dnscollector.dns.flags.adstringNoneDNS authenticated data flag.
dnscollector.dns.malformed-packetstringNoneMalformed dns packet, integer value 1/0.
dnscollector.dns.repeateduint64NoneDNS query repeated.
dnscollector.edns.udp-sizeuint64NoneEDNS UDP size.
dnscollector.edns.rcode.uint64NoneEDNS request code.
dnscollector.edns.version.uint64NoneEDNS version.
dnscollector.edns.dnssec-ok.uint64NoneEDNS DNSSEC_OK.
dnscollector.edns.options.stringNoneEDNS options.
dnscollector.dnstap.operationstringNoneDNStap pperation.
dnscollector.dnstap.identitystringNoneDNStap identity.
dnscollector.dnstap.versionstringNoneDNStap version.
dnscollector.dnstap.latencystringNoneComputed latency between queries and replies.
dnscollector.suspicious.scorestringNoneDNS calcualted suspicious score.
dnscollector.suspicious.malformed-pktstringNoneDNS suspicious malformed packet detected.
dnscollector.suspicious.large-pktstringNoneDNS suspicious large packet detected.
dnscollector.suspicious.long-domainstringNoneDNS suspicious long domain detected.
dnscollector.suspicious.slow-domainstringNoneDNS suspicious long domain detected.
dnscollector.suspicious.unallowed-charsstringNoneDNS suspicious unallowed characters detected.
dnscollector.suspicious.uncommon-qtypesstringNoneDNS suspicious uncommon query type detected.
dnscollector.suspicious.excessive-number-labelsstringNoneDNS suspicious excessive number of labels detected.

Configuration

falco.yaml Example

plugins:
  - name: dnscollector
    library_path: libdnscollector.so
    open_params: "http://:8888/events"
load_plugins: [dnscollector]