DNS Endpoint Plugin

DNS client plugin allowing for various DNS queries.

Configuration

The following configuration can be set:

SettingTypeDefaultDescription
AddressipDNS server IP; if omitted, default is used
QueryTypestringAQuery type (A, AAAA, CNAME, MX, NS, TXT)
Timeoutduration1sQuery timeout

Example

The following example sets the host.

@DNS {
    Address 8.8.8.8
    QueryType AAAA
}

Outgoing Message “Query”

Outgoing message will send DNS query.

DataTypeDefaultDescription
Hoststring-Host to query
Timeoutduration(configuration)ICMP timeout
QueryTypestring(configuration)Query type (A, AAAA, CNAME, MX, NS, TXT)

Example: Basic

We can send message without any extra paramters.

Query >DNS aaseq.com

Example: Override type

We can override any parameter (other than Host) in the outgoing message.

Query >DNS {
    Host aaseq.com
    QueryType MX
}

Incoming Message “Answer”

Reply will arrive with status of the ping.

DataTypeDescription
StatusstringWill be Success if operation succeeds
AddressipFirst address in answer
AInformation returned
AAAAInformation returned
CNAMEInformation returned
MXInformation returned
NSInformation returned
TXTInformation returned

Example: Basic

Successful response.

Reply <DNS {
    Address "104.21.112.1"
    Status Success
    A TimeToLive=300 {
        Address "104.21.112.1"
    }
    A TimeToLive=300 {
        Address "104.21.80.1"
    }
}

Example: Failure

Timed out response.

Reply <DNS {
    Status  Error
}